63 |
|
Initializing the parser is the most important part of writing an MGF |
64 |
|
program, and it is done through the mg_ehand array and a call to mg_init. |
65 |
|
The global mg_ehand variable is an array of pointers to entity handler |
66 |
< |
functions. The arguments to these functions is always the same, an |
66 |
> |
functions. The arguments to these functions are always the same, an |
67 |
|
argument count and an array of argument pointers (ala main). The return |
68 |
|
value for these integer functions is one of the error codes defined in |
69 |
|
parser.h, or MG_OK if the entity was handled correctly. You must |
107 |
|
c_cmaterial variable will be pointing to a structure with all the |
108 |
|
current settings. (Note that you would have to also set the color |
109 |
|
mg_ehand entries to c_hcolor if you intended to support color |
110 |
< |
materials.) |
110 |
> |
materials.) A list of related mg_ehand assignments is given below: |
111 |
|
|
112 |
+ |
mg_ehand[MG_E_COLOR] = c_hcolor; |
113 |
+ |
mg_ehand[MG_E_CMIX] = c_hcolor; |
114 |
+ |
mg_ehand[MG_E_CSPEC] = c_hcolor; |
115 |
+ |
mg_ehand[MG_E_CXY] = c_hcolor; |
116 |
+ |
mg_ehand[MG_E_ED] = c_hmaterial; |
117 |
+ |
mg_ehand[MG_E_MATERIAL] = c_hmaterial; |
118 |
+ |
mg_ehand[MG_E_NORMAL] = c_hvertex; |
119 |
+ |
mg_ehand[MG_E_POINT] = c_hvertex; |
120 |
+ |
mg_ehand[MG_E_RD] = c_hmaterial; |
121 |
+ |
mg_ehand[MG_E_RS] = c_hmaterial; |
122 |
+ |
mg_ehand[MG_E_SIDES] = c_hmaterial; |
123 |
+ |
mg_ehand[MG_E_TD] = c_hmaterial; |
124 |
+ |
mg_ehand[MG_E_TS] = c_hmaterial; |
125 |
+ |
mg_ehand[MG_E_VERTEX] = c_hvertex; |
126 |
+ |
|
127 |
|
In addition to the three handler functions, context.c contains a |
128 |
|
few support routines that make life simpler. For vertices, there |
129 |
|
is the c_getvertex call, which returns a pointer to a named vertex |
136 |
|
simply returns 1 or 0 based on whether the passed color structure |
137 |
|
is close to grey or not. Finally, there is the c_clearall routine, |
138 |
|
which clears and frees all context data structures, and is the |
139 |
< |
principle action of the parser's mg_clear function. |
139 |
> |
principal action of the parser's mg_clear function. |
140 |
|
|
141 |
|
Transform Support |
142 |
|
================= |