ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/cv/mgflib/parser.h
Revision: 1.28
Committed: Wed Nov 29 19:55:42 1995 UTC (28 years, 5 months ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 1.27: +11 -3 lines
Log Message:
made some of xf.c's internal (static) routines global

File Contents

# User Rev Content
1 greg 1.21 /* Copyright (c) 1995 Regents of the University of California */
2 greg 1.1
3     /* SCCSid "$SunId$ LBL" */
4    
5     /*
6     * Header file for MGF interpreter
7     */
8    
9     /* must include stdio.h before us */
10    
11 greg 1.25 #define MG_VMAJOR 1 /* major version number */
12 greg 1.28 #define MG_VMINOR 1 /* minor version number */
13 greg 1.25
14     /* Entities (list is only appended, never modified) */
15 greg 1.21 #define MG_E_COMMENT 0 /* # */
16     #define MG_E_COLOR 1 /* c */
17     #define MG_E_CCT 2 /* cct */
18     #define MG_E_CONE 3 /* cone */
19     #define MG_E_CMIX 4 /* cmix */
20     #define MG_E_CSPEC 5 /* cspec */
21     #define MG_E_CXY 6 /* cxy */
22     #define MG_E_CYL 7 /* cyl */
23     #define MG_E_ED 8 /* ed */
24     #define MG_E_FACE 9 /* f */
25     #define MG_E_INCLUDE 10 /* i */
26     #define MG_E_IES 11 /* ies */
27     #define MG_E_IR 12 /* ir */
28     #define MG_E_MATERIAL 13 /* m */
29     #define MG_E_NORMAL 14 /* n */
30     #define MG_E_OBJECT 15 /* o */
31     #define MG_E_POINT 16 /* p */
32     #define MG_E_PRISM 17 /* prism */
33     #define MG_E_RD 18 /* rd */
34     #define MG_E_RING 19 /* ring */
35     #define MG_E_RS 20 /* rs */
36     #define MG_E_SIDES 21 /* sides */
37     #define MG_E_SPH 22 /* sph */
38     #define MG_E_TD 23 /* td */
39     #define MG_E_TORUS 24 /* torus */
40     #define MG_E_TS 25 /* ts */
41     #define MG_E_VERTEX 26 /* v */
42     #define MG_E_XF 27 /* xf */
43 greg 1.25 /* end of Version 1 entities */
44 greg 1.1
45 greg 1.21 #define MG_NENTITIES 28 /* total # entities */
46 greg 1.1
47 greg 1.25 #define MG_NELIST {28} /* entity count for version 1 and up */
48    
49 greg 1.18 #define MG_NAMELIST {"#","c","cct","cone","cmix","cspec","cxy","cyl","ed",\
50 greg 1.20 "f","i","ies","ir","m","n","o","p","prism","rd",\
51     "ring","rs","sides","sph","td","torus","ts","v","xf"}
52 greg 1.1
53     #define MG_MAXELEN 6
54    
55     extern char mg_ename[MG_NENTITIES][MG_MAXELEN];
56    
57 greg 1.24 /* Handler routines for each entity and unknown ones */
58 greg 1.1 #ifdef NOPROTO
59     extern int (*mg_ehand[MG_NENTITIES])();
60 greg 1.24 extern int (*mg_uhand)();
61     extern int mg_defuhand();
62 greg 1.1 #else
63     extern int (*mg_ehand[MG_NENTITIES])(int argc, char **argv);
64 greg 1.24 extern int (*mg_uhand)(int argc, char **argv);
65     extern int mg_defuhand(int, char **);
66 greg 1.1 #endif
67    
68 greg 1.24 extern unsigned mg_nunknown; /* count of unknown entities */
69    
70 greg 1.1 /* Error codes */
71     #define MG_OK 0 /* normal return value */
72     #define MG_EUNK 1 /* unknown entity */
73     #define MG_EARGC 2 /* wrong number of arguments */
74     #define MG_ETYPE 3 /* argument type error */
75     #define MG_EILL 4 /* illegal argument value */
76     #define MG_EUNDEF 5 /* undefined reference */
77     #define MG_ENOFILE 6 /* cannot open input file */
78     #define MG_EINCL 7 /* error in included file */
79     #define MG_EMEM 8 /* out of memory */
80     #define MG_ESEEK 9 /* file seek error */
81 greg 1.2 #define MG_EBADMAT 10 /* bad material specification */
82 greg 1.26 #define MG_ELINE 11 /* input line too long */
83 greg 1.27 #define MG_ECNTXT 12 /* unmatched context close */
84 greg 1.1
85 greg 1.27 #define MG_NERRS 13
86 greg 1.1
87 greg 1.24 extern char *mg_err[MG_NERRS]; /* list of error messages */
88 greg 1.1
89     /*
90     * The general process for running the parser is to fill in the mg_ehand
91     * array with handlers for each entity you know how to handle.
92     * Then, call mg_init to fill in the rest. This function will report
93     * an error and quit if you try to support an inconsistent set of entities.
94     * For each file you want to parse, call mg_load with the file name.
95     * To read from standard input, use NULL as the file name.
96     * For additional control over error reporting and file management,
97     * use mg_open, mg_read, mg_parse and mg_close instead of mg_load.
98 greg 1.10 * To pass an entity of your own construction to the parser, use
99     * the mg_handle function rather than the mg_ehand routines directly.
100     * (The first argument to mg_handle is the entity #, or -1.)
101 greg 1.1 * To free any data structures and clear the parser, use mg_clear.
102 greg 1.15 * If there is an error, mg_load, mg_open, mg_parse, mg_handle and
103 greg 1.21 * mg_fgoto will return an error from the list above. In addition,
104 greg 1.15 * mg_load will report the error to stderr. The mg_read routine
105     * returns 0 when the end of file has been reached.
106 greg 1.1 */
107    
108 greg 1.17 #define MG_MAXLINE 4096 /* maximum input line length */
109 greg 1.1 #define MG_MAXARGC (MG_MAXLINE/4) /* maximum argument count */
110    
111     typedef struct mg_fctxt {
112 greg 1.7 char fname[96]; /* file name */
113 greg 1.1 FILE *fp; /* stream pointer */
114 greg 1.10 int fid; /* unique file context id */
115 greg 1.1 char inpline[MG_MAXLINE]; /* input line */
116     int lineno; /* line number */
117     struct mg_fctxt *prev; /* previous context */
118     } MG_FCTXT;
119    
120 greg 1.10 typedef struct {
121     int fid; /* file this position is for */
122     int lineno; /* line number in file */
123     long offset; /* offset from beginning */
124     } MG_FPOS;
125    
126 greg 1.1 extern MG_FCTXT *mg_file; /* current file context */
127    
128     #ifdef NOPROTO
129     extern void mg_init(); /* fill in mg_ehand array */
130     extern int mg_load(); /* parse a file */
131     extern int mg_open(); /* open new input file */
132     extern int mg_read(); /* read next line */
133     extern int mg_parse(); /* parse current line */
134 greg 1.10 extern void mg_fgetpos(); /* get position on input file */
135     extern int mg_fgoto(); /* go to position on input file */
136 greg 1.1 extern void mg_close(); /* close input file */
137     extern void mg_clear(); /* clear parser */
138 greg 1.10 extern int mg_handle(); /* handle an entity */
139 greg 1.1 #else
140     extern void mg_init(void); /* fill in mg_ehand array */
141     extern int mg_load(char *); /* parse a file */
142     extern int mg_open(MG_FCTXT *, char *); /* open new input file */
143     extern int mg_read(void); /* read next line */
144     extern int mg_parse(void); /* parse current line */
145 greg 1.10 extern void mg_fgetpos(MG_FPOS *); /* get position on input file */
146     extern int mg_fgoto(MG_FPOS *); /* go to position on input file */
147 greg 1.1 extern void mg_close(void); /* close input file */
148     extern void mg_clear(void); /* clear parser */
149 greg 1.10 extern int mg_handle(int, int, char **); /* handle an entity */
150 greg 1.1 #endif
151    
152     #ifndef MG_NQCD
153     #define MG_NQCD 5 /* default number of divisions */
154     #endif
155    
156     extern int mg_nqcdivs; /* divisions per quarter circle */
157    
158     /*
159     * The following library routines are included for your convenience:
160     */
161    
162     #ifdef NOPROTO
163     extern int mg_entity(); /* get entity number from its name */
164     extern int isint(); /* non-zero if integer format */
165     extern int isflt(); /* non-zero if floating point format */
166 greg 1.22 extern int isname(); /* non-zero if legal identifier name */
167 greg 1.1 #else
168     extern int mg_entity(char *); /* get entity number from its name */
169     extern int isint(char *); /* non-zero if integer format */
170     extern int isflt(char *); /* non-zero if floating point format */
171 greg 1.22 extern int isname(char *); /* non-zero if legal identifier name */
172 greg 1.1 #endif
173    
174     /************************************************************************
175     * Definitions for 3-d vector manipulation functions
176     */
177    
178 greg 1.3 #ifdef SMLFLT
179     #define FLOAT float
180     #define FTINY (1e-3)
181 greg 1.2 #else
182 greg 1.3 #define FLOAT double
183     #define FTINY (1e-6)
184 greg 1.2 #endif
185 greg 1.3 #define FHUGE (1e10)
186 greg 1.1
187 greg 1.2 typedef FLOAT FVECT[3];
188    
189 greg 1.3 #define VCOPY(v1,v2) ((v1)[0]=(v2)[0],(v1)[1]=(v2)[1],(v1)[2]=(v2)[2])
190     #define DOT(v1,v2) ((v1)[0]*(v2)[0]+(v1)[1]*(v2)[1]+(v1)[2]*(v2)[2])
191     #define VSUM(vr,v1,v2,f) ((vr)[0]=(v1)[0]+(f)*(v2)[0], \
192     (vr)[1]=(v1)[1]+(f)*(v2)[1], \
193     (vr)[2]=(v1)[2]+(f)*(v2)[2])
194    
195 greg 1.6 #define is0vect(v) (DOT(v,v) <= FTINY*FTINY)
196 greg 1.3
197     #define round0(x) if (x <= FTINY && x >= -FTINY) x = 0
198    
199 greg 1.1 #ifdef NOPROTO
200     extern double normalize(); /* normalize a vector */
201     #else
202     extern double normalize(FVECT); /* normalize a vector */
203     #endif
204    
205     /************************************************************************
206     * Definitions for context handling routines
207     * (materials, colors, vectors)
208     */
209    
210 greg 1.6 #define C_CMINWL 380 /* minimum wavelength */
211 greg 1.5 #define C_CMAXWL 780 /* maximum wavelength */
212     #define C_CNSS 41 /* number of spectral samples */
213 greg 1.6 #define C_CWLI ((C_CMAXWL-C_CMINWL)/(C_CNSS-1))
214 greg 1.5 #define C_CMAXV 10000 /* nominal maximum sample value */
215 greg 1.16 #define C_CLPWM (683./C_CMAXV) /* peak lumens/watt multiplier */
216 greg 1.5
217 greg 1.6 #define C_CSSPEC 01 /* flag if spectrum is set */
218     #define C_CDSPEC 02 /* flag if defined w/ spectrum */
219     #define C_CSXY 04 /* flag if xy is set */
220     #define C_CDXY 010 /* flag if defined w/ xy */
221 greg 1.16 #define C_CSEFF 020 /* flag if efficacy set */
222 greg 1.5
223 greg 1.1 typedef struct {
224 greg 1.8 int clock; /* incremented each change */
225 greg 1.19 short flags; /* what's been set */
226     short ssamp[C_CNSS]; /* spectral samples, min wl to max */
227     long ssum; /* straight sum of spectral values */
228 greg 1.6 float cx, cy; /* xy chromaticity value */
229 greg 1.16 float eff; /* efficacy (lumens/watt) */
230 greg 1.5 } C_COLOR;
231    
232 greg 1.16 #define C_DEFCOLOR { 1, C_CDXY|C_CSXY|C_CSSPEC|C_CSEFF,\
233 greg 1.5 {C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
234     C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
235     C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
236     C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
237     C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
238     C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,\
239     C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV,C_CMAXV},\
240 greg 1.16 (long)C_CNSS*C_CMAXV, 1./3., 1./3., 178.006 }
241 greg 1.5
242 greg 1.15 #define c_cval(c,l) ((double)(c)->ssamp[((l)-C_MINWL)/C_CWLI] / (c)->ssum)
243 greg 1.5
244 greg 1.20 #define C_1SIDEDTHICK 0.005 /* assumed thickness of 1-sided mat. */
245    
246 greg 1.5 typedef struct {
247 greg 1.2 int clock; /* incremented each change -- resettable */
248 greg 1.13 int sided; /* 1 if surface is 1-sided, 0 for 2-sided */
249 greg 1.20 float nr, ni; /* index of refraction, real and imaginary */
250 greg 1.2 float rd; /* diffuse reflectance */
251 greg 1.1 C_COLOR rd_c; /* diffuse reflectance color */
252 greg 1.2 float td; /* diffuse transmittance */
253 greg 1.1 C_COLOR td_c; /* diffuse transmittance color */
254 greg 1.2 float ed; /* diffuse emittance */
255 greg 1.1 C_COLOR ed_c; /* diffuse emittance color */
256 greg 1.2 float rs; /* specular reflectance */
257 greg 1.1 C_COLOR rs_c; /* specular reflectance color */
258 greg 1.2 float rs_a; /* specular reflectance roughness */
259     float ts; /* specular transmittance */
260 greg 1.1 C_COLOR ts_c; /* specular transmittance color */
261 greg 1.2 float ts_a; /* specular transmittance roughness */
262 greg 1.1 } C_MATERIAL; /* material context */
263    
264     typedef struct {
265 greg 1.8 int clock; /* incremented each change -- resettable */
266 greg 1.1 FVECT p, n; /* point and normal */
267     } C_VERTEX; /* vertex context */
268 greg 1.3
269 greg 1.20 #define C_DEFMATERIAL {1,0,1.,0.,0.,C_DEFCOLOR,0.,C_DEFCOLOR,0.,C_DEFCOLOR,\
270 greg 1.2 0.,C_DEFCOLOR,0.,0.,C_DEFCOLOR,0.}
271 greg 1.12 #define C_DEFVERTEX {1,{0.,0.,0.},{0.,0.,0.}}
272 greg 1.1
273     extern C_COLOR *c_ccolor; /* the current color */
274 greg 1.12 extern char *c_ccname; /* current color name */
275 greg 1.1 extern C_MATERIAL *c_cmaterial; /* the current material */
276 greg 1.12 extern char *c_cmname; /* current material name */
277 greg 1.1 extern C_VERTEX *c_cvertex; /* the current vertex */
278 greg 1.12 extern char *c_cvname; /* current vertex name */
279 greg 1.1
280     #ifdef NOPROTO
281     extern int c_hcolor(); /* handle color entity */
282     extern int c_hmaterial(); /* handle material entity */
283     extern int c_hvertex(); /* handle vertex entity */
284     extern void c_clearall(); /* clear context tables */
285 greg 1.11 extern C_MATERIAL *c_getmaterial(); /* get a named material */
286 greg 1.1 extern C_VERTEX *c_getvert(); /* get a named vertex */
287 greg 1.7 extern C_COLOR *c_getcolor(); /* get a named color */
288 greg 1.6 extern void c_ccvt(); /* fix color representation */
289     extern int c_isgrey(); /* check if color is grey */
290 greg 1.1 #else
291     extern int c_hcolor(int, char **); /* handle color entity */
292     extern int c_hmaterial(int, char **); /* handle material entity */
293     extern int c_hvertex(int, char **); /* handle vertex entity */
294     extern void c_clearall(void); /* clear context tables */
295 greg 1.11 extern C_MATERIAL *c_getmaterial(char *); /* get a named material */
296 greg 1.1 extern C_VERTEX *c_getvert(char *); /* get a named vertex */
297 greg 1.7 extern C_COLOR *c_getcolor(char *); /* get a named color */
298 greg 1.6 extern void c_ccvt(C_COLOR *, int); /* fix color representation */
299     extern int c_isgrey(C_COLOR *); /* check if color is grey */
300 greg 1.1 #endif
301    
302     /*************************************************************************
303     * Definitions for hierarchical object name handler
304     */
305    
306     extern int obj_nnames; /* depth of name hierarchy */
307     extern char **obj_name; /* names in hierarchy */
308    
309     #ifdef NOPROTO
310     extern int obj_handler(); /* handle an object entity */
311 greg 1.2 extern void obj_clear(); /* clear object stack */
312 greg 1.1 #else
313     extern int obj_handler(int, char **); /* handle an object entity */
314 greg 1.2 extern void obj_clear(void); /* clear object stack */
315 greg 1.1 #endif
316    
317     /**************************************************************************
318     * Definitions for hierarchical transformation handler
319     */
320    
321 greg 1.2 typedef FLOAT MAT4[4][4];
322 greg 1.1
323     #ifdef BSD
324     #define copymat4(m4a,m4b) bcopy((char *)m4b,(char *)m4a,sizeof(MAT4))
325     #else
326     #define copymat4(m4a,m4b) (void)memcpy((char *)m4a,(char *)m4b,sizeof(MAT4))
327     #endif
328    
329     #define MAT4IDENT { {1.,0.,0.,0.}, {0.,1.,0.,0.}, \
330     {0.,0.,1.,0.}, {0.,0.,0.,1.} }
331    
332     extern MAT4 m4ident;
333    
334     #define setident4(m4) copymat4(m4, m4ident)
335    
336     /* regular transformation */
337     typedef struct {
338 greg 1.14 MAT4 xfm; /* transform matrix */
339     FLOAT sca; /* scalefactor */
340 greg 1.1 } XF;
341    
342     #define identxf(xp) (void)(setident4((xp)->xfm),(xp)->sca=1.0)
343    
344 greg 1.10 #define XF_MAXDIM 8 /* maximum array dimensions */
345    
346     struct xf_array {
347     MG_FPOS spos; /* starting position on input */
348     int ndim; /* number of array dimensions */
349     struct {
350     short i, n; /* current count and maximum */
351     char arg[8]; /* string argument value */
352     } aarg[XF_MAXDIM];
353     };
354    
355 greg 1.1 typedef struct xf_spec {
356 greg 1.10 long xid; /* unique transform id */
357 greg 1.23 short xac; /* context argument count */
358 greg 1.14 short rev; /* boolean true if vertices reversed */
359 greg 1.10 XF xf; /* cumulative transformation */
360     struct xf_array *xarr; /* transformation array pointer */
361     struct xf_spec *prev; /* previous transformation context */
362     } XF_SPEC; /* followed by argument buffer */
363 greg 1.1
364 greg 1.23 extern XF_SPEC *xf_context; /* current transform context */
365     extern char **xf_argend; /* last transform argument */
366    
367 greg 1.28 #define xf_ac(xf) ((xf)==NULL ? 0 : (xf)->xac)
368 greg 1.23 #define xf_av(xf) (xf_argend - (xf)->xac)
369    
370 greg 1.28 #define xf_argc xf_ac(xf_context)
371 greg 1.23 #define xf_argv xf_av(xf_context)
372 greg 1.1
373     /*
374     * The transformation handler should do most of the work that needs
375     * doing. Just pass it any xf entities, then use the associated
376     * functions to transform and translate points, transform vectors
377     * (without translation), rotate vectors (without scaling) and scale
378     * values appropriately.
379     *
380     * The routines xf_xfmpoint, xf_xfmvect and xf_rotvect take two
381     * 3-D vectors (which may be identical), transforms the second and
382     * puts the result into the first.
383     */
384    
385     #ifdef NOPROTO
386    
387     extern int xf_handler(); /* handle xf entity */
388     extern void xf_xfmpoint(); /* transform point */
389     extern void xf_xfmvect(); /* transform vector */
390     extern void xf_rotvect(); /* rotate vector */
391     extern double xf_scale(); /* scale a value */
392 greg 1.2 extern void xf_clear(); /* clear xf stack */
393 greg 1.1
394     /* The following are support routines you probably won't call directly */
395    
396 greg 1.28 XF_SPEC *new_xf(); /* allocate new transform */
397     void free_xf(); /* free a transform */
398     int xf_aname(); /* name this instance */
399     long comp_xfid(); /* compute unique ID */
400 greg 1.1 extern void multmat4(); /* m4a = m4b X m4c */
401     extern void multv3(); /* v3a = v3b X m4 (vectors) */
402     extern void multp3(); /* p3a = p3b X m4 (points) */
403     extern int xf(); /* interpret transform spec. */
404    
405     #else
406    
407 greg 1.2 extern int xf_handler(int, char **); /* handle xf entity */
408     extern void xf_xfmpoint(FVECT, FVECT); /* transform point */
409     extern void xf_xfmvect(FVECT, FVECT); /* transform vector */
410     extern void xf_rotvect(FVECT, FVECT); /* rotate vector */
411     extern double xf_scale(double); /* scale a value */
412     extern void xf_clear(void); /* clear xf stack */
413 greg 1.1
414     /* The following are support routines you probably won't call directly */
415    
416 greg 1.28 XF_SPEC *new_xf(int, char **); /* allocate new transform */
417     void free_xf(XF_SPEC *); /* free a transform */
418     int xf_aname(struct xf_array *); /* name this instance */
419     long comp_xfid(MAT4); /* compute unique ID */
420 greg 1.1 extern void multmat4(MAT4, MAT4, MAT4); /* m4a = m4b X m4c */
421     extern void multv3(FVECT, FVECT, MAT4); /* v3a = v3b X m4 (vectors) */
422     extern void multp3(FVECT, FVECT, MAT4); /* p3a = p3b X m4 (points) */
423 greg 1.6 extern int xf(XF *, int, char **); /* interpret transform spec. */
424 greg 1.1
425     #endif
426    
427     /************************************************************************
428     * Miscellaneous definitions
429     */
430    
431     #ifdef M_PI
432     #define PI M_PI
433     #else
434     #define PI 3.14159265358979323846
435     #endif
436    
437     #ifdef DCL_ATOF
438     extern double atof();
439     #endif
440    
441     #ifndef MEM_PTR
442     #define MEM_PTR void *
443     #endif
444    
445     extern MEM_PTR malloc();
446     extern MEM_PTR calloc();
447     extern MEM_PTR realloc();
448 greg 1.4 extern void free();