cv/mgflib/parser.h

/* RCSid: $Id: parser.h,v 1.39 2011/01/14 05:46:12 greg Exp $ */
/*
 * Header file for MGF interpreter
 */
#ifndef _MGF_PARSER_H_
#define _MGF_PARSER_H_

/* must include stdio.h and stdlib.h before us */

#include "ccolor.h"

#ifdef __cplusplus
extern "C" {
#endif

#define MG_VMAJOR       2               /* major version number */
#define MG_VMINOR       0               /* minor version number */

                        /* Entities (list is only appended, never modified) */
#define MG_E_COMMENT    0               /* #            */
#define MG_E_COLOR      1               /* c            */
#define MG_E_CCT        2               /* cct          */
#define MG_E_CONE       3               /* cone         */
#define MG_E_CMIX       4               /* cmix         */
#define MG_E_CSPEC      5               /* cspec        */
#define MG_E_CXY        6               /* cxy          */
#define MG_E_CYL        7               /* cyl          */
#define MG_E_ED         8               /* ed           */
#define MG_E_FACE       9               /* f            */
#define MG_E_INCLUDE    10              /* i            */
#define MG_E_IES        11              /* ies          */
#define MG_E_IR         12              /* ir           */
#define MG_E_MATERIAL   13              /* m            */
#define MG_E_NORMAL     14              /* n            */
#define MG_E_OBJECT     15              /* o            */
#define MG_E_POINT      16              /* p            */
#define MG_E_PRISM      17              /* prism        */
#define MG_E_RD         18              /* rd           */
#define MG_E_RING       19              /* ring         */
#define MG_E_RS         20              /* rs           */
#define MG_E_SIDES      21              /* sides        */
#define MG_E_SPH        22              /* sph          */
#define MG_E_TD         23              /* td           */
#define MG_E_TORUS      24              /* torus        */
#define MG_E_TS         25              /* ts           */
#define MG_E_VERTEX     26              /* v            */
#define MG_E_XF         27              /* xf           */
                        /* end of Version 1 entities */
#define MG_E_FACEH      28              /* fh           */
                        /* end of Version 2 entities */

#define MG_NENTITIES    29              /* total # entities */

#define MG_NELIST       {28,29}         /* entity count for version 1 and up */

#define MG_NAMELIST     {"#","c","cct","cone","cmix","cspec","cxy","cyl","ed",\
                        "f","i","ies","ir","m","n","o","p","prism","rd",\
                        "ring","rs","sides","sph","td","torus","ts","v","xf",\
                        "fh"}

#define MG_MAXELEN      6

extern char     mg_ename[MG_NENTITIES][MG_MAXELEN];

                        /* Handler routines for each entity and unknown ones */
extern int      (*mg_ehand[MG_NENTITIES])(int argc, char **argv);
extern int      (*mg_uhand)(int argc, char **argv);
extern int      mg_defuhand(int, char **);

extern unsigned mg_nunknown;            /* count of unknown entities */

                        /* Error codes */
#define MG_OK           0               /* normal return value */
#define MG_EUNK         1               /* unknown entity */
#define MG_EARGC        2               /* wrong number of arguments */
#define MG_ETYPE        3               /* argument type error */
#define MG_EILL         4               /* illegal argument value */
#define MG_EUNDEF       5               /* undefined reference */
#define MG_ENOFILE      6               /* cannot open input file */
#define MG_EINCL        7               /* error in included file */
#define MG_EMEM         8               /* out of memory */
#define MG_ESEEK        9               /* file seek error */
#define MG_EBADMAT      10              /* bad material specification */
#define MG_ELINE        11              /* input line too long */
#define MG_ECNTXT       12              /* unmatched context close */

#define MG_NERRS        13

extern char     *mg_err[MG_NERRS];      /* list of error messages */

/*
 * The general process for running the parser is to fill in the mg_ehand
 * array with handlers for each entity you know how to handle.
 * Then, call mg_init to fill in the rest.  This function will report
 * an error and quit if you try to support an inconsistent set of entities.
 * For each file you want to parse, call mg_load with the file name.
 * To read from standard input, use NULL as the file name.
 * For additional control over error reporting and file management,
 * use mg_open, mg_read, mg_parse and mg_close instead of mg_load.
 * To pass an entity of your own construction to the parser, use
 * the mg_handle function rather than the mg_ehand routines directly.
 * (The first argument to mg_handle is the entity #, or -1.)
 * To free any data structures and clear the parser, use mg_clear.
 * If there is an error, mg_load, mg_open, mg_parse, mg_handle and
 * mg_fgoto will return an error from the list above.  In addition,
 * mg_load will report the error to stderr.  The mg_read routine
 * returns 0 when the end of file has been reached.
 */

#define MG_MAXLINE      4096            /* maximum input line length */
#define MG_MAXARGC      (MG_MAXLINE/4)  /* maximum argument count */

typedef struct mg_fctxt {
        char    fname[96];                      /* file name */
        FILE    *fp;                            /* stream pointer */
        int     fid;                            /* unique file context id */
        char    inpline[MG_MAXLINE];            /* input line */
        int     lineno;                         /* line number */
        struct mg_fctxt *prev;                  /* previous context */
} MG_FCTXT;

typedef struct {
        int     fid;                            /* file this position is for */
        int     lineno;                         /* line number in file */
        long    offset;                         /* offset from beginning */
} MG_FPOS;

extern MG_FCTXT *mg_file;               /* current file context */

extern void     mg_init(void);          /* fill in mg_ehand array */
extern int      mg_load(char *);        /* parse a file */
extern int      mg_open(MG_FCTXT *, char *);    /* open new input file */
extern int      mg_read(void);          /* read next line */
extern int      mg_parse(void);         /* parse current line */
extern void     mg_fgetpos(MG_FPOS *);  /* get position on input file */
extern int      mg_fgoto(MG_FPOS *);    /* go to position on input file */
extern void     mg_close(void);         /* close input file */
extern void     mg_clear(void);         /* clear parser */
extern int      mg_handle(int, int, char **);   /* handle an entity */

#ifndef MG_NQCD
#define MG_NQCD         5               /* default number of divisions */
#endif

extern int      mg_nqcdivs;             /* divisions per quarter circle */

/*
 * The following library routines are included for your convenience:
 */

extern int mg_entity(char *);           /* get entity number from its name */
extern int isint(char *);               /* non-zero if integer format */
extern int isintd(char *, char *);      /* same with delimiter set */
extern int isflt(char *);               /* non-zero if floating point format */
extern int isfltd(char *, char *);      /* same with delimiter set */
extern int isname(char *);              /* non-zero if legal identifier name */
extern int badarg(int, char **, char *);/* check argument format */
extern int e_include(int, char **);     /* expand include entity */
extern int e_pipe(int, char **);        /* expand piped command */
extern int e_sph(int, char **);         /* expand sphere as other entities */
extern int e_torus(int, char **);       /* expand torus as other entities */
extern int e_cyl(int, char **);         /* expand cylinder as other entities */
extern int e_ring(int, char **);        /* expand ring as other entities */
extern int e_cone(int, char **);        /* expand cone as other entities */
extern int e_prism(int, char **);       /* expand prism as other entities */
extern int e_faceh(int, char **);       /* expand face w/ holes as face */

/************************************************************************
 *      Definitions for 3-d vector manipulation functions
 */

#ifdef  SMLFLT
#define  RREAL          float
#define  FTINY          (1e-3)
#else
#define  RREAL          double
#define  FTINY          (1e-6)
#endif
#define  FHUGE          (1e10)

typedef RREAL  FVECT[3];

#define  VCOPY(v1,v2)   ((v1)[0]=(v2)[0],(v1)[1]=(v2)[1],(v1)[2]=(v2)[2])
#define  DOT(v1,v2)     ((v1)[0]*(v2)[0]+(v1)[1]*(v2)[1]+(v1)[2]*(v2)[2])
#define  VSUM(vr,v1,v2,f)       ((vr)[0]=(v1)[0]+(f)*(v2)[0], \
                                (vr)[1]=(v1)[1]+(f)*(v2)[1], \
                                (vr)[2]=(v1)[2]+(f)*(v2)[2])

#define is0vect(v)      (DOT(v,v) <= FTINY*FTINY)

#define round0(x)       if (x <= FTINY && x >= -FTINY) x = 0

extern double   normalize(FVECT);       /* normalize a vector */
extern void     fcross(FVECT,FVECT,FVECT);/* cross product of two vectors */

/************************************************************************
 *      Definitions for context handling routines
 *      (materials, colors, vectors)
 */

#define C_1SIDEDTHICK   0.005           /* assumed thickness of 1-sided mat. */

typedef struct {
        int     clock;          /* incremented each change -- resettable */
        void    *client_data;   /* pointer to private client-owned data */
        int     sided;          /* 1 if surface is 1-sided, 0 for 2-sided */
        float   nr, ni;         /* index of refraction, real and imaginary */
        float   rd;             /* diffuse reflectance */
        C_COLOR rd_c;           /* diffuse reflectance color */
        float   td;             /* diffuse transmittance */
        C_COLOR td_c;           /* diffuse transmittance color */
        float   ed;             /* diffuse emittance */
        C_COLOR ed_c;           /* diffuse emittance color */
        float   rs;             /* specular reflectance */
        C_COLOR rs_c;           /* specular reflectance color */
        float   rs_a;           /* specular reflectance roughness */
        float   ts;             /* specular transmittance */
        C_COLOR ts_c;           /* specular transmittance color */
        float   ts_a;           /* specular transmittance roughness */
} C_MATERIAL;           /* material context */

typedef struct {
        int     clock;          /* incremented each change -- resettable */
        void    *client_data;   /* pointer to private client-owned data */
        FVECT   p, n;           /* point and normal */
} C_VERTEX;             /* vertex context */

#define C_DEFMATERIAL   {1,NULL,0,1.,0.,0.,C_DEFCOLOR,0.,C_DEFCOLOR,0.,\
                                C_DEFCOLOR,0.,C_DEFCOLOR,0.,0.,C_DEFCOLOR,0.}
#define C_DEFVERTEX     {1,NULL,{0.,0.,0.},{0.,0.,0.}}

extern C_COLOR          *c_ccolor;      /* the current color */
extern char             *c_ccname;      /* current color name */
extern C_MATERIAL       *c_cmaterial;   /* the current material */
extern char             *c_cmname;      /* current material name */
extern C_VERTEX         *c_cvertex;     /* the current vertex */
extern char             *c_cvname;      /* current vertex name */

extern int      c_hcolor(int, char **);         /* handle color entity */
extern int      c_hmaterial(int, char **);      /* handle material entity */
extern int      c_hvertex(int, char **);        /* handle vertex entity */
extern void     c_clearall(void);               /* clear context tables */
extern C_MATERIAL       *c_getmaterial(char *); /* get a named material */
extern C_VERTEX *c_getvert(char *);             /* get a named vertex */
extern C_COLOR  *c_getcolor(char *);            /* get a named color */

/*************************************************************************
 *      Definitions for hierarchical object name handler
 */

extern int      obj_nnames;             /* depth of name hierarchy */
extern char     **obj_name;             /* names in hierarchy */

extern int      obj_handler(int, char **);      /* handle an object entity */
extern void     obj_clear(void);                /* clear object stack */

/**************************************************************************
 *      Definitions for hierarchical transformation handler
 */

typedef RREAL  MAT4[4][4];

#define  copymat4(m4a,m4b)      (void)memcpy((char *)m4a,(char *)m4b,sizeof(MAT4))

#define  MAT4IDENT              { {1.,0.,0.,0.}, {0.,1.,0.,0.}, \
                                {0.,0.,1.,0.}, {0.,0.,0.,1.} }

extern MAT4  m4ident;

#define  setident4(m4)          copymat4(m4, m4ident)

                                /* regular transformation */
typedef struct {
        MAT4    xfm;                            /* transform matrix */
        RREAL   sca;                            /* scalefactor */
}  XF;

#define identxf(xp)             (void)(setident4((xp)->xfm),(xp)->sca=1.0)

#define XF_MAXDIM       8               /* maximum array dimensions */

struct xf_array {
        MG_FPOS spos;                   /* starting position on input */
        int     ndim;                   /* number of array dimensions */
        struct {
                short   i, n;           /* current count and maximum */
                char    arg[8];         /* string argument value */
        } aarg[XF_MAXDIM];
};

typedef struct xf_spec {
        long    xid;                    /* unique transform id */
        short   xac;                    /* context argument count */
        short   rev;                    /* boolean true if vertices reversed */
        XF      xf;                     /* cumulative transformation */
        struct xf_array *xarr;          /* transformation array pointer */
        struct xf_spec  *prev;          /* previous transformation context */
} XF_SPEC;                      /* followed by argument buffer */

extern XF_SPEC  *xf_context;                    /* current transform context */
extern char     **xf_argend;                    /* last transform argument */

#define xf_ac(xf)       ((xf)==NULL ? 0 : (xf)->xac)
#define xf_av(xf)       (xf_argend - (xf)->xac)

#define xf_argc         xf_ac(xf_context)
#define xf_argv         xf_av(xf_context)

/*
 * The transformation handler should do most of the work that needs
 * doing.  Just pass it any xf entities, then use the associated
 * functions to transform and translate points, transform vectors
 * (without translation), rotate vectors (without scaling) and scale
 * values appropriately.
 *
 * The routines xf_xfmpoint, xf_xfmvect and xf_rotvect take two
 * 3-D vectors (which may be identical), transforms the second and
 * puts the result into the first.
 */


extern int      xf_handler(int, char **);       /* handle xf entity */
extern void     xf_xfmpoint(FVECT, FVECT);      /* transform point */
extern void     xf_xfmvect(FVECT, FVECT);       /* transform vector */
extern void     xf_rotvect(FVECT, FVECT);       /* rotate vector */
extern double   xf_scale(double);               /* scale a value */
extern void     xf_clear(void);                 /* clear xf stack */

/* The following are support routines you probably won't call directly */

XF_SPEC         *new_xf(int, char **);          /* allocate new transform */
void            free_xf(XF_SPEC *);             /* free a transform */
int             xf_aname(struct xf_array *);    /* name this instance */
long            comp_xfid(MAT4);                /* compute unique ID */
extern void     multmat4(MAT4, MAT4, MAT4);     /* m4a = m4b X m4c */
extern void     multv3(FVECT, FVECT, MAT4);     /* v3a = v3b X m4 (vectors) */
extern void     multp3(FVECT, FVECT, MAT4);     /* p3a = p3b X m4 (points) */
extern int      xf(XF *, int, char **);         /* interpret transform spec. */

        /* cvrgb.c */
extern void mgf2rgb(C_COLOR *cin, double intensity, float cout[3]);

/************************************************************************
 *      Miscellaneous definitions
 */

#ifndef  PI
#ifdef  M_PI
#define  PI             ((double)M_PI)
#else
#define  PI             3.14159265358979323846
#endif
#endif

#ifdef __cplusplus
}
#endif
#endif /* _MGF_PARSER_H_ */

Revision:	1.40
Committed:	Tue Feb 22 15:58:42 2011 UTC (14 years, 2 months ago) by greg
Content type:	text/plain
Branch:	MAIN
CVS Tags:	HEAD
Changes since 1.39:	+1 -1 lines
State:	*FILE REMOVED*
Log Message:	Finish of code reorg, moving MGF library into src/cv and src/common
#	User	Rev	Content
1	greg	1.40	/* RCSid: $Id: parser.h,v 1.39 2011/01/14 05:46:12 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