ViewVC Help
View File | Revision Log | Show Annotations | Download File | Root Listing
root/radiance/ray/src/cv/mgflib/parser.h
Revision: 1.39
Committed: Fri Jan 14 05:46:12 2011 UTC (13 years, 4 months ago) by greg
Content type: text/plain
Branch: MAIN
Changes since 1.38: +7 -11 lines
Log Message:
Eliminated unnecessary MEM_PTR

File Contents

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