2 Copyright (C) 1996-1997 Id Software, Inc.
4 This program is free software; you can redistribute it and/or
5 modify it under the terms of the GNU General Public License
6 as published by the Free Software Foundation; either version 2
7 of the License, or (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13 See the GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the Free Software
17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 This is a try to make the vm more generic, it is mainly based on the progs.h file.
22 For the license refer to progs.h.
24 Generic means, less as possible hard-coded links with the other parts of the engine.
25 This means no edict_engineprivate struct usage, etc.
26 The code uses void pointers instead.
32 #include "pr_comp.h" // defs shared with qcc
33 #include "progdefs.h" // generated by program cdefs
34 #include "clprogdefs.h" // generated by program cdefs
36 #ifndef DP_SMALLMEMORY
40 typedef struct prvm_stack_s
46 double builtinsprofile_acc;
50 typedef union prvm_eval_s
56 prvm_int_t ivector[3];
61 typedef struct prvm_required_field_s
65 } prvm_required_field_t;
68 // AK: I dont call it engine private cause it doesnt really belongs to the engine
69 // it belongs to prvm.
70 typedef struct prvm_edict_private_s
73 float freetime; // realtime of last change to "free" (i.e. also set on allocation)
74 int mark; // used during leaktest (0 = unref, >0 = referenced); special values during server physics:
75 #define PRVM_EDICT_MARK_WAIT_FOR_SETORIGIN -1
76 #define PRVM_EDICT_MARK_SETORIGIN_CAUGHT -2
77 const char *allocation_origin;
78 } prvm_edict_private_t;
80 typedef struct prvm_edict_s
82 // engine-private fields (stored in dynamically resized array)
83 //edict_engineprivate_t *e;
86 prvm_edict_private_t *required;
89 // FIXME: this server pointer really means world, not server
90 // (it is used by both server qc and client qc, but not menu qc)
91 edict_engineprivate_t *server;
92 // add other private structs as you desire
93 // new structs have to start with the elements of prvm_edit_private_t
94 // e.g. a new struct has to either look like this:
95 // typedef struct server_edict_private_s {
96 // prvm_edict_private_t base;
98 // vec3_t moved_fromangles;
99 // ... } server_edict_private_t;
101 // typedef struct server_edict_private_s {
104 // vec3_t moved_from;
105 // vec3_t moved_fromangles;
106 // ... } server_edict_private_t;
107 // However, the first one should be preferred.
109 // QuakeC fields (stored in dynamically resized array)
114 // entvars_t *server;
115 // cl_entvars_t *client;
119 extern prvm_eval_t prvm_badvalue;
121 #define PRVM_alledictfloat(ed, fieldname) (PRVM_EDICTFIELDFLOAT(ed, prog->fieldoffsets.fieldname))
122 #define PRVM_alledictvector(ed, fieldname) (PRVM_EDICTFIELDVECTOR(ed, prog->fieldoffsets.fieldname))
123 #define PRVM_alledictstring(ed, fieldname) (PRVM_EDICTFIELDSTRING(ed, prog->fieldoffsets.fieldname))
124 #define PRVM_alledictedict(ed, fieldname) (PRVM_EDICTFIELDEDICT(ed, prog->fieldoffsets.fieldname))
125 #define PRVM_alledictfunction(ed, fieldname) (PRVM_EDICTFIELDFUNCTION(ed, prog->fieldoffsets.fieldname))
126 #define PRVM_allglobalfloat(fieldname) (PRVM_GLOBALFIELDFLOAT(prog->globaloffsets.fieldname))
127 #define PRVM_allglobalvector(fieldname) (PRVM_GLOBALFIELDVECTOR(prog->globaloffsets.fieldname))
128 #define PRVM_allglobalstring(fieldname) (PRVM_GLOBALFIELDSTRING(prog->globaloffsets.fieldname))
129 #define PRVM_allglobaledict(fieldname) (PRVM_GLOBALFIELDEDICT(prog->globaloffsets.fieldname))
130 #define PRVM_allglobalfunction(fieldname) (PRVM_GLOBALFIELDFUNCTION(prog->globaloffsets.fieldname))
131 #define PRVM_allfunction(funcname) (prog->funcoffsets.funcname)
133 #define PRVM_drawedictfloat(ed, fieldname) (PRVM_EDICTFIELDFLOAT(ed, prog->fieldoffsets.fieldname))
134 #define PRVM_drawedictvector(ed, fieldname) (PRVM_EDICTFIELDVECTOR(ed, prog->fieldoffsets.fieldname))
135 #define PRVM_drawedictstring(ed, fieldname) (PRVM_EDICTFIELDSTRING(ed, prog->fieldoffsets.fieldname))
136 #define PRVM_drawedictedict(ed, fieldname) (PRVM_EDICTFIELDEDICT(ed, prog->fieldoffsets.fieldname))
137 #define PRVM_drawedictfunction(ed, fieldname) (PRVM_EDICTFIELDFUNCTION(ed, prog->fieldoffsets.fieldname))
138 #define PRVM_drawglobalfloat(fieldname) (PRVM_GLOBALFIELDFLOAT(prog->globaloffsets.fieldname))
139 #define PRVM_drawglobalvector(fieldname) (PRVM_GLOBALFIELDVECTOR(prog->globaloffsets.fieldname))
140 #define PRVM_drawglobalstring(fieldname) (PRVM_GLOBALFIELDSTRING(prog->globaloffsets.fieldname))
141 #define PRVM_drawglobaledict(fieldname) (PRVM_GLOBALFIELDEDICT(prog->globaloffsets.fieldname))
142 #define PRVM_drawglobalfunction(fieldname) (PRVM_GLOBALFIELDFUNCTION(prog->globaloffsets.fieldname))
143 #define PRVM_drawfunction(funcname) (prog->funcoffsets.funcname)
145 #define PRVM_gameedictfloat(ed, fieldname) (PRVM_EDICTFIELDFLOAT(ed, prog->fieldoffsets.fieldname))
146 #define PRVM_gameedictvector(ed, fieldname) (PRVM_EDICTFIELDVECTOR(ed, prog->fieldoffsets.fieldname))
147 #define PRVM_gameedictstring(ed, fieldname) (PRVM_EDICTFIELDSTRING(ed, prog->fieldoffsets.fieldname))
148 #define PRVM_gameedictedict(ed, fieldname) (PRVM_EDICTFIELDEDICT(ed, prog->fieldoffsets.fieldname))
149 #define PRVM_gameedictfunction(ed, fieldname) (PRVM_EDICTFIELDFUNCTION(ed, prog->fieldoffsets.fieldname))
150 #define PRVM_gameglobalfloat(fieldname) (PRVM_GLOBALFIELDFLOAT(prog->globaloffsets.fieldname))
151 #define PRVM_gameglobalvector(fieldname) (PRVM_GLOBALFIELDVECTOR(prog->globaloffsets.fieldname))
152 #define PRVM_gameglobalstring(fieldname) (PRVM_GLOBALFIELDSTRING(prog->globaloffsets.fieldname))
153 #define PRVM_gameglobaledict(fieldname) (PRVM_GLOBALFIELDEDICT(prog->globaloffsets.fieldname))
154 #define PRVM_gameglobalfunction(fieldname) (PRVM_GLOBALFIELDFUNCTION(prog->globaloffsets.fieldname))
155 #define PRVM_gamefunction(funcname) (prog->funcoffsets.funcname)
157 #define PRVM_serveredictfloat(ed, fieldname) (PRVM_EDICTFIELDFLOAT(ed, prog->fieldoffsets.fieldname))
158 #define PRVM_serveredictvector(ed, fieldname) (PRVM_EDICTFIELDVECTOR(ed, prog->fieldoffsets.fieldname))
159 #define PRVM_serveredictstring(ed, fieldname) (PRVM_EDICTFIELDSTRING(ed, prog->fieldoffsets.fieldname))
160 #define PRVM_serveredictedict(ed, fieldname) (PRVM_EDICTFIELDEDICT(ed, prog->fieldoffsets.fieldname))
161 #define PRVM_serveredictfunction(ed, fieldname) (PRVM_EDICTFIELDFUNCTION(ed, prog->fieldoffsets.fieldname))
162 #define PRVM_serverglobalfloat(fieldname) (PRVM_GLOBALFIELDFLOAT(prog->globaloffsets.fieldname))
163 #define PRVM_serverglobalvector(fieldname) (PRVM_GLOBALFIELDVECTOR(prog->globaloffsets.fieldname))
164 #define PRVM_serverglobalstring(fieldname) (PRVM_GLOBALFIELDSTRING(prog->globaloffsets.fieldname))
165 #define PRVM_serverglobaledict(fieldname) (PRVM_GLOBALFIELDEDICT(prog->globaloffsets.fieldname))
166 #define PRVM_serverglobalfunction(fieldname) (PRVM_GLOBALFIELDFUNCTION(prog->globaloffsets.fieldname))
167 #define PRVM_serverfunction(funcname) (prog->funcoffsets.funcname)
169 #define PRVM_clientedictfloat(ed, fieldname) (PRVM_EDICTFIELDFLOAT(ed, prog->fieldoffsets.fieldname))
170 #define PRVM_clientedictvector(ed, fieldname) (PRVM_EDICTFIELDVECTOR(ed, prog->fieldoffsets.fieldname))
171 #define PRVM_clientedictstring(ed, fieldname) (PRVM_EDICTFIELDSTRING(ed, prog->fieldoffsets.fieldname))
172 #define PRVM_clientedictedict(ed, fieldname) (PRVM_EDICTFIELDEDICT(ed, prog->fieldoffsets.fieldname))
173 #define PRVM_clientedictfunction(ed, fieldname) (PRVM_EDICTFIELDFUNCTION(ed, prog->fieldoffsets.fieldname))
174 #define PRVM_clientglobalfloat(fieldname) (PRVM_GLOBALFIELDFLOAT(prog->globaloffsets.fieldname))
175 #define PRVM_clientglobalvector(fieldname) (PRVM_GLOBALFIELDVECTOR(prog->globaloffsets.fieldname))
176 #define PRVM_clientglobalstring(fieldname) (PRVM_GLOBALFIELDSTRING(prog->globaloffsets.fieldname))
177 #define PRVM_clientglobaledict(fieldname) (PRVM_GLOBALFIELDEDICT(prog->globaloffsets.fieldname))
178 #define PRVM_clientglobalfunction(fieldname) (PRVM_GLOBALFIELDFUNCTION(prog->globaloffsets.fieldname))
179 #define PRVM_clientfunction(funcname) (prog->funcoffsets.funcname)
181 #define PRVM_menuedictfloat(ed, fieldname) (PRVM_EDICTFIELDFLOAT(ed, prog->fieldoffsets.fieldname))
182 #define PRVM_menuedictvector(ed, fieldname) (PRVM_EDICTFIELDVECTOR(ed, prog->fieldoffsets.fieldname))
183 #define PRVM_menuedictstring(ed, fieldname) (PRVM_EDICTFIELDSTRING(ed, prog->fieldoffsets.fieldname))
184 #define PRVM_menuedictedict(ed, fieldname) (PRVM_EDICTFIELDEDICT(ed, prog->fieldoffsets.fieldname))
185 #define PRVM_menuedictfunction(ed, fieldname) (PRVM_EDICTFIELDFUNCTION(ed, prog->fieldoffsets.fieldname))
186 #define PRVM_menuglobalfloat(fieldname) (PRVM_GLOBALFIELDFLOAT(prog->globaloffsets.fieldname))
187 #define PRVM_menuglobalvector(fieldname) (PRVM_GLOBALFIELDVECTOR(prog->globaloffsets.fieldname))
188 #define PRVM_menuglobalstring(fieldname) (PRVM_GLOBALFIELDSTRING(prog->globaloffsets.fieldname))
189 #define PRVM_menuglobaledict(fieldname) (PRVM_GLOBALFIELDEDICT(prog->globaloffsets.fieldname))
190 #define PRVM_menuglobalfunction(fieldname) (PRVM_GLOBALFIELDFUNCTION(prog->globaloffsets.fieldname))
191 #define PRVM_menufunction(funcname) (prog->funcoffsets.funcname)
194 #define PRVM_EDICTFIELDVALUE(ed, fieldoffset) ((fieldoffset) < 0 ? Con_Printf("Invalid fieldoffset at %s:%i\n", __FILE__, __LINE__), &prvm_badvalue : (prvm_eval_t *)((ed)->fields.fp + (fieldoffset)))
195 #define PRVM_EDICTFIELDFLOAT(ed, fieldoffset) (PRVM_EDICTFIELDVALUE(ed, fieldoffset)->_float)
196 #define PRVM_EDICTFIELDVECTOR(ed, fieldoffset) (PRVM_EDICTFIELDVALUE(ed, fieldoffset)->vector)
197 #define PRVM_EDICTFIELDSTRING(ed, fieldoffset) (PRVM_EDICTFIELDVALUE(ed, fieldoffset)->string)
198 #define PRVM_EDICTFIELDEDICT(ed, fieldoffset) (PRVM_EDICTFIELDVALUE(ed, fieldoffset)->edict)
199 #define PRVM_EDICTFIELDFUNCTION(ed, fieldoffset) (PRVM_EDICTFIELDVALUE(ed, fieldoffset)->function)
200 #define PRVM_GLOBALFIELDVALUE(fieldoffset) ((fieldoffset) < 0 ? Con_Printf("Invalid fieldoffset at %s:%i\n", __FILE__, __LINE__), &prvm_badvalue : (prvm_eval_t *)(prog->globals.fp + (fieldoffset)))
201 #define PRVM_GLOBALFIELDFLOAT(fieldoffset) (PRVM_GLOBALFIELDVALUE(fieldoffset)->_float)
202 #define PRVM_GLOBALFIELDVECTOR(fieldoffset) (PRVM_GLOBALFIELDVALUE(fieldoffset)->vector)
203 #define PRVM_GLOBALFIELDSTRING(fieldoffset) (PRVM_GLOBALFIELDVALUE(fieldoffset)->string)
204 #define PRVM_GLOBALFIELDEDICT(fieldoffset) (PRVM_GLOBALFIELDVALUE(fieldoffset)->edict)
205 #define PRVM_GLOBALFIELDFUNCTION(fieldoffset) (PRVM_GLOBALFIELDVALUE(fieldoffset)->function)
207 #define PRVM_EDICTFIELDVALUE(ed, fieldoffset) ((prvm_eval_t *)(ed->fields.fp + fieldoffset))
208 #define PRVM_EDICTFIELDFLOAT(ed, fieldoffset) (((prvm_eval_t *)(ed->fields.fp + fieldoffset))->_float)
209 #define PRVM_EDICTFIELDVECTOR(ed, fieldoffset) (((prvm_eval_t *)(ed->fields.fp + fieldoffset))->vector)
210 #define PRVM_EDICTFIELDSTRING(ed, fieldoffset) (((prvm_eval_t *)(ed->fields.fp + fieldoffset))->string)
211 #define PRVM_EDICTFIELDEDICT(ed, fieldoffset) (((prvm_eval_t *)(ed->fields.fp + fieldoffset))->edict)
212 #define PRVM_EDICTFIELDFUNCTION(ed, fieldoffset) (((prvm_eval_t *)(ed->fields.fp + fieldoffset))->function)
213 #define PRVM_GLOBALFIELDVALUE(fieldoffset) ((prvm_eval_t *)(prog->globals.fp + fieldoffset))
214 #define PRVM_GLOBALFIELDFLOAT(fieldoffset) (((prvm_eval_t *)(prog->globals.fp + fieldoffset))->_float)
215 #define PRVM_GLOBALFIELDVECTOR(fieldoffset) (((prvm_eval_t *)(prog->globals.fp + fieldoffset))->vector)
216 #define PRVM_GLOBALFIELDSTRING(fieldoffset) (((prvm_eval_t *)(prog->globals.fp + fieldoffset))->string)
217 #define PRVM_GLOBALFIELDEDICT(fieldoffset) (((prvm_eval_t *)(prog->globals.fp + fieldoffset))->edict)
218 #define PRVM_GLOBALFIELDFUNCTION(fieldoffset) (((prvm_eval_t *)(prog->globals.fp + fieldoffset))->function)
221 //============================================================================
222 #define PRVM_OP_STATE 1
224 #ifdef DP_SMALLMEMORY
225 #define PRVM_MAX_STACK_DEPTH 128
226 #define PRVM_LOCALSTACK_SIZE 2048
228 #define PRVM_MAX_OPENFILES 16
229 #define PRVM_MAX_OPENSEARCHES 8
231 #define PRVM_MAX_STACK_DEPTH 1024
232 #define PRVM_LOCALSTACK_SIZE 16384
234 #define PRVM_MAX_OPENFILES 256
235 #define PRVM_MAX_OPENSEARCHES 128
239 typedef void (*prvm_builtin_t) (struct prvm_prog_s *prog);
241 // NOTE: field offsets use -1 for NULL
242 typedef struct prvm_prog_fieldoffsets_s
244 #define PRVM_DECLARE_serverglobalfloat(x)
245 #define PRVM_DECLARE_serverglobalvector(x)
246 #define PRVM_DECLARE_serverglobalstring(x)
247 #define PRVM_DECLARE_serverglobaledict(x)
248 #define PRVM_DECLARE_serverglobalfunction(x)
249 #define PRVM_DECLARE_clientglobalfloat(x)
250 #define PRVM_DECLARE_clientglobalvector(x)
251 #define PRVM_DECLARE_clientglobalstring(x)
252 #define PRVM_DECLARE_clientglobaledict(x)
253 #define PRVM_DECLARE_clientglobalfunction(x)
254 #define PRVM_DECLARE_menuglobalfloat(x)
255 #define PRVM_DECLARE_menuglobalvector(x)
256 #define PRVM_DECLARE_menuglobalstring(x)
257 #define PRVM_DECLARE_menuglobaledict(x)
258 #define PRVM_DECLARE_menuglobalfunction(x)
259 #define PRVM_DECLARE_serverfieldfloat(x)
260 #define PRVM_DECLARE_serverfieldvector(x)
261 #define PRVM_DECLARE_serverfieldstring(x)
262 #define PRVM_DECLARE_serverfieldedict(x)
263 #define PRVM_DECLARE_serverfieldfunction(x)
264 #define PRVM_DECLARE_clientfieldfloat(x)
265 #define PRVM_DECLARE_clientfieldvector(x)
266 #define PRVM_DECLARE_clientfieldstring(x)
267 #define PRVM_DECLARE_clientfieldedict(x)
268 #define PRVM_DECLARE_clientfieldfunction(x)
269 #define PRVM_DECLARE_menufieldfloat(x)
270 #define PRVM_DECLARE_menufieldvector(x)
271 #define PRVM_DECLARE_menufieldstring(x)
272 #define PRVM_DECLARE_menufieldedict(x)
273 #define PRVM_DECLARE_menufieldfunction(x)
274 #define PRVM_DECLARE_serverfunction(x)
275 #define PRVM_DECLARE_clientfunction(x)
276 #define PRVM_DECLARE_menufunction(x)
277 #define PRVM_DECLARE_field(x) int x;
278 #define PRVM_DECLARE_global(x)
279 #define PRVM_DECLARE_function(x)
280 #include "prvm_offsets.h"
281 #undef PRVM_DECLARE_serverglobalfloat
282 #undef PRVM_DECLARE_serverglobalvector
283 #undef PRVM_DECLARE_serverglobalstring
284 #undef PRVM_DECLARE_serverglobaledict
285 #undef PRVM_DECLARE_serverglobalfunction
286 #undef PRVM_DECLARE_clientglobalfloat
287 #undef PRVM_DECLARE_clientglobalvector
288 #undef PRVM_DECLARE_clientglobalstring
289 #undef PRVM_DECLARE_clientglobaledict
290 #undef PRVM_DECLARE_clientglobalfunction
291 #undef PRVM_DECLARE_menuglobalfloat
292 #undef PRVM_DECLARE_menuglobalvector
293 #undef PRVM_DECLARE_menuglobalstring
294 #undef PRVM_DECLARE_menuglobaledict
295 #undef PRVM_DECLARE_menuglobalfunction
296 #undef PRVM_DECLARE_serverfieldfloat
297 #undef PRVM_DECLARE_serverfieldvector
298 #undef PRVM_DECLARE_serverfieldstring
299 #undef PRVM_DECLARE_serverfieldedict
300 #undef PRVM_DECLARE_serverfieldfunction
301 #undef PRVM_DECLARE_clientfieldfloat
302 #undef PRVM_DECLARE_clientfieldvector
303 #undef PRVM_DECLARE_clientfieldstring
304 #undef PRVM_DECLARE_clientfieldedict
305 #undef PRVM_DECLARE_clientfieldfunction
306 #undef PRVM_DECLARE_menufieldfloat
307 #undef PRVM_DECLARE_menufieldvector
308 #undef PRVM_DECLARE_menufieldstring
309 #undef PRVM_DECLARE_menufieldedict
310 #undef PRVM_DECLARE_menufieldfunction
311 #undef PRVM_DECLARE_serverfunction
312 #undef PRVM_DECLARE_clientfunction
313 #undef PRVM_DECLARE_menufunction
314 #undef PRVM_DECLARE_field
315 #undef PRVM_DECLARE_global
316 #undef PRVM_DECLARE_function
318 prvm_prog_fieldoffsets_t;
320 // NOTE: global offsets use -1 for NULL
321 typedef struct prvm_prog_globaloffsets_s
323 #define PRVM_DECLARE_serverglobalfloat(x)
324 #define PRVM_DECLARE_serverglobalvector(x)
325 #define PRVM_DECLARE_serverglobalstring(x)
326 #define PRVM_DECLARE_serverglobaledict(x)
327 #define PRVM_DECLARE_serverglobalfunction(x)
328 #define PRVM_DECLARE_clientglobalfloat(x)
329 #define PRVM_DECLARE_clientglobalvector(x)
330 #define PRVM_DECLARE_clientglobalstring(x)
331 #define PRVM_DECLARE_clientglobaledict(x)
332 #define PRVM_DECLARE_clientglobalfunction(x)
333 #define PRVM_DECLARE_menuglobalfloat(x)
334 #define PRVM_DECLARE_menuglobalvector(x)
335 #define PRVM_DECLARE_menuglobalstring(x)
336 #define PRVM_DECLARE_menuglobaledict(x)
337 #define PRVM_DECLARE_menuglobalfunction(x)
338 #define PRVM_DECLARE_serverfieldfloat(x)
339 #define PRVM_DECLARE_serverfieldvector(x)
340 #define PRVM_DECLARE_serverfieldstring(x)
341 #define PRVM_DECLARE_serverfieldedict(x)
342 #define PRVM_DECLARE_serverfieldfunction(x)
343 #define PRVM_DECLARE_clientfieldfloat(x)
344 #define PRVM_DECLARE_clientfieldvector(x)
345 #define PRVM_DECLARE_clientfieldstring(x)
346 #define PRVM_DECLARE_clientfieldedict(x)
347 #define PRVM_DECLARE_clientfieldfunction(x)
348 #define PRVM_DECLARE_menufieldfloat(x)
349 #define PRVM_DECLARE_menufieldvector(x)
350 #define PRVM_DECLARE_menufieldstring(x)
351 #define PRVM_DECLARE_menufieldedict(x)
352 #define PRVM_DECLARE_menufieldfunction(x)
353 #define PRVM_DECLARE_serverfunction(x)
354 #define PRVM_DECLARE_clientfunction(x)
355 #define PRVM_DECLARE_menufunction(x)
356 #define PRVM_DECLARE_field(x)
357 #define PRVM_DECLARE_global(x) int x;
358 #define PRVM_DECLARE_function(x)
359 #include "prvm_offsets.h"
360 #undef PRVM_DECLARE_serverglobalfloat
361 #undef PRVM_DECLARE_serverglobalvector
362 #undef PRVM_DECLARE_serverglobalstring
363 #undef PRVM_DECLARE_serverglobaledict
364 #undef PRVM_DECLARE_serverglobalfunction
365 #undef PRVM_DECLARE_clientglobalfloat
366 #undef PRVM_DECLARE_clientglobalvector
367 #undef PRVM_DECLARE_clientglobalstring
368 #undef PRVM_DECLARE_clientglobaledict
369 #undef PRVM_DECLARE_clientglobalfunction
370 #undef PRVM_DECLARE_menuglobalfloat
371 #undef PRVM_DECLARE_menuglobalvector
372 #undef PRVM_DECLARE_menuglobalstring
373 #undef PRVM_DECLARE_menuglobaledict
374 #undef PRVM_DECLARE_menuglobalfunction
375 #undef PRVM_DECLARE_serverfieldfloat
376 #undef PRVM_DECLARE_serverfieldvector
377 #undef PRVM_DECLARE_serverfieldstring
378 #undef PRVM_DECLARE_serverfieldedict
379 #undef PRVM_DECLARE_serverfieldfunction
380 #undef PRVM_DECLARE_clientfieldfloat
381 #undef PRVM_DECLARE_clientfieldvector
382 #undef PRVM_DECLARE_clientfieldstring
383 #undef PRVM_DECLARE_clientfieldedict
384 #undef PRVM_DECLARE_clientfieldfunction
385 #undef PRVM_DECLARE_menufieldfloat
386 #undef PRVM_DECLARE_menufieldvector
387 #undef PRVM_DECLARE_menufieldstring
388 #undef PRVM_DECLARE_menufieldedict
389 #undef PRVM_DECLARE_menufieldfunction
390 #undef PRVM_DECLARE_serverfunction
391 #undef PRVM_DECLARE_clientfunction
392 #undef PRVM_DECLARE_menufunction
393 #undef PRVM_DECLARE_field
394 #undef PRVM_DECLARE_global
395 #undef PRVM_DECLARE_function
397 prvm_prog_globaloffsets_t;
399 // NOTE: function offsets use 0 for NULL
400 typedef struct prvm_prog_funcoffsets_s
402 #define PRVM_DECLARE_serverglobalfloat(x)
403 #define PRVM_DECLARE_serverglobalvector(x)
404 #define PRVM_DECLARE_serverglobalstring(x)
405 #define PRVM_DECLARE_serverglobaledict(x)
406 #define PRVM_DECLARE_serverglobalfunction(x)
407 #define PRVM_DECLARE_clientglobalfloat(x)
408 #define PRVM_DECLARE_clientglobalvector(x)
409 #define PRVM_DECLARE_clientglobalstring(x)
410 #define PRVM_DECLARE_clientglobaledict(x)
411 #define PRVM_DECLARE_clientglobalfunction(x)
412 #define PRVM_DECLARE_menuglobalfloat(x)
413 #define PRVM_DECLARE_menuglobalvector(x)
414 #define PRVM_DECLARE_menuglobalstring(x)
415 #define PRVM_DECLARE_menuglobaledict(x)
416 #define PRVM_DECLARE_menuglobalfunction(x)
417 #define PRVM_DECLARE_serverfieldfloat(x)
418 #define PRVM_DECLARE_serverfieldvector(x)
419 #define PRVM_DECLARE_serverfieldstring(x)
420 #define PRVM_DECLARE_serverfieldedict(x)
421 #define PRVM_DECLARE_serverfieldfunction(x)
422 #define PRVM_DECLARE_clientfieldfloat(x)
423 #define PRVM_DECLARE_clientfieldvector(x)
424 #define PRVM_DECLARE_clientfieldstring(x)
425 #define PRVM_DECLARE_clientfieldedict(x)
426 #define PRVM_DECLARE_clientfieldfunction(x)
427 #define PRVM_DECLARE_menufieldfloat(x)
428 #define PRVM_DECLARE_menufieldvector(x)
429 #define PRVM_DECLARE_menufieldstring(x)
430 #define PRVM_DECLARE_menufieldedict(x)
431 #define PRVM_DECLARE_menufieldfunction(x)
432 #define PRVM_DECLARE_serverfunction(x)
433 #define PRVM_DECLARE_clientfunction(x)
434 #define PRVM_DECLARE_menufunction(x)
435 #define PRVM_DECLARE_field(x)
436 #define PRVM_DECLARE_global(x)
437 #define PRVM_DECLARE_function(x) int x;
438 #include "prvm_offsets.h"
439 #undef PRVM_DECLARE_serverglobalfloat
440 #undef PRVM_DECLARE_serverglobalvector
441 #undef PRVM_DECLARE_serverglobalstring
442 #undef PRVM_DECLARE_serverglobaledict
443 #undef PRVM_DECLARE_serverglobalfunction
444 #undef PRVM_DECLARE_clientglobalfloat
445 #undef PRVM_DECLARE_clientglobalvector
446 #undef PRVM_DECLARE_clientglobalstring
447 #undef PRVM_DECLARE_clientglobaledict
448 #undef PRVM_DECLARE_clientglobalfunction
449 #undef PRVM_DECLARE_menuglobalfloat
450 #undef PRVM_DECLARE_menuglobalvector
451 #undef PRVM_DECLARE_menuglobalstring
452 #undef PRVM_DECLARE_menuglobaledict
453 #undef PRVM_DECLARE_menuglobalfunction
454 #undef PRVM_DECLARE_serverfieldfloat
455 #undef PRVM_DECLARE_serverfieldvector
456 #undef PRVM_DECLARE_serverfieldstring
457 #undef PRVM_DECLARE_serverfieldedict
458 #undef PRVM_DECLARE_serverfieldfunction
459 #undef PRVM_DECLARE_clientfieldfloat
460 #undef PRVM_DECLARE_clientfieldvector
461 #undef PRVM_DECLARE_clientfieldstring
462 #undef PRVM_DECLARE_clientfieldedict
463 #undef PRVM_DECLARE_clientfieldfunction
464 #undef PRVM_DECLARE_menufieldfloat
465 #undef PRVM_DECLARE_menufieldvector
466 #undef PRVM_DECLARE_menufieldstring
467 #undef PRVM_DECLARE_menufieldedict
468 #undef PRVM_DECLARE_menufieldfunction
469 #undef PRVM_DECLARE_serverfunction
470 #undef PRVM_DECLARE_clientfunction
471 #undef PRVM_DECLARE_menufunction
472 #undef PRVM_DECLARE_field
473 #undef PRVM_DECLARE_global
474 #undef PRVM_DECLARE_function
476 prvm_prog_funcoffsets_t;
478 // stringbuffer flags
479 #define STRINGBUFFER_SAVED 1 // saved in savegames
480 #define STRINGBUFFER_QCFLAGS 1 // allowed to be set by QC
481 #define STRINGBUFFER_TEMP 128 // internal use ONLY
482 typedef struct prvm_stringbuffer_s
492 // [INIT] variables flagged with this token can be initialized by 'you'
493 // NOTE: external code has to create and free the mempools but everything else is done by prvm !
494 typedef struct prvm_prog_s
496 double starttime; // system time when PRVM_Prog_Load was called
497 double inittime; // system time when QC initialization code finished (any entity created before is not a leak)
498 double profiletime; // system time when last PRVM_CallProfile was called (or PRVM_Prog_Load initially)
499 mfunction_t *functions;
500 int functions_covered;
505 mstatement_t *statements;
506 int entityfields; // number of vec_t fields in progs (some variables are 3)
507 int entityfieldsarea; // LordHavoc: equal to max_edicts * entityfields (for bounds checking)
509 // loaded values from the disk format
512 int progs_numstatements;
513 int progs_numglobaldefs;
514 int progs_numfielddefs;
515 int progs_numfunctions;
516 int progs_numstrings;
517 int progs_numglobals;
518 int progs_entityfields;
520 // real values in memory (some modified by loader)
528 int *statement_linenums; // NULL if not available
529 int *statement_columnnums; // NULL if not available
531 double *statement_profile; // only incremented if prvm_statementprofiling is on
532 int statements_covered;
533 double *explicit_profile; // only incremented if prvm_statementprofiling is on
534 int explicit_covered;
535 int numexplicitcoveragestatements;
540 // globalvars_t *server;
541 // cl_globalvars_t *client;
546 // this is updated whenever a string is removed or added
547 // (simple optimization of the free string search)
548 int firstfreeknownstring;
549 const char **knownstrings;
550 unsigned char *knownstrings_freeable;
551 const char **knownstrings_origin;
552 const char ***stringshash;
554 memexpandablearray_t stringbuffersarray;
556 // all memory allocations related to this vm_prog (code, edicts, strings)
557 mempool_t *progs_mempool; // [INIT]
559 prvm_builtin_t *builtins; // [INIT]
560 int numbuiltins; // [INIT]
566 int break_stack_index;
568 etype_t watch_global_type;
569 prvm_eval_t watch_global_value;
572 etype_t watch_field_type;
573 prvm_eval_t watch_edictfield_value;
575 mfunction_t *xfunction;
578 // stacktrace writes into stack[MAX_STACK_DEPTH]
579 // thus increase the array, so depth wont be overwritten
580 prvm_stack_t stack[PRVM_MAX_STACK_DEPTH+1];
583 prvm_int_t localstack[PRVM_LOCALSTACK_SIZE];
586 unsigned short filecrc;
588 //============================================================================
589 // until this point everything also exists (with the pr_ prefix) in the old vm
591 qfile_t *openfiles[PRVM_MAX_OPENFILES];
592 const char * openfiles_origin[PRVM_MAX_OPENFILES];
593 fssearch_t *opensearches[PRVM_MAX_OPENSEARCHES];
594 const char * opensearches_origin[PRVM_MAX_OPENSEARCHES];
595 skeleton_t *skeletons[MAX_EDICTS];
597 // buffer for storing all tempstrings created during one invocation of ExecuteProgram
598 sizebuf_t tempstringsbuf;
600 // in csqc the polygonbegin,polygonvertex,polygonend sequencing is
601 // stateful, so this tracks the last polygonbegin's choice of
602 // CL_Mesh_CSQC or CL_Mesh_UI for this polygon
603 dp_model_t *polygonbegin_model;
605 // copies of some vars that were former read from sv
607 // number of edicts for which space has been (should be) allocated
608 int max_edicts; // [INIT]
609 // used instead of the constant MAX_EDICTS
610 int limit_edicts; // [INIT]
612 // number of reserved edicts (allocated from 1)
613 int reserved_edicts; // [INIT]
615 prvm_edict_t *edicts;
616 prvm_vec_t *edictsfields;
619 // size of the engine private struct
620 int edictprivate_size; // [INIT]
622 prvm_prog_fieldoffsets_t fieldoffsets;
623 prvm_prog_globaloffsets_t globaloffsets;
624 prvm_prog_funcoffsets_t funcoffsets;
626 // allow writing to world entity fields, this is set by server init and
627 // cleared before first server frame
628 qboolean allowworldwrites;
630 // name of the prog, e.g. "Server", "Client" or "Menu" (used for text output)
631 const char *name; // [INIT]
633 // flag - used to store general flags like PRVM_GE_SELF, etc.
636 const char *extensionstring; // [INIT]
638 qboolean loadintoworld; // [INIT]
640 // used to indicate whether a prog is loaded
642 qboolean leaktest_active;
644 // translation buffer (only needs to be freed on unloading progs, type is private to prvm_edict.c)
647 // printed together with backtraces
648 const char *statestring;
650 struct animatemodel_cache *animatemodel_cache;
652 // prvm_builtin_mem_t *mem_list;
654 // now passed as parameter of PRVM_LoadProgs
655 // char **required_func;
656 // int numrequiredfunc;
658 //============================================================================
660 ddef_t *self; // if self != 0 then there is a global self
662 //============================================================================
665 void (*begin_increase_edicts)(struct prvm_prog_s *prog); // [INIT] used by PRVM_MEM_Increase_Edicts
666 void (*end_increase_edicts)(struct prvm_prog_s *prog); // [INIT]
668 void (*init_edict)(struct prvm_prog_s *prog, prvm_edict_t *edict); // [INIT] used by PRVM_ED_ClearEdict
669 void (*free_edict)(struct prvm_prog_s *prog, prvm_edict_t *ed); // [INIT] used by PRVM_ED_Free
671 void (*count_edicts)(struct prvm_prog_s *prog); // [INIT] used by PRVM_ED_Count_f
673 qboolean (*load_edict)(struct prvm_prog_s *prog, prvm_edict_t *ent); // [INIT] used by PRVM_ED_LoadFromFile
675 void (*init_cmd)(struct prvm_prog_s *prog); // [INIT] used by PRVM_InitProg
676 void (*reset_cmd)(struct prvm_prog_s *prog); // [INIT] used by PRVM_ResetProg
678 void (*error_cmd)(const char *format, ...) DP_FUNC_PRINTF(1); // [INIT]
680 void (*ExecuteProgram)(struct prvm_prog_s *prog, func_t fnum, const char *errormessage); // pointer to one of the *VM_ExecuteProgram functions
683 typedef enum prvm_progindex_e
692 extern prvm_prog_t prvm_prog_list[PRVM_PROG_MAX];
693 prvm_prog_t *PRVM_ProgFromString(const char *str);
694 prvm_prog_t *PRVM_FriendlyProgFromString(const char *str); // for console commands (prints error if name unknown and returns NULL, prints error if prog not loaded and returns NULL)
695 #define PRVM_GetProg(n) (&prvm_prog_list[(n)])
696 #define PRVM_ProgLoaded(n) (PRVM_GetProg(n)->loaded)
697 #define SVVM_prog (&prvm_prog_list[PRVM_PROG_SERVER])
698 #define CLVM_prog (&prvm_prog_list[PRVM_PROG_CLIENT])
700 #define MVM_prog (&prvm_prog_list[PRVM_PROG_MENU])
703 //============================================================================
706 extern prvm_builtin_t vm_sv_builtins[];
707 extern prvm_builtin_t vm_cl_builtins[];
708 extern prvm_builtin_t vm_m_builtins[];
710 extern const int vm_sv_numbuiltins;
711 extern const int vm_cl_numbuiltins;
712 extern const int vm_m_numbuiltins;
714 extern const char * vm_sv_extensions; // client also uses this
715 extern const char * vm_m_extensions;
717 void SVVM_init_cmd(prvm_prog_t *prog);
718 void SVVM_reset_cmd(prvm_prog_t *prog);
720 void CLVM_init_cmd(prvm_prog_t *prog);
721 void CLVM_reset_cmd(prvm_prog_t *prog);
724 void MVM_init_cmd(prvm_prog_t *prog);
725 void MVM_reset_cmd(prvm_prog_t *prog);
728 void VM_Cmd_Init(prvm_prog_t *prog);
729 void VM_Cmd_Reset(prvm_prog_t *prog);
730 //============================================================================
732 void PRVM_Init (void);
735 void SVVM_ExecuteProgram (prvm_prog_t *prog, func_t fnum, const char *errormessage);
736 void CLVM_ExecuteProgram (prvm_prog_t *prog, func_t fnum, const char *errormessage);
738 void MVM_ExecuteProgram (prvm_prog_t *prog, func_t fnum, const char *errormessage);
741 #define SVVM_ExecuteProgram PRVM_ExecuteProgram
742 #define CLVM_ExecuteProgram PRVM_ExecuteProgram
744 #define MVM_ExecuteProgram PRVM_ExecuteProgram
746 void PRVM_ExecuteProgram (prvm_prog_t *prog, func_t fnum, const char *errormessage);
749 #define PRVM_Alloc(buffersize) Mem_Alloc(prog->progs_mempool, buffersize)
750 #define PRVM_Free(buffer) Mem_Free(buffer)
752 void PRVM_Profile (prvm_prog_t *prog, int maxfunctions, double mintime, int sortby);
753 void PRVM_Profile_f (void);
754 void PRVM_ChildProfile_f (void);
755 void PRVM_CallProfile_f (void);
756 void PRVM_PrintFunction_f (void);
758 void PRVM_PrintState(prvm_prog_t *prog, int stack_index);
759 void PRVM_Crash(prvm_prog_t *prog);
760 void PRVM_ShortStackTrace(prvm_prog_t *prog, char *buf, size_t bufsize);
761 const char *PRVM_AllocationOrigin(prvm_prog_t *prog);
763 ddef_t *PRVM_ED_FindField(prvm_prog_t *prog, const char *name);
764 ddef_t *PRVM_ED_FindGlobal(prvm_prog_t *prog, const char *name);
765 mfunction_t *PRVM_ED_FindFunction(prvm_prog_t *prog, const char *name);
767 int PRVM_ED_FindFieldOffset(prvm_prog_t *prog, const char *name);
768 int PRVM_ED_FindGlobalOffset(prvm_prog_t *prog, const char *name);
769 func_t PRVM_ED_FindFunctionOffset(prvm_prog_t *prog, const char *name);
770 #define PRVM_ED_FindFieldOffset_FromStruct(st, field) prog->fieldoffsets . field = ((int *)(&((st *)NULL)-> field ) - ((int *)NULL))
771 #define PRVM_ED_FindGlobalOffset_FromStruct(st, field) prog->globaloffsets . field = ((int *)(&((st *)NULL)-> field ) - ((int *)NULL))
773 void PRVM_MEM_IncreaseEdicts(prvm_prog_t *prog);
775 qboolean PRVM_ED_CanAlloc(prvm_prog_t *prog, prvm_edict_t *e);
776 prvm_edict_t *PRVM_ED_Alloc(prvm_prog_t *prog);
777 void PRVM_ED_Free(prvm_prog_t *prog, prvm_edict_t *ed);
778 void PRVM_ED_ClearEdict(prvm_prog_t *prog, prvm_edict_t *e);
780 void PRVM_PrintFunctionStatements(prvm_prog_t *prog, const char *name);
781 void PRVM_ED_Print(prvm_prog_t *prog, prvm_edict_t *ed, const char *wildcard_fieldname);
782 void PRVM_ED_Write(prvm_prog_t *prog, qfile_t *f, prvm_edict_t *ed);
783 const char *PRVM_ED_ParseEdict(prvm_prog_t *prog, const char *data, prvm_edict_t *ent);
785 void PRVM_ED_WriteGlobals(prvm_prog_t *prog, qfile_t *f);
786 void PRVM_ED_ParseGlobals(prvm_prog_t *prog, const char *data);
788 void PRVM_ED_LoadFromFile(prvm_prog_t *prog, const char *data);
790 unsigned int PRVM_EDICT_NUM_ERROR(prvm_prog_t *prog, unsigned int n, const char *filename, int fileline);
791 #define PRVM_EDICT(n) (((unsigned)(n) < (unsigned int)prog->max_edicts) ? (unsigned int)(n) : PRVM_EDICT_NUM_ERROR(prog, (unsigned int)(n), __FILE__, __LINE__))
792 #define PRVM_EDICT_NUM(n) (prog->edicts + PRVM_EDICT(n))
794 //int NUM_FOR_EDICT_ERROR(prvm_edict_t *e);
795 #define PRVM_NUM_FOR_EDICT(e) ((int)((prvm_edict_t *)(e) - prog->edicts))
796 //int PRVM_NUM_FOR_EDICT(prvm_edict_t *e);
798 #define PRVM_NEXT_EDICT(e) ((e) + 1)
800 #define PRVM_EDICT_TO_PROG(e) (PRVM_NUM_FOR_EDICT(e))
801 //int PRVM_EDICT_TO_PROG(prvm_edict_t *e);
802 #define PRVM_PROG_TO_EDICT(n) (PRVM_EDICT_NUM(n))
803 //prvm_edict_t *PRVM_PROG_TO_EDICT(int n);
805 //============================================================================
807 #define PRVM_G_FLOAT(o) (prog->globals.fp[o])
808 #define PRVM_G_INT(o) (prog->globals.ip[o])
809 #define PRVM_G_EDICT(o) (PRVM_PROG_TO_EDICT(prog->globals.ip[o]))
810 #define PRVM_G_EDICTNUM(o) PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(o))
811 #define PRVM_G_VECTOR(o) (&prog->globals.fp[o])
812 #define PRVM_G_STRING(o) (PRVM_GetString(prog, prog->globals.ip[o]))
813 //#define PRVM_G_FUNCTION(prog, o) (prog->globals.ip[o])
815 // FIXME: make these go away?
816 #define PRVM_E_FLOAT(e,o) (e->fields.fp[o])
817 #define PRVM_E_INT(e,o) (e->fields.ip[o])
818 //#define PRVM_E_VECTOR(e,o) (&(e->fields.fp[o]))
819 #define PRVM_E_STRING(e,o) (PRVM_GetString(prog, e->fields.ip[o]))
821 extern int prvm_type_size[8]; // for consistency : I think a goal of this sub-project is to
822 // make the new vm mostly independent from the old one, thus if it's necessary, I copy everything
824 void PRVM_Init_Exec(prvm_prog_t *prog);
826 void PRVM_ED_PrintEdicts_f (void);
827 void PRVM_ED_PrintNum (prvm_prog_t *prog, int ent, const char *wildcard_fieldname);
829 const char *PRVM_GetString(prvm_prog_t *prog, int num);
830 int PRVM_SetEngineString(prvm_prog_t *prog, const char *s);
831 const char *PRVM_ChangeEngineString(prvm_prog_t *prog, int i, const char *s);
832 int PRVM_SetTempString(prvm_prog_t *prog, const char *s);
833 int PRVM_AllocString(prvm_prog_t *prog, size_t bufferlength, char **pointer);
834 void PRVM_FreeString(prvm_prog_t *prog, int num);
836 ddef_t *PRVM_ED_FieldAtOfs(prvm_prog_t *prog, int ofs);
837 qboolean PRVM_ED_ParseEpair(prvm_prog_t *prog, prvm_edict_t *ent, ddef_t *key, const char *s, qboolean parsebackslash);
838 char *PRVM_UglyValueString(prvm_prog_t *prog, etype_t type, prvm_eval_t *val, char *line, size_t linelength);
839 char *PRVM_GlobalString(prvm_prog_t *prog, int ofs, char *line, size_t linelength);
840 char *PRVM_GlobalStringNoContents(prvm_prog_t *prog, int ofs, char *line, size_t linelength);
842 //============================================================================
846 Call InitProg with the num
847 Set up the fields marked with [INIT] in the prog struct
848 Load a program with LoadProgs
850 // Load expects to be called right after Reset
851 void PRVM_Prog_Init(prvm_prog_t *prog);
852 void PRVM_Prog_Load(prvm_prog_t *prog, const char *filename, unsigned char *data, fs_offset_t size, int numrequiredfunc, const char **required_func, int numrequiredfields, prvm_required_field_t *required_field, int numrequiredglobals, prvm_required_field_t *required_global);
853 void PRVM_Prog_Reset(prvm_prog_t *prog);
855 void PRVM_StackTrace(prvm_prog_t *prog);
856 void PRVM_Breakpoint(prvm_prog_t *prog, int stack_index, const char *text);
857 void PRVM_Watchpoint(prvm_prog_t *prog, int stack_index, const char *text, etype_t type, prvm_eval_t *o, prvm_eval_t *n);
859 void VM_Warning(prvm_prog_t *prog, const char *fmt, ...) DP_FUNC_PRINTF(2);
861 void VM_GenerateFrameGroupBlend(prvm_prog_t *prog, framegroupblend_t *framegroupblend, const prvm_edict_t *ed);
862 void VM_FrameBlendFromFrameGroupBlend(frameblend_t *frameblend, const framegroupblend_t *framegroupblend, const dp_model_t *model, double curtime);
863 void VM_UpdateEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed, const dp_model_t *edmodel, const frameblend_t *frameblend);
864 void VM_RemoveEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed);
866 void PRVM_ExplicitCoverageEvent(prvm_prog_t *prog, mfunction_t *func, int statement);