ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/cv/mgflib/parser.h
Revision: 1.8
Committed: Sat Jun 25 11:55:42 1994 UTC (29 years, 10 months ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 1.7: +9 -5 lines
Log Message:
added name and clock members to C_COLOR and C_VERTEX structures

File Contents

# Content
1 /* Copyright (c) 1994 Regents of the University of California */
2
3 /* SCCSid "$SunId$ LBL" */
4
5 /*
6 * Header file for MGF interpreter
7 */
8
9 /* must include stdio.h before us */
10
11 /* Entities (order doesn't really matter) */
12 #define MG_E_COMMENT 0
13 #define MG_E_COLOR 1
14 #define MG_E_CONE 2
15 #define MG_E_CMIX 3
16 #define MG_E_CSPEC 4
17 #define MG_E_CXY 5
18 #define MG_E_CYL 6
19 #define MG_E_ED 7
20 #define MG_E_FACE 8
21 #define MG_E_INCLUDE 9
22 #define MG_E_IES 10
23 #define MG_E_MATERIAL 11
24 #define MG_E_NORMAL 12
25 #define MG_E_OBJECT 13
26 #define MG_E_POINT 14
27 #define MG_E_PRISM 15
28 #define MG_E_RD 16
29 #define MG_E_RING 17
30 #define MG_E_RS 18
31 #define MG_E_SPH 19
32 #define MG_E_TD 20
33 #define MG_E_TORUS 21
34 #define MG_E_TS 22
35 #define MG_E_VERTEX 23
36 #define MG_E_XF 24
37
38 #define MG_NENTITIES 25
39
40 #define MG_NAMELIST {"#","c","cone","cmix","cspec","cxy","cyl","ed","f",\
41 "i","ies","m","n","o","p","prism","rd","ring","rs",\
42 "sph","td","torus","ts","v","xf"}
43
44 #define MG_MAXELEN 6
45
46 extern char mg_ename[MG_NENTITIES][MG_MAXELEN];
47
48 /* Handler routines for each entity */
49
50 #ifdef NOPROTO
51 extern int (*mg_ehand[MG_NENTITIES])();
52 #else
53 extern int (*mg_ehand[MG_NENTITIES])(int argc, char **argv);
54 #endif
55
56 /* Error codes */
57 #define MG_OK 0 /* normal return value */
58 #define MG_EUNK 1 /* unknown entity */
59 #define MG_EARGC 2 /* wrong number of arguments */
60 #define MG_ETYPE 3 /* argument type error */
61 #define MG_EILL 4 /* illegal argument value */
62 #define MG_EUNDEF 5 /* undefined reference */
63 #define MG_ENOFILE 6 /* cannot open input file */
64 #define MG_EINCL 7 /* error in included file */
65 #define MG_EMEM 8 /* out of memory */
66 #define MG_ESEEK 9 /* file seek error */
67 #define MG_EBADMAT 10 /* bad material specification */
68
69 #define MG_NERRS 11
70
71 extern char *mg_err[MG_NERRS];
72
73 /*
74 * The general process for running the parser is to fill in the mg_ehand
75 * array with handlers for each entity you know how to handle.
76 * Then, call mg_init to fill in the rest. This function will report
77 * an error and quit if you try to support an inconsistent set of entities.
78 * For each file you want to parse, call mg_load with the file name.
79 * To read from standard input, use NULL as the file name.
80 * For additional control over error reporting and file management,
81 * use mg_open, mg_read, mg_parse and mg_close instead of mg_load.
82 * To free any data structures and clear the parser, use mg_clear.
83 * If there is an error, mg_load, mg_open, mg_parse, and mg_rewind
84 * will return an error from the list above. In addition, mg_load
85 * will report the error to stderr. The mg_read routine returns 0
86 * when the end of file has been reached.
87 */
88
89 #define MG_MAXLINE 512 /* maximum input line length */
90 #define MG_MAXARGC (MG_MAXLINE/4) /* maximum argument count */
91
92 typedef struct mg_fctxt {
93 char fname[96]; /* file name */
94 FILE *fp; /* stream pointer */
95 char inpline[MG_MAXLINE]; /* input line */
96 int lineno; /* line number */
97 struct mg_fctxt *prev; /* previous context */
98 } MG_FCTXT;
99
100 extern MG_FCTXT *mg_file; /* current file context */
101
102 #ifdef NOPROTO
103 extern void mg_init(); /* fill in mg_ehand array */
104 extern int mg_load(); /* parse a file */
105 extern int mg_open(); /* open new input file */
106 extern int mg_read(); /* read next line */
107 extern int mg_parse(); /* parse current line */
108 extern int mg_rewind(); /* rewind input file */
109 extern void mg_close(); /* close input file */
110 extern void mg_clear(); /* clear parser */
111 extern int mg_iterate();
112 #else
113 extern void mg_init(void); /* fill in mg_ehand array */
114 extern int mg_load(char *); /* parse a file */
115 extern int mg_open(MG_FCTXT *, char *); /* open new input file */
116 extern int mg_read(void); /* read next line */
117 extern int mg_parse(void); /* parse current line */
118 extern int mg_rewind(void); /* rewind input file */
119 extern void mg_close(void); /* close input file */
120 extern void mg_clear(void); /* clear parser */
121 extern int mg_iterate(int, char **, int (*)(void));
122 #endif
123
124 #ifndef MG_NQCD
125 #define MG_NQCD 5 /* default number of divisions */
126 #endif
127
128 extern int mg_nqcdivs; /* divisions per quarter circle */
129
130 /*
131 * The following library routines are included for your convenience:
132 */
133
134 #ifdef NOPROTO
135 extern int mg_entity(); /* get entity number from its name */
136 extern int isint(); /* non-zero if integer format */
137 extern int isflt(); /* non-zero if floating point format */
138 #else
139 extern int mg_entity(char *); /* get entity number from its name */
140 extern int isint(char *); /* non-zero if integer format */
141 extern int isflt(char *); /* non-zero if floating point format */
142 #endif
143
144 /************************************************************************
145 * Definitions for 3-d vector manipulation functions
146 */
147
148 #ifdef SMLFLT
149 #define FLOAT float
150 #define FTINY (1e-3)
151 #else
152 #define FLOAT double
153 #define FTINY (1e-6)
154 #endif
155 #define FHUGE (1e10)
156
157 typedef FLOAT FVECT[3];
158
159 #define VCOPY(v1,v2) ((v1)[0]=(v2)[0],(v1)[1]=(v2)[1],(v1)[2]=(v2)[2])
160 #define DOT(v1,v2) ((v1)[0]*(v2)[0]+(v1)[1]*(v2)[1]+(v1)[2]*(v2)[2])
161 #define VSUM(vr,v1,v2,f) ((vr)[0]=(v1)[0]+(f)*(v2)[0], \
162 (vr)[1]=(v1)[1]+(f)*(v2)[1], \
163 (vr)[2]=(v1)[2]+(f)*(v2)[2])
164
165 #define is0vect(v) (DOT(v,v) <= FTINY*FTINY)
166
167 #define round0(x) if (x <= FTINY && x >= -FTINY) x = 0
168
169 #ifdef NOPROTO
170 extern double normalize(); /* normalize a vector */
171 #else
172 extern double normalize(FVECT); /* normalize a vector */
173 #endif
174
175 /************************************************************************
176 * Definitions for context handling routines
177 * (materials, colors, vectors)
178 */
179
180 #define C_CMINWL 380 /* minimum wavelength */
181 #define C_CMAXWL 780 /* maximum wavelength */
182 #define C_CNSS 41 /* number of spectral samples */
183 #define C_CWLI ((C_CMAXWL-C_CMINWL)/(C_CNSS-1))
184 #define C_CMAXV 10000 /* nominal maximum sample value */
185
186 #define C_CSSPEC 01 /* flag if spectrum is set */
187 #define C_CDSPEC 02 /* flag if defined w/ spectrum */
188 #define C_CSXY 04 /* flag if xy is set */
189 #define C_CDXY 010 /* flag if defined w/ xy */
190
191 typedef struct {
192 char *name; /* material name */
193 int clock; /* incremented each change */
194 short flags; /* what's been set */
195 short ssamp[C_CNSS]; /* spectral samples, min wl to max */
196 long ssum; /* straight sum of spectral values */
197 float cx, cy; /* xy chromaticity value */
198 } C_COLOR;
199
200 #define C_DEFCOLOR { NULL, 1, C_CDXY|C_CSXY|C_CSSPEC,\
201 {C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
202 C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
203 C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
204 C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
205 C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
206 C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
207 C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV},\
208 (long)C_CNSS*C_CMAXV, 1./3., 1./3. }
209
210 #define C_CIEX { "_cie_x", 1, C_CDSPEC|C_CSSPEC|C_CSXY,\
211 {14,42,143,435,1344,2839,3483,3362,2908,1954,956,\
212 320,49,93,633,1655,2904,4334,5945,7621,9163,10263,\
213 10622,10026,8544,6424,4479,2835,1649,874,468,227,\
214 114,58,29,14,7,3,2,1,0}, 106836L, .735, .265 }
215
216 #define C_CIEY { "_cie_y", 1, C_CDSPEC|C_CSSPEC|C_CSXY,\
217 {0,1,4,12,40,116,230,380,600,910,1390,2080,3230,\
218 5030,7100,8620,9540,9950,9950,9520,8700,7570,6310,\
219 5030,3810,2650,1750,1070,610,320,170,82,41,21,10,\
220 5,2,1,1,0,0}, 106856L, .274, .717 }
221
222 #define C_CIEZ { "_cie_z", 1, C_CDSPEC|C_CSSPEC|C_CSXY,\
223 {65,201,679,2074,6456,13856,17471,17721,16692,\
224 12876,8130,4652,2720,1582,782,422,203,87,39,21,17,\
225 11,8,3,2,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0},\
226 106770L, .167, .009 }
227
228 #define c_cval(c,l) ((double)(c)->ssamp[((l)-C_MINWL)/C_CWLI] / (c)->sum)
229
230 typedef struct {
231 char *name; /* material name */
232 int clock; /* incremented each change -- resettable */
233 float rd; /* diffuse reflectance */
234 C_COLOR rd_c; /* diffuse reflectance color */
235 float td; /* diffuse transmittance */
236 C_COLOR td_c; /* diffuse transmittance color */
237 float ed; /* diffuse emittance */
238 C_COLOR ed_c; /* diffuse emittance color */
239 float rs; /* specular reflectance */
240 C_COLOR rs_c; /* specular reflectance color */
241 float rs_a; /* specular reflectance roughness */
242 float ts; /* specular transmittance */
243 C_COLOR ts_c; /* specular transmittance color */
244 float ts_a; /* specular transmittance roughness */
245 } C_MATERIAL; /* material context */
246
247 typedef struct {
248 char *name; /* vector name */
249 int clock; /* incremented each change -- resettable */
250 FVECT p, n; /* point and normal */
251 } C_VERTEX; /* vertex context */
252
253 #define C_DEFMATERIAL {NULL,1,0.,C_DEFCOLOR,0.,C_DEFCOLOR,0.,C_DEFCOLOR,\
254 0.,C_DEFCOLOR,0.,0.,C_DEFCOLOR,0.}
255 #define C_DEFVERTEX {NULL,1,{0.,0.,0.},{0.,0.,0.}}
256
257 extern C_COLOR *c_ccolor; /* the current color */
258 extern C_MATERIAL *c_cmaterial; /* the current material */
259 extern C_VERTEX *c_cvertex; /* the current vertex */
260
261 #ifdef NOPROTO
262 extern int c_hcolor(); /* handle color entity */
263 extern int c_hmaterial(); /* handle material entity */
264 extern int c_hvertex(); /* handle vertex entity */
265 extern void c_clearall(); /* clear context tables */
266 extern C_VERTEX *c_getvert(); /* get a named vertex */
267 extern C_COLOR *c_getcolor(); /* get a named color */
268 extern void c_ccvt(); /* fix color representation */
269 extern int c_isgrey(); /* check if color is grey */
270 #else
271 extern int c_hcolor(int, char **); /* handle color entity */
272 extern int c_hmaterial(int, char **); /* handle material entity */
273 extern int c_hvertex(int, char **); /* handle vertex entity */
274 extern void c_clearall(void); /* clear context tables */
275 extern C_VERTEX *c_getvert(char *); /* get a named vertex */
276 extern C_COLOR *c_getcolor(char *); /* get a named color */
277 extern void c_ccvt(C_COLOR *, int); /* fix color representation */
278 extern int c_isgrey(C_COLOR *); /* check if color is grey */
279 #endif
280
281 /*************************************************************************
282 * Definitions for hierarchical object name handler
283 */
284
285 extern int obj_nnames; /* depth of name hierarchy */
286 extern char **obj_name; /* names in hierarchy */
287
288 #ifdef NOPROTO
289 extern int obj_handler(); /* handle an object entity */
290 extern void obj_clear(); /* clear object stack */
291 #else
292 extern int obj_handler(int, char **); /* handle an object entity */
293 extern void obj_clear(void); /* clear object stack */
294 #endif
295
296 /**************************************************************************
297 * Definitions for hierarchical transformation handler
298 */
299
300 typedef FLOAT MAT4[4][4];
301
302 #ifdef BSD
303 #define copymat4(m4a,m4b) bcopy((char *)m4b,(char *)m4a,sizeof(MAT4))
304 #else
305 #define copymat4(m4a,m4b) (void)memcpy((char *)m4a,(char *)m4b,sizeof(MAT4))
306 #endif
307
308 #define MAT4IDENT { {1.,0.,0.,0.}, {0.,1.,0.,0.}, \
309 {0.,0.,1.,0.}, {0.,0.,0.,1.} }
310
311 extern MAT4 m4ident;
312
313 #define setident4(m4) copymat4(m4, m4ident)
314
315 /* regular transformation */
316 typedef struct {
317 MAT4 xfm; /* transform matrix */
318 FLOAT sca; /* scalefactor */
319 } XF;
320
321 #define identxf(xp) (void)(setident4((xp)->xfm),(xp)->sca=1.0)
322
323 typedef struct xf_spec {
324 short xac; /* transform argument count */
325 short xav0; /* zeroeth argument in xf_argv array */
326 XF xf; /* cumulative transformation */
327 struct xf_spec *prev; /* previous transformation context */
328 } XF_SPEC;
329
330 extern int xf_argc; /* total # transform args. */
331 extern char **xf_argv; /* transform arguments */
332 extern XF_SPEC *xf_context; /* current context */
333
334 /*
335 * The transformation handler should do most of the work that needs
336 * doing. Just pass it any xf entities, then use the associated
337 * functions to transform and translate points, transform vectors
338 * (without translation), rotate vectors (without scaling) and scale
339 * values appropriately.
340 *
341 * The routines xf_xfmpoint, xf_xfmvect and xf_rotvect take two
342 * 3-D vectors (which may be identical), transforms the second and
343 * puts the result into the first.
344 */
345
346 #ifdef NOPROTO
347
348 extern int xf_handler(); /* handle xf entity */
349 extern void xf_xfmpoint(); /* transform point */
350 extern void xf_xfmvect(); /* transform vector */
351 extern void xf_rotvect(); /* rotate vector */
352 extern double xf_scale(); /* scale a value */
353 extern void xf_clear(); /* clear xf stack */
354
355 /* The following are support routines you probably won't call directly */
356
357 extern void multmat4(); /* m4a = m4b X m4c */
358 extern void multv3(); /* v3a = v3b X m4 (vectors) */
359 extern void multp3(); /* p3a = p3b X m4 (points) */
360 extern int xf(); /* interpret transform spec. */
361
362 #else
363
364 extern int xf_handler(int, char **); /* handle xf entity */
365 extern void xf_xfmpoint(FVECT, FVECT); /* transform point */
366 extern void xf_xfmvect(FVECT, FVECT); /* transform vector */
367 extern void xf_rotvect(FVECT, FVECT); /* rotate vector */
368 extern double xf_scale(double); /* scale a value */
369 extern void xf_clear(void); /* clear xf stack */
370
371 /* The following are support routines you probably won't call directly */
372
373 extern void multmat4(MAT4, MAT4, MAT4); /* m4a = m4b X m4c */
374 extern void multv3(FVECT, FVECT, MAT4); /* v3a = v3b X m4 (vectors) */
375 extern void multp3(FVECT, FVECT, MAT4); /* p3a = p3b X m4 (points) */
376 extern int xf(XF *, int, char **); /* interpret transform spec. */
377
378 #endif
379
380 /************************************************************************
381 * Miscellaneous definitions
382 */
383
384 #ifdef M_PI
385 #define PI M_PI
386 #else
387 #define PI 3.14159265358979323846
388 #endif
389
390 #ifdef DCL_ATOF
391 extern double atof();
392 #endif
393
394 #ifndef MEM_PTR
395 #define MEM_PTR void *
396 #endif
397
398 extern MEM_PTR malloc();
399 extern MEM_PTR calloc();
400 extern MEM_PTR realloc();
401 extern void free();