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.
27 static prvm_prog_t prog_list[PRVM_MAXPROGS];
29 int prvm_type_size[8] = {1,sizeof(string_t)/4,1,3,1,1,sizeof(func_t)/4,sizeof(void *)/4};
31 ddef_t *PRVM_ED_FieldAtOfs(int ofs);
32 qboolean PRVM_ED_ParseEpair(prvm_edict_t *ent, ddef_t *key, const char *s);
34 // LordHavoc: optional runtime bounds checking (speed drain, but worth it for security, on by default - breaks most QCCX features (used by CRMod and others))
35 cvar_t prvm_boundscheck = {0, "prvm_boundscheck", "1", "enables detection of out of bounds memory access in the QuakeC code being run (in other words, prevents really exceedingly bad QuakeC code from doing nasty things to your computer)"};
36 // LordHavoc: prints every opcode as it executes - warning: this is significant spew
37 cvar_t prvm_traceqc = {0, "prvm_traceqc", "0", "prints every QuakeC statement as it is executed (only for really thorough debugging!)"};
38 // LordHavoc: counts usage of each QuakeC statement
39 cvar_t prvm_statementprofiling = {0, "prvm_statementprofiling", "0", "counts how many times each QuakeC statement has been executed, these counts are displayed in prvm_printfunction output (if enabled)"};
41 extern sizebuf_t vm_tempstringsbuf;
43 //============================================================================
51 void PRVM_MEM_Alloc(void)
55 // reserve space for the null entity aka world
56 // check bound of max_edicts
57 prog->max_edicts = bound(1 + prog->reserved_edicts, prog->max_edicts, prog->limit_edicts);
58 prog->num_edicts = bound(1 + prog->reserved_edicts, prog->num_edicts, prog->max_edicts);
60 // edictprivate_size has to be min as big prvm_edict_private_t
61 prog->edictprivate_size = max(prog->edictprivate_size,(int)sizeof(prvm_edict_private_t));
64 prog->edicts = (prvm_edict_t *)Mem_Alloc(prog->progs_mempool,prog->limit_edicts * sizeof(prvm_edict_t));
66 // alloc edict private space
67 prog->edictprivate = Mem_Alloc(prog->progs_mempool, prog->max_edicts * prog->edictprivate_size);
70 prog->edictsfields = Mem_Alloc(prog->progs_mempool, prog->max_edicts * prog->edict_size);
73 for(i = 0; i < prog->max_edicts; i++)
75 prog->edicts[i].priv.required = (prvm_edict_private_t *)((unsigned char *)prog->edictprivate + i * prog->edictprivate_size);
76 prog->edicts[i].fields.vp = (void*)((unsigned char *)prog->edictsfields + i * prog->edict_size);
82 PRVM_MEM_IncreaseEdicts
85 void PRVM_MEM_IncreaseEdicts(void)
88 int oldmaxedicts = prog->max_edicts;
89 void *oldedictsfields = prog->edictsfields;
90 void *oldedictprivate = prog->edictprivate;
92 if(prog->max_edicts >= prog->limit_edicts)
95 PRVM_GCALL(begin_increase_edicts)();
98 prog->max_edicts = min(prog->max_edicts + 256, prog->limit_edicts);
100 prog->edictsfields = Mem_Alloc(prog->progs_mempool, prog->max_edicts * prog->edict_size);
101 prog->edictprivate = Mem_Alloc(prog->progs_mempool, prog->max_edicts * prog->edictprivate_size);
103 memcpy(prog->edictsfields, oldedictsfields, oldmaxedicts * prog->edict_size);
104 memcpy(prog->edictprivate, oldedictprivate, oldmaxedicts * prog->edictprivate_size);
106 //set e and v pointers
107 for(i = 0; i < prog->max_edicts; i++)
109 prog->edicts[i].priv.required = (prvm_edict_private_t *)((unsigned char *)prog->edictprivate + i * prog->edictprivate_size);
110 prog->edicts[i].fields.vp = (void*)((unsigned char *)prog->edictsfields + i * prog->edict_size);
113 PRVM_GCALL(end_increase_edicts)();
115 Mem_Free(oldedictsfields);
116 Mem_Free(oldedictprivate);
119 //============================================================================
122 int PRVM_ED_FindFieldOffset(const char *field)
125 d = PRVM_ED_FindField(field);
131 int PRVM_ED_FindGlobalOffset(const char *global)
134 d = PRVM_ED_FindGlobal(global);
140 func_t PRVM_ED_FindFunctionOffset(const char *function)
143 f = PRVM_ED_FindFunction(function);
146 return (func_t)(f - prog->functions);
149 qboolean PRVM_ProgLoaded(int prognr)
151 if(prognr < 0 || prognr >= PRVM_MAXPROGS)
154 return (prog_list[prognr].loaded ? TRUE : FALSE);
159 PRVM_SetProgFromString
162 // perhaps add a return value when the str doesnt exist
163 qboolean PRVM_SetProgFromString(const char *str)
166 for(; i < PRVM_MAXPROGS ; i++)
167 if(prog_list[i].name && !strcmp(prog_list[i].name,str))
169 if(prog_list[i].loaded)
171 prog = &prog_list[i];
176 Con_Printf("%s not loaded !\n",PRVM_NAME);
181 Con_Printf("Invalid program name %s !\n", str);
190 void PRVM_SetProg(int prognr)
192 if(0 <= prognr && prognr < PRVM_MAXPROGS)
194 if(prog_list[prognr].loaded)
195 prog = &prog_list[prognr];
197 PRVM_ERROR("%i not loaded !", prognr);
200 PRVM_ERROR("Invalid program number %i", prognr);
207 Sets everything to NULL
210 void PRVM_ED_ClearEdict (prvm_edict_t *e)
212 memset (e->fields.vp, 0, prog->progs->entityfields * 4);
213 e->priv.required->free = false;
215 // AK: Let the init_edict function determine if something needs to be initialized
216 PRVM_GCALL(init_edict)(e);
223 Either finds a free edict, or allocates a new one.
224 Try to avoid reusing an entity that was recently freed, because it
225 can cause the client to think the entity morphed into something else
226 instead of being removed and recreated, which can cause interpolated
227 angles and bad trails.
230 prvm_edict_t *PRVM_ED_Alloc (void)
235 // the client qc dont need maxclients
236 // thus it doesnt need to use svs.maxclients
237 // AK: changed i=svs.maxclients+1
238 // AK: changed so the edict 0 wont spawn -> used as reserved/world entity
239 // although the menu/client has no world
240 for (i = prog->reserved_edicts + 1;i < prog->num_edicts;i++)
242 e = PRVM_EDICT_NUM(i);
243 // the first couple seconds of server time can involve a lot of
244 // freeing and allocating, so relax the replacement policy
245 if (e->priv.required->free && ( e->priv.required->freetime < 2 || prog->globaloffsets.time < 0 || (PRVM_GLOBALFIELDVALUE(prog->globaloffsets.time)->_float - e->priv.required->freetime) > 0.5 ) )
247 PRVM_ED_ClearEdict (e);
252 if (i == prog->limit_edicts)
253 PRVM_ERROR ("%s: PRVM_ED_Alloc: no free edicts",PRVM_NAME);
256 if (prog->num_edicts >= prog->max_edicts)
257 PRVM_MEM_IncreaseEdicts();
259 e = PRVM_EDICT_NUM(i);
260 PRVM_ED_ClearEdict (e);
269 Marks the edict as free
270 FIXME: walk all entities and NULL out references to this entity
273 void PRVM_ED_Free (prvm_edict_t *ed)
275 // dont delete the null entity (world) or reserved edicts
276 if(PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
279 PRVM_GCALL(free_edict)(ed);
281 ed->priv.required->free = true;
282 ed->priv.required->freetime = prog->globaloffsets.time >= 0 ? PRVM_GLOBALFIELDVALUE(prog->globaloffsets.time)->_float : 0;
285 //===========================================================================
292 ddef_t *PRVM_ED_GlobalAtOfs (int ofs)
297 for (i=0 ; i<prog->progs->numglobaldefs ; i++)
299 def = &prog->globaldefs[i];
311 ddef_t *PRVM_ED_FieldAtOfs (int ofs)
316 for (i=0 ; i<prog->progs->numfielddefs ; i++)
318 def = &prog->fielddefs[i];
330 ddef_t *PRVM_ED_FindField (const char *name)
335 for (i=0 ; i<prog->progs->numfielddefs ; i++)
337 def = &prog->fielddefs[i];
338 if (!strcmp(PRVM_GetString(def->s_name), name))
349 ddef_t *PRVM_ED_FindGlobal (const char *name)
354 for (i=0 ; i<prog->progs->numglobaldefs ; i++)
356 def = &prog->globaldefs[i];
357 if (!strcmp(PRVM_GetString(def->s_name), name))
369 mfunction_t *PRVM_ED_FindFunction (const char *name)
374 for (i=0 ; i<prog->progs->numfunctions ; i++)
376 func = &prog->functions[i];
377 if (!strcmp(PRVM_GetString(func->s_name), name))
388 Returns a string describing *data in a type specific manner
391 char *PRVM_ValueString (etype_t type, prvm_eval_t *val)
393 static char line[MAX_INPUTLINE];
398 type = (etype_t)((int) type & ~DEF_SAVEGLOBAL);
403 strlcpy (line, PRVM_GetString (val->string), sizeof (line));
407 if (n < 0 || n >= prog->limit_edicts)
408 sprintf (line, "entity %i (invalid!)", n);
410 sprintf (line, "entity %i", n);
413 f = prog->functions + val->function;
414 sprintf (line, "%s()", PRVM_GetString(f->s_name));
417 def = PRVM_ED_FieldAtOfs ( val->_int );
418 sprintf (line, ".%s", PRVM_GetString(def->s_name));
421 sprintf (line, "void");
424 // LordHavoc: changed from %5.1f to %10.4f
425 sprintf (line, "%10.4f", val->_float);
428 // LordHavoc: changed from %5.1f to %10.4f
429 sprintf (line, "'%10.4f %10.4f %10.4f'", val->vector[0], val->vector[1], val->vector[2]);
432 sprintf (line, "pointer");
435 sprintf (line, "bad type %i", (int) type);
446 Returns a string describing *data in a type specific manner
447 Easier to parse than PR_ValueString
450 char *PRVM_UglyValueString (etype_t type, prvm_eval_t *val)
452 static char line[MAX_INPUTLINE];
458 type = (etype_t)((int)type & ~DEF_SAVEGLOBAL);
463 // Parse the string a bit to turn special characters
464 // (like newline, specifically) into escape codes,
465 // this fixes saving games from various mods
466 s = PRVM_GetString (val->string);
467 for (i = 0;i < (int)sizeof(line) - 2 && *s;)
486 dpsnprintf (line, sizeof (line), "%i", PRVM_NUM_FOR_EDICT(PRVM_PROG_TO_EDICT(val->edict)));
489 f = prog->functions + val->function;
490 strlcpy (line, PRVM_GetString (f->s_name), sizeof (line));
493 def = PRVM_ED_FieldAtOfs ( val->_int );
494 dpsnprintf (line, sizeof (line), ".%s", PRVM_GetString(def->s_name));
497 dpsnprintf (line, sizeof (line), "void");
500 dpsnprintf (line, sizeof (line), "%f", val->_float);
503 dpsnprintf (line, sizeof (line), "%f %f %f", val->vector[0], val->vector[1], val->vector[2]);
506 dpsnprintf (line, sizeof (line), "bad type %i", type);
517 Returns a string with a description and the contents of a global,
518 padded to 20 field width
521 char *PRVM_GlobalString (int ofs)
527 static char line[128];
529 val = (void *)&prog->globals.generic[ofs];
530 def = PRVM_ED_GlobalAtOfs(ofs);
532 sprintf (line,"GLOBAL%i", ofs);
535 s = PRVM_ValueString ((etype_t)def->type, (prvm_eval_t *)val);
536 sprintf (line,"%s (=%s)", PRVM_GetString(def->s_name), s);
540 //for ( ; i<20 ; i++)
541 // strcat (line," ");
547 char *PRVM_GlobalStringNoContents (int ofs)
551 static char line[128];
553 def = PRVM_ED_GlobalAtOfs(ofs);
555 sprintf (line,"GLOBAL%i", ofs);
557 sprintf (line,"%s", PRVM_GetString(def->s_name));
560 //for ( ; i<20 ; i++)
561 // strcat (line," ");
575 // LordHavoc: optimized this to print out much more quickly (tempstring)
576 // LordHavoc: changed to print out every 4096 characters (incase there are a lot of fields to print)
577 void PRVM_ED_Print(prvm_edict_t *ed, const char *wildcard_fieldname)
585 char tempstring[MAX_INPUTLINE], tempstring2[260]; // temporary string buffers
587 if (ed->priv.required->free)
589 Con_Printf("%s: FREE\n",PRVM_NAME);
594 sprintf(tempstring, "\n%s EDICT %i:\n", PRVM_NAME, PRVM_NUM_FOR_EDICT(ed));
595 for (i=1 ; i<prog->progs->numfielddefs ; i++)
597 d = &prog->fielddefs[i];
598 name = PRVM_GetString(d->s_name);
599 if (name[strlen(name)-2] == '_')
600 continue; // skip _x, _y, _z vars
602 // Check Field Name Wildcard
603 if(wildcard_fieldname)
604 if( !matchpattern(name, wildcard_fieldname, 1) )
605 // Didn't match; skip
608 v = (int *)((char *)ed->fields.vp + d->ofs*4);
610 // if the value is still all 0, skip the field
611 type = d->type & ~DEF_SAVEGLOBAL;
613 for (j=0 ; j<prvm_type_size[type] ; j++)
616 if (j == prvm_type_size[type])
619 if (strlen(name) > sizeof(tempstring2)-4)
621 memcpy (tempstring2, name, sizeof(tempstring2)-4);
622 tempstring2[sizeof(tempstring2)-4] = tempstring2[sizeof(tempstring2)-3] = tempstring2[sizeof(tempstring2)-2] = '.';
623 tempstring2[sizeof(tempstring2)-1] = 0;
626 strlcat(tempstring, name, sizeof(tempstring));
627 for (l = strlen(name);l < 14;l++)
628 strlcat(tempstring, " ", sizeof(tempstring));
629 strlcat(tempstring, " ", sizeof(tempstring));
631 name = PRVM_ValueString((etype_t)d->type, (prvm_eval_t *)v);
632 if (strlen(name) > sizeof(tempstring2)-4)
634 memcpy (tempstring2, name, sizeof(tempstring2)-4);
635 tempstring2[sizeof(tempstring2)-4] = tempstring2[sizeof(tempstring2)-3] = tempstring2[sizeof(tempstring2)-2] = '.';
636 tempstring2[sizeof(tempstring2)-1] = 0;
639 strlcat(tempstring, name, sizeof(tempstring));
640 strlcat(tempstring, "\n", sizeof(tempstring));
641 if (strlen(tempstring) >= sizeof(tempstring)/2)
643 Con_Print(tempstring);
648 Con_Print(tempstring);
658 void PRVM_ED_Write (qfile_t *f, prvm_edict_t *ed)
668 if (ed->priv.required->free)
674 for (i=1 ; i<prog->progs->numfielddefs ; i++)
676 d = &prog->fielddefs[i];
677 name = PRVM_GetString(d->s_name);
678 if (name[strlen(name)-2] == '_')
679 continue; // skip _x, _y, _z vars
681 v = (int *)((char *)ed->fields.vp + d->ofs*4);
683 // if the value is still all 0, skip the field
684 type = d->type & ~DEF_SAVEGLOBAL;
685 for (j=0 ; j<prvm_type_size[type] ; j++)
688 if (j == prvm_type_size[type])
691 FS_Printf(f,"\"%s\" ",name);
692 FS_Printf(f,"\"%s\"\n", PRVM_UglyValueString((etype_t)d->type, (prvm_eval_t *)v));
698 void PRVM_ED_PrintNum (int ent, const char *wildcard_fieldname)
700 PRVM_ED_Print(PRVM_EDICT_NUM(ent), wildcard_fieldname);
705 PRVM_ED_PrintEdicts_f
707 For debugging, prints all the entities in the current server
710 void PRVM_ED_PrintEdicts_f (void)
713 const char *wildcard_fieldname;
715 if(Cmd_Argc() < 2 || Cmd_Argc() > 3)
717 Con_Print("prvm_edicts <program name> <optional field name wildcard>\n");
722 if(!PRVM_SetProgFromString(Cmd_Argv(1)))
726 wildcard_fieldname = Cmd_Argv(2);
728 wildcard_fieldname = NULL;
730 Con_Printf("%s: %i entities\n", PRVM_NAME, prog->num_edicts);
731 for (i=0 ; i<prog->num_edicts ; i++)
732 PRVM_ED_PrintNum (i, wildcard_fieldname);
741 For debugging, prints a single edict
744 void PRVM_ED_PrintEdict_f (void)
747 const char *wildcard_fieldname;
749 if(Cmd_Argc() < 3 || Cmd_Argc() > 4)
751 Con_Print("prvm_edict <program name> <edict number> <optional field name wildcard>\n");
756 if(!PRVM_SetProgFromString(Cmd_Argv(1)))
759 i = atoi (Cmd_Argv(2));
760 if (i >= prog->num_edicts)
762 Con_Print("Bad edict number\n");
767 // Optional Wildcard Provided
768 wildcard_fieldname = Cmd_Argv(3);
771 wildcard_fieldname = NULL;
772 PRVM_ED_PrintNum (i, wildcard_fieldname);
784 // 2 possibilities : 1. just displaying the active edict count
785 // 2. making a function pointer [x]
786 void PRVM_ED_Count_f (void)
794 Con_Print("prvm_count <program name>\n");
799 if(!PRVM_SetProgFromString(Cmd_Argv(1)))
802 if(prog->count_edicts)
803 prog->count_edicts();
807 for (i=0 ; i<prog->num_edicts ; i++)
809 ent = PRVM_EDICT_NUM(i);
810 if (ent->priv.required->free)
815 Con_Printf("num_edicts:%3i\n", prog->num_edicts);
816 Con_Printf("active :%3i\n", active);
823 ==============================================================================
827 FIXME: need to tag constants, doesn't really work
828 ==============================================================================
836 void PRVM_ED_WriteGlobals (qfile_t *f)
844 for (i=0 ; i<prog->progs->numglobaldefs ; i++)
846 def = &prog->globaldefs[i];
848 if ( !(def->type & DEF_SAVEGLOBAL) )
850 type &= ~DEF_SAVEGLOBAL;
852 if (type != ev_string && type != ev_float && type != ev_entity)
855 name = PRVM_GetString(def->s_name);
856 FS_Printf(f,"\"%s\" ", name);
857 FS_Printf(f,"\"%s\"\n", PRVM_UglyValueString((etype_t)type, (prvm_eval_t *)&prog->globals.generic[def->ofs]));
867 void PRVM_ED_ParseGlobals (const char *data)
869 char keyname[MAX_INPUTLINE];
875 if (!COM_ParseToken_Simple(&data, false))
876 PRVM_ERROR ("PRVM_ED_ParseGlobals: EOF without closing brace");
877 if (com_token[0] == '}')
880 strlcpy (keyname, com_token, sizeof(keyname));
883 if (!COM_ParseToken_Simple(&data, false))
884 PRVM_ERROR ("PRVM_ED_ParseGlobals: EOF without closing brace");
886 if (com_token[0] == '}')
887 PRVM_ERROR ("PRVM_ED_ParseGlobals: closing brace without data");
889 key = PRVM_ED_FindGlobal (keyname);
892 Con_DPrintf("'%s' is not a global on %s\n", keyname, PRVM_NAME);
896 if (!PRVM_ED_ParseEpair(NULL, key, com_token))
897 PRVM_ERROR ("PRVM_ED_ParseGlobals: parse error");
901 //============================================================================
908 Can parse either fields or globals
909 returns false if error
912 qboolean PRVM_ED_ParseEpair(prvm_edict_t *ent, ddef_t *key, const char *s)
921 val = (prvm_eval_t *)((int *)ent->fields.vp + key->ofs);
923 val = (prvm_eval_t *)((int *)prog->globals.generic + key->ofs);
924 switch (key->type & ~DEF_SAVEGLOBAL)
927 l = (int)strlen(s) + 1;
928 val->string = PRVM_AllocString(l, &new_p);
929 for (i = 0;i < l;i++)
931 if (s[i] == '\\' && i < l-1)
936 else if (s[i] == 'r')
947 while (*s && *s <= ' ')
949 val->_float = atof(s);
953 for (i = 0;i < 3;i++)
955 while (*s && *s <= ' ')
959 val->vector[i] = atof(s);
968 while (*s && *s <= ' ')
971 if (i >= prog->limit_edicts)
972 Con_Printf("PRVM_ED_ParseEpair: ev_entity reference too large (edict %u >= MAX_EDICTS %u) on %s\n", (unsigned int)i, (unsigned int)MAX_EDICTS, PRVM_NAME);
973 while (i >= prog->max_edicts)
974 PRVM_MEM_IncreaseEdicts();
975 // if IncreaseEdicts was called the base pointer needs to be updated
977 val = (prvm_eval_t *)((int *)ent->fields.vp + key->ofs);
978 val->edict = PRVM_EDICT_TO_PROG(PRVM_EDICT_NUM((int)i));
982 def = PRVM_ED_FindField(s);
985 Con_DPrintf("PRVM_ED_ParseEpair: Can't find field %s in %s\n", s, PRVM_NAME);
988 val->_int = def->ofs;
992 func = PRVM_ED_FindFunction(s);
995 Con_Printf("PRVM_ED_ParseEpair: Can't find function %s in %s\n", s, PRVM_NAME);
998 val->function = func - prog->functions;
1002 Con_Printf("PRVM_ED_ParseEpair: Unknown key->type %i for key \"%s\" on %s\n", key->type, PRVM_GetString(key->s_name), PRVM_NAME);
1012 Console command to send a string to QC function GameCommand of the
1016 sv_cmd adminmsg 3 "do not teamkill"
1017 cl_cmd someclientcommand
1018 menu_cmd somemenucommand
1020 All progs can support this extension; sg calls it in server QC, cg in client
1024 void PRVM_GameCommand(const char *whichprogs, const char *whichcmd)
1028 Con_Printf("%s text...\n", whichcmd);
1033 if(!PRVM_SetProgFromString(whichprogs))
1034 // note: this is not PRVM_SetProg because that one aborts "hard" using PRVM_Error
1035 // also, it makes printing error messages easier!
1037 Con_Printf("%s program not loaded.\n", whichprogs);
1041 if(!prog->funcoffsets.GameCommand)
1043 Con_Printf("%s program do not support GameCommand!\n", whichprogs);
1047 int restorevm_tempstringsbuf_cursize;
1052 restorevm_tempstringsbuf_cursize = vm_tempstringsbuf.cursize;
1053 PRVM_G_INT(OFS_PARM0) = PRVM_SetTempString(s ? s : "");
1054 PRVM_ExecuteProgram (prog->funcoffsets.GameCommand, "QC function GameCommand is missing");
1055 vm_tempstringsbuf.cursize = restorevm_tempstringsbuf_cursize;
1060 void PRVM_GameCommand_Server_f(void)
1062 PRVM_GameCommand("server", "sv_cmd");
1064 void PRVM_GameCommand_Client_f(void)
1066 PRVM_GameCommand("client", "cl_cmd");
1068 void PRVM_GameCommand_Menu_f(void)
1070 PRVM_GameCommand("menu", "menu_cmd");
1077 Console command to set a field of a specified edict
1080 void PRVM_ED_EdictSet_f(void)
1087 Con_Print("prvm_edictset <program name> <edict number> <field> <value>\n");
1092 if(!PRVM_SetProgFromString(Cmd_Argv(1)))
1094 Con_Printf("Wrong program name %s !\n", Cmd_Argv(1));
1098 ed = PRVM_EDICT_NUM(atoi(Cmd_Argv(2)));
1100 if((key = PRVM_ED_FindField(Cmd_Argv(3))) == 0)
1101 Con_Printf("Key %s not found !\n", Cmd_Argv(3));
1103 PRVM_ED_ParseEpair(ed, key, Cmd_Argv(4));
1109 ====================
1112 Parses an edict out of the given string, returning the new position
1113 ed should be a properly initialized empty edict.
1114 Used for initial level load and for savegames.
1115 ====================
1117 extern cvar_t developer_entityparsing;
1118 const char *PRVM_ED_ParseEdict (const char *data, prvm_edict_t *ent)
1128 // go through all the dictionary pairs
1132 if (!COM_ParseToken_Simple(&data, false))
1133 PRVM_ERROR ("PRVM_ED_ParseEdict: EOF without closing brace");
1134 if (developer_entityparsing.integer)
1135 Con_Printf("Key: \"%s\"", com_token);
1136 if (com_token[0] == '}')
1139 // anglehack is to allow QuakeEd to write single scalar angles
1140 // and allow them to be turned into vectors. (FIXME...)
1141 if (!strcmp(com_token, "angle"))
1143 strlcpy (com_token, "angles", sizeof(com_token));
1149 // FIXME: change light to _light to get rid of this hack
1150 if (!strcmp(com_token, "light"))
1151 strlcpy (com_token, "light_lev", sizeof(com_token)); // hack for single light def
1153 strlcpy (keyname, com_token, sizeof(keyname));
1155 // another hack to fix keynames with trailing spaces
1156 n = strlen(keyname);
1157 while (n && keyname[n-1] == ' ')
1164 if (!COM_ParseToken_Simple(&data, false))
1165 PRVM_ERROR ("PRVM_ED_ParseEdict: EOF without closing brace");
1166 if (developer_entityparsing.integer)
1167 Con_Printf(" \"%s\"\n", com_token);
1169 if (com_token[0] == '}')
1170 PRVM_ERROR ("PRVM_ED_ParseEdict: closing brace without data");
1174 // ignore attempts to set key "" (this problem occurs in nehahra neh1m8.bsp)
1178 // keynames with a leading underscore are used for utility comments,
1179 // and are immediately discarded by quake
1180 if (keyname[0] == '_')
1183 key = PRVM_ED_FindField (keyname);
1186 Con_DPrintf("%s: '%s' is not a field\n", PRVM_NAME, keyname);
1193 strlcpy (temp, com_token, sizeof(temp));
1194 sprintf (com_token, "0 %s 0", temp);
1197 if (!PRVM_ED_ParseEpair(ent, key, com_token))
1198 PRVM_ERROR ("PRVM_ED_ParseEdict: parse error");
1202 ent->priv.required->free = true;
1210 PRVM_ED_LoadFromFile
1212 The entities are directly placed in the array, rather than allocated with
1213 PRVM_ED_Alloc, because otherwise an error loading the map would have entity
1214 number references out of order.
1216 Creates a server's entity / program execution context by
1217 parsing textual entity definitions out of an ent file.
1219 Used for both fresh maps and savegame loads. A fresh map would also need
1220 to call PRVM_ED_CallSpawnFunctions () to let the objects initialize themselves.
1223 void PRVM_ED_LoadFromFile (const char *data)
1226 int parsed, inhibited, spawned, died;
1238 // parse the opening brace
1239 if (!COM_ParseToken_Simple(&data, false))
1241 if (com_token[0] != '{')
1242 PRVM_ERROR ("PRVM_ED_LoadFromFile: %s: found %s when expecting {", PRVM_NAME, com_token);
1244 // CHANGED: this is not conform to PR_LoadFromFile
1245 if(prog->loadintoworld)
1247 prog->loadintoworld = false;
1248 ent = PRVM_EDICT_NUM(0);
1251 ent = PRVM_ED_Alloc();
1254 if (ent != prog->edicts) // hack
1255 memset (ent->fields.vp, 0, prog->progs->entityfields * 4);
1257 data = PRVM_ED_ParseEdict (data, ent);
1260 // remove the entity ?
1261 if(prog->load_edict && !prog->load_edict(ent))
1269 // immediately call spawn function, but only if there is a self global and a classname
1271 if(prog->globaloffsets.self >= 0 && prog->fieldoffsets.classname >= 0)
1273 string_t handle = PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.classname)->string;
1276 Con_Print("No classname for:\n");
1277 PRVM_ED_Print(ent, NULL);
1282 // look for the spawn function
1283 func = PRVM_ED_FindFunction (PRVM_GetString(handle));
1287 if (developer.integer) // don't confuse non-developers with errors
1289 Con_Print("No spawn function for:\n");
1290 PRVM_ED_Print(ent, NULL);
1297 PRVM_GLOBALFIELDVALUE(prog->globaloffsets.self)->edict = PRVM_EDICT_TO_PROG(ent);
1298 PRVM_ExecuteProgram (func - prog->functions, "");
1302 if (ent->priv.required->free)
1306 Con_DPrintf("%s: %i new entities parsed, %i new inhibited, %i (%i new) spawned (whereas %i removed self, %i stayed)\n", PRVM_NAME, parsed, inhibited, prog->num_edicts, spawned, died, spawned - died);
1309 void PRVM_FindOffsets(void)
1311 // field and global searches use -1 for NULL
1312 memset(&prog->fieldoffsets, -1, sizeof(prog->fieldoffsets));
1313 memset(&prog->globaloffsets, -1, sizeof(prog->globaloffsets));
1314 // functions use 0 for NULL
1315 memset(&prog->funcoffsets, 0, sizeof(prog->funcoffsets));
1317 // server and client qc use a lot of similar fields, so this is combined
1318 prog->fieldoffsets.SendEntity = PRVM_ED_FindFieldOffset("SendEntity");
1319 prog->fieldoffsets.Version = PRVM_ED_FindFieldOffset("Version");
1320 prog->fieldoffsets.alpha = PRVM_ED_FindFieldOffset("alpha");
1321 prog->fieldoffsets.ammo_cells1 = PRVM_ED_FindFieldOffset("ammo_cells1");
1322 prog->fieldoffsets.ammo_lava_nails = PRVM_ED_FindFieldOffset("ammo_lava_nails");
1323 prog->fieldoffsets.ammo_multi_rockets = PRVM_ED_FindFieldOffset("ammo_multi_rockets");
1324 prog->fieldoffsets.ammo_nails1 = PRVM_ED_FindFieldOffset("ammo_nails1");
1325 prog->fieldoffsets.ammo_plasma = PRVM_ED_FindFieldOffset("ammo_plasma");
1326 prog->fieldoffsets.ammo_rockets1 = PRVM_ED_FindFieldOffset("ammo_rockets1");
1327 prog->fieldoffsets.ammo_shells1 = PRVM_ED_FindFieldOffset("ammo_shells1");
1328 prog->fieldoffsets.angles = PRVM_ED_FindFieldOffset("angles");
1329 prog->fieldoffsets.button3 = PRVM_ED_FindFieldOffset("button3");
1330 prog->fieldoffsets.button4 = PRVM_ED_FindFieldOffset("button4");
1331 prog->fieldoffsets.button5 = PRVM_ED_FindFieldOffset("button5");
1332 prog->fieldoffsets.button6 = PRVM_ED_FindFieldOffset("button6");
1333 prog->fieldoffsets.button7 = PRVM_ED_FindFieldOffset("button7");
1334 prog->fieldoffsets.button8 = PRVM_ED_FindFieldOffset("button8");
1335 prog->fieldoffsets.button9 = PRVM_ED_FindFieldOffset("button9");
1336 prog->fieldoffsets.button10 = PRVM_ED_FindFieldOffset("button10");
1337 prog->fieldoffsets.button11 = PRVM_ED_FindFieldOffset("button11");
1338 prog->fieldoffsets.button12 = PRVM_ED_FindFieldOffset("button12");
1339 prog->fieldoffsets.button13 = PRVM_ED_FindFieldOffset("button13");
1340 prog->fieldoffsets.button14 = PRVM_ED_FindFieldOffset("button14");
1341 prog->fieldoffsets.button15 = PRVM_ED_FindFieldOffset("button15");
1342 prog->fieldoffsets.button16 = PRVM_ED_FindFieldOffset("button16");
1343 prog->fieldoffsets.buttonchat = PRVM_ED_FindFieldOffset("buttonchat");
1344 prog->fieldoffsets.buttonuse = PRVM_ED_FindFieldOffset("buttonuse");
1345 prog->fieldoffsets.chain = PRVM_ED_FindFieldOffset("chain");
1346 prog->fieldoffsets.classname = PRVM_ED_FindFieldOffset("classname");
1347 prog->fieldoffsets.clientcolors = PRVM_ED_FindFieldOffset("clientcolors");
1348 prog->fieldoffsets.color = PRVM_ED_FindFieldOffset("color");
1349 prog->fieldoffsets.colormod = PRVM_ED_FindFieldOffset("colormod");
1350 prog->fieldoffsets.contentstransition = PRVM_ED_FindFieldOffset("contentstransition");
1351 prog->fieldoffsets.cursor_active = PRVM_ED_FindFieldOffset("cursor_active");
1352 prog->fieldoffsets.cursor_screen = PRVM_ED_FindFieldOffset("cursor_screen");
1353 prog->fieldoffsets.cursor_trace_endpos = PRVM_ED_FindFieldOffset("cursor_trace_endpos");
1354 prog->fieldoffsets.cursor_trace_ent = PRVM_ED_FindFieldOffset("cursor_trace_ent");
1355 prog->fieldoffsets.cursor_trace_start = PRVM_ED_FindFieldOffset("cursor_trace_start");
1356 prog->fieldoffsets.customizeentityforclient = PRVM_ED_FindFieldOffset("customizeentityforclient");
1357 prog->fieldoffsets.dimension_hit = PRVM_ED_FindFieldOffset("dimension_hit");
1358 prog->fieldoffsets.dimension_solid = PRVM_ED_FindFieldOffset("dimension_solid");
1359 prog->fieldoffsets.disableclientprediction = PRVM_ED_FindFieldOffset("disableclientprediction");
1360 prog->fieldoffsets.dphitcontentsmask = PRVM_ED_FindFieldOffset("dphitcontentsmask");
1361 prog->fieldoffsets.drawonlytoclient = PRVM_ED_FindFieldOffset("drawonlytoclient");
1362 prog->fieldoffsets.exteriormodeltoclient = PRVM_ED_FindFieldOffset("exteriormodeltoclient");
1363 prog->fieldoffsets.fatness = PRVM_ED_FindFieldOffset("fatness");
1364 prog->fieldoffsets.forceshader = PRVM_ED_FindFieldOffset("forceshader");
1365 prog->fieldoffsets.frame = PRVM_ED_FindFieldOffset("frame");
1366 prog->fieldoffsets.frame1time = PRVM_ED_FindFieldOffset("frame1time");
1367 prog->fieldoffsets.frame2 = PRVM_ED_FindFieldOffset("frame2");
1368 prog->fieldoffsets.frame2time = PRVM_ED_FindFieldOffset("frame2time");
1369 prog->fieldoffsets.fullbright = PRVM_ED_FindFieldOffset("fullbright");
1370 prog->fieldoffsets.glow_color = PRVM_ED_FindFieldOffset("glow_color");
1371 prog->fieldoffsets.glow_size = PRVM_ED_FindFieldOffset("glow_size");
1372 prog->fieldoffsets.glow_trail = PRVM_ED_FindFieldOffset("glow_trail");
1373 prog->fieldoffsets.gravity = PRVM_ED_FindFieldOffset("gravity");
1374 prog->fieldoffsets.groundentity = PRVM_ED_FindFieldOffset("groundentity");
1375 prog->fieldoffsets.hull = PRVM_ED_FindFieldOffset("hull");
1376 prog->fieldoffsets.ideal_yaw = PRVM_ED_FindFieldOffset("ideal_yaw");
1377 prog->fieldoffsets.idealpitch = PRVM_ED_FindFieldOffset("idealpitch");
1378 prog->fieldoffsets.items2 = PRVM_ED_FindFieldOffset("items2");
1379 prog->fieldoffsets.lerpfrac = PRVM_ED_FindFieldOffset("lerpfrac");
1380 prog->fieldoffsets.light_lev = PRVM_ED_FindFieldOffset("light_lev");
1381 prog->fieldoffsets.message = PRVM_ED_FindFieldOffset("message");
1382 prog->fieldoffsets.modelflags = PRVM_ED_FindFieldOffset("modelflags");
1383 prog->fieldoffsets.movement = PRVM_ED_FindFieldOffset("movement");
1384 prog->fieldoffsets.netaddress = PRVM_ED_FindFieldOffset("netaddress");
1385 prog->fieldoffsets.nextthink = PRVM_ED_FindFieldOffset("nextthink");
1386 prog->fieldoffsets.nodrawtoclient = PRVM_ED_FindFieldOffset("nodrawtoclient");
1387 prog->fieldoffsets.pflags = PRVM_ED_FindFieldOffset("pflags");
1388 prog->fieldoffsets.ping = PRVM_ED_FindFieldOffset("ping");
1389 prog->fieldoffsets.pitch_speed = PRVM_ED_FindFieldOffset("pitch_speed");
1390 prog->fieldoffsets.playermodel = PRVM_ED_FindFieldOffset("playermodel");
1391 prog->fieldoffsets.playerskin = PRVM_ED_FindFieldOffset("playerskin");
1392 prog->fieldoffsets.pmodel = PRVM_ED_FindFieldOffset("pmodel");
1393 prog->fieldoffsets.punchvector = PRVM_ED_FindFieldOffset("punchvector");
1394 prog->fieldoffsets.renderamt = PRVM_ED_FindFieldOffset("renderamt"); // HalfLife support
1395 prog->fieldoffsets.renderflags = PRVM_ED_FindFieldOffset("renderflags");
1396 prog->fieldoffsets.rendermode = PRVM_ED_FindFieldOffset("rendermode"); // HalfLife support
1397 prog->fieldoffsets.scale = PRVM_ED_FindFieldOffset("scale");
1398 prog->fieldoffsets.style = PRVM_ED_FindFieldOffset("style");
1399 prog->fieldoffsets.tag_entity = PRVM_ED_FindFieldOffset("tag_entity");
1400 prog->fieldoffsets.tag_index = PRVM_ED_FindFieldOffset("tag_index");
1401 prog->fieldoffsets.think = PRVM_ED_FindFieldOffset("think");
1402 prog->fieldoffsets.viewmodelforclient = PRVM_ED_FindFieldOffset("viewmodelforclient");
1403 prog->fieldoffsets.viewzoom = PRVM_ED_FindFieldOffset("viewzoom");
1404 prog->fieldoffsets.yaw_speed = PRVM_ED_FindFieldOffset("yaw_speed");
1405 prog->funcoffsets.CSQC_ConsoleCommand = PRVM_ED_FindFunctionOffset("CSQC_ConsoleCommand");
1406 prog->funcoffsets.CSQC_Ent_Remove = PRVM_ED_FindFunctionOffset("CSQC_Ent_Remove");
1407 prog->funcoffsets.CSQC_Ent_Update = PRVM_ED_FindFunctionOffset("CSQC_Ent_Update");
1408 prog->funcoffsets.CSQC_Event = PRVM_ED_FindFunctionOffset("CSQC_Event");
1409 prog->funcoffsets.CSQC_Init = PRVM_ED_FindFunctionOffset("CSQC_Init");
1410 prog->funcoffsets.CSQC_InputEvent = PRVM_ED_FindFunctionOffset("CSQC_InputEvent");
1411 prog->funcoffsets.CSQC_Parse_CenterPrint = PRVM_ED_FindFunctionOffset("CSQC_Parse_CenterPrint");
1412 prog->funcoffsets.CSQC_Parse_Print = PRVM_ED_FindFunctionOffset("CSQC_Parse_Print");
1413 prog->funcoffsets.CSQC_Parse_StuffCmd = PRVM_ED_FindFunctionOffset("CSQC_Parse_StuffCmd");
1414 prog->funcoffsets.CSQC_Parse_TempEntity = PRVM_ED_FindFunctionOffset("CSQC_Parse_TempEntity");
1415 prog->funcoffsets.CSQC_Shutdown = PRVM_ED_FindFunctionOffset("CSQC_Shutdown");
1416 prog->funcoffsets.CSQC_UpdateView = PRVM_ED_FindFunctionOffset("CSQC_UpdateView");
1417 prog->funcoffsets.EndFrame = PRVM_ED_FindFunctionOffset("EndFrame");
1418 prog->funcoffsets.RestoreGame = PRVM_ED_FindFunctionOffset("RestoreGame");
1419 prog->funcoffsets.SV_ChangeTeam = PRVM_ED_FindFunctionOffset("SV_ChangeTeam");
1420 prog->funcoffsets.SV_ParseClientCommand = PRVM_ED_FindFunctionOffset("SV_ParseClientCommand");
1421 prog->funcoffsets.SV_PlayerPhysics = PRVM_ED_FindFunctionOffset("SV_PlayerPhysics");
1422 prog->funcoffsets.GameCommand = PRVM_ED_FindFunctionOffset("GameCommand");
1423 prog->globaloffsets.SV_InitCmd = PRVM_ED_FindGlobalOffset("SV_InitCmd");
1424 prog->globaloffsets.self = PRVM_ED_FindGlobalOffset("self");
1425 prog->globaloffsets.time = PRVM_ED_FindGlobalOffset("time");
1426 prog->globaloffsets.v_forward = PRVM_ED_FindGlobalOffset("v_forward");
1427 prog->globaloffsets.v_right = PRVM_ED_FindGlobalOffset("v_right");
1428 prog->globaloffsets.v_up = PRVM_ED_FindGlobalOffset("v_up");
1429 prog->globaloffsets.view_angles = PRVM_ED_FindGlobalOffset("view_angles");
1430 prog->globaloffsets.trace_allsolid = PRVM_ED_FindGlobalOffset("trace_allsolid");
1431 prog->globaloffsets.trace_startsolid = PRVM_ED_FindGlobalOffset("trace_startsolid");
1432 prog->globaloffsets.trace_fraction = PRVM_ED_FindGlobalOffset("trace_fraction");
1433 prog->globaloffsets.trace_inwater = PRVM_ED_FindGlobalOffset("trace_inwater");
1434 prog->globaloffsets.trace_inopen = PRVM_ED_FindGlobalOffset("trace_inopen");
1435 prog->globaloffsets.trace_endpos = PRVM_ED_FindGlobalOffset("trace_endpos");
1436 prog->globaloffsets.trace_plane_normal = PRVM_ED_FindGlobalOffset("trace_plane_normal");
1437 prog->globaloffsets.trace_plane_dist = PRVM_ED_FindGlobalOffset("trace_plane_dist");
1438 prog->globaloffsets.trace_ent = PRVM_ED_FindGlobalOffset("trace_ent");
1439 prog->globaloffsets.trace_dphitcontents = PRVM_ED_FindGlobalOffset("trace_dphitcontents");
1440 prog->globaloffsets.trace_dphitq3surfaceflags = PRVM_ED_FindGlobalOffset("trace_dphitq3surfaceflags");
1441 prog->globaloffsets.trace_dphittexturename = PRVM_ED_FindGlobalOffset("trace_dphittexturename");
1442 prog->globaloffsets.trace_dpstartcontents = PRVM_ED_FindGlobalOffset("trace_dpstartcontents");
1443 prog->globaloffsets.intermission = PRVM_ED_FindGlobalOffset("intermission");
1444 prog->globaloffsets.coop = PRVM_ED_FindGlobalOffset("coop");
1445 prog->globaloffsets.deathmatch = PRVM_ED_FindGlobalOffset("deathmatch");
1447 // menu qc only uses some functions, nothing else
1448 prog->funcoffsets.m_display = PRVM_ED_FindFunctionOffset("m_display");
1449 prog->funcoffsets.m_draw = PRVM_ED_FindFunctionOffset("m_draw");
1450 prog->funcoffsets.m_hide = PRVM_ED_FindFunctionOffset("m_hide");
1451 prog->funcoffsets.m_init = PRVM_ED_FindFunctionOffset("m_init");
1452 prog->funcoffsets.m_keydown = PRVM_ED_FindFunctionOffset("m_keydown");
1453 prog->funcoffsets.m_keyup = PRVM_ED_FindFunctionOffset("m_keyup");
1454 prog->funcoffsets.m_shutdown = PRVM_ED_FindFunctionOffset("m_shutdown");
1455 prog->funcoffsets.m_toggle = PRVM_ED_FindFunctionOffset("m_toggle");
1460 typedef struct dpfield_s
1467 #define DPFIELDS (sizeof(dpfields) / sizeof(dpfield_t))
1469 dpfield_t dpfields[] =
1480 void PRVM_ResetProg()
1482 PRVM_GCALL(reset_cmd)();
1483 Mem_FreePool(&prog->progs_mempool);
1484 memset(prog,0,sizeof(prvm_prog_t));
1492 void PRVM_LoadLNO( const char *progname ) {
1493 fs_offset_t filesize;
1495 unsigned int *header;
1498 FS_StripExtension( progname, filename, sizeof( filename ) );
1499 strlcat( filename, ".lno", sizeof( filename ) );
1501 lno = FS_LoadFile( filename, tempmempool, false, &filesize );
1507 <Spike> SafeWrite (h, &lnotype, sizeof(int));
1508 <Spike> SafeWrite (h, &version, sizeof(int));
1509 <Spike> SafeWrite (h, &numglobaldefs, sizeof(int));
1510 <Spike> SafeWrite (h, &numpr_globals, sizeof(int));
1511 <Spike> SafeWrite (h, &numfielddefs, sizeof(int));
1512 <Spike> SafeWrite (h, &numstatements, sizeof(int));
1513 <Spike> SafeWrite (h, statement_linenums, numstatements*sizeof(int));
1515 if( (unsigned) filesize < (6 + prog->progs->numstatements) * sizeof( int ) ) {
1520 header = (unsigned int *) lno;
1521 if( header[ 0 ] == *(unsigned int *) "LNOF" &&
1522 LittleLong( header[ 1 ] ) == 1 &&
1523 (unsigned int)LittleLong( header[ 2 ] ) == (unsigned int)prog->progs->numglobaldefs &&
1524 (unsigned int)LittleLong( header[ 3 ] ) == (unsigned int)prog->progs->numglobals &&
1525 (unsigned int)LittleLong( header[ 4 ] ) == (unsigned int)prog->progs->numfielddefs &&
1526 (unsigned int)LittleLong( header[ 5 ] ) == (unsigned int)prog->progs->numstatements )
1528 prog->statement_linenums = (int *)Mem_Alloc(prog->progs_mempool, prog->progs->numstatements * sizeof( int ) );
1529 memcpy( prog->statement_linenums, (int *) lno + 6, prog->progs->numstatements * sizeof( int ) );
1539 void PRVM_LoadProgs (const char * filename, int numrequiredfunc, char **required_func, int numrequiredfields, prvm_required_field_t *required_field, int numrequiredglobals, char **required_global)
1543 ddef_t *infielddefs;
1544 dfunction_t *dfunctions;
1545 fs_offset_t filesize;
1547 if( prog->loaded ) {
1548 PRVM_ERROR ("PRVM_LoadProgs: there is already a %s program loaded!", PRVM_NAME );
1551 prog->progs = (dprograms_t *)FS_LoadFile (filename, prog->progs_mempool, false, &filesize);
1552 if (prog->progs == NULL || filesize < (fs_offset_t)sizeof(dprograms_t))
1553 PRVM_ERROR ("PRVM_LoadProgs: couldn't load %s for %s", filename, PRVM_NAME);
1555 Con_DPrintf("%s programs occupy %iK.\n", PRVM_NAME, (int)(filesize/1024));
1557 prog->filecrc = CRC_Block((unsigned char *)prog->progs, filesize);
1559 // byte swap the header
1560 for (i = 0;i < (int) sizeof(*prog->progs) / 4;i++)
1561 ((int *)prog->progs)[i] = LittleLong ( ((int *)prog->progs)[i] );
1563 if (prog->progs->version != PROG_VERSION)
1564 PRVM_ERROR ("%s: %s has wrong version number (%i should be %i)", PRVM_NAME, filename, prog->progs->version, PROG_VERSION);
1565 if (prog->progs->crc != prog->headercrc)
1566 PRVM_ERROR ("%s: %s system vars have been modified, progdefs.h is out of date", PRVM_NAME, filename);
1568 //prog->functions = (dfunction_t *)((unsigned char *)progs + progs->ofs_functions);
1569 dfunctions = (dfunction_t *)((unsigned char *)prog->progs + prog->progs->ofs_functions);
1571 prog->strings = (char *)prog->progs + prog->progs->ofs_strings;
1572 prog->stringssize = 0;
1573 for (i = 0;i < prog->progs->numstrings;i++)
1575 if (prog->progs->ofs_strings + prog->stringssize >= (int)filesize)
1576 PRVM_ERROR ("%s: %s strings go past end of file", PRVM_NAME, filename);
1577 prog->stringssize += (int)strlen (prog->strings + prog->stringssize) + 1;
1579 prog->numknownstrings = 0;
1580 prog->maxknownstrings = 0;
1581 prog->knownstrings = NULL;
1582 prog->knownstrings_freeable = NULL;
1584 prog->globaldefs = (ddef_t *)((unsigned char *)prog->progs + prog->progs->ofs_globaldefs);
1586 // we need to expand the fielddefs list to include all the engine fields,
1587 // so allocate a new place for it
1588 infielddefs = (ddef_t *)((unsigned char *)prog->progs + prog->progs->ofs_fielddefs);
1590 prog->fielddefs = (ddef_t *)Mem_Alloc(prog->progs_mempool, (prog->progs->numfielddefs + numrequiredfields) * sizeof(ddef_t));
1592 prog->statements = (dstatement_t *)((unsigned char *)prog->progs + prog->progs->ofs_statements);
1594 prog->statement_profile = (double *)Mem_Alloc(prog->progs_mempool, prog->progs->numstatements * sizeof(*prog->statement_profile));
1596 // moved edict_size calculation down below field adding code
1598 //pr_global_struct = (globalvars_t *)((unsigned char *)progs + progs->ofs_globals);
1599 prog->globals.generic = (float *)((unsigned char *)prog->progs + prog->progs->ofs_globals);
1601 // byte swap the lumps
1602 for (i=0 ; i<prog->progs->numstatements ; i++)
1604 prog->statements[i].op = LittleShort(prog->statements[i].op);
1605 prog->statements[i].a = LittleShort(prog->statements[i].a);
1606 prog->statements[i].b = LittleShort(prog->statements[i].b);
1607 prog->statements[i].c = LittleShort(prog->statements[i].c);
1610 prog->functions = (mfunction_t *)Mem_Alloc(prog->progs_mempool, sizeof(mfunction_t) * prog->progs->numfunctions);
1611 for (i = 0;i < prog->progs->numfunctions;i++)
1613 prog->functions[i].first_statement = LittleLong (dfunctions[i].first_statement);
1614 prog->functions[i].parm_start = LittleLong (dfunctions[i].parm_start);
1615 prog->functions[i].s_name = LittleLong (dfunctions[i].s_name);
1616 prog->functions[i].s_file = LittleLong (dfunctions[i].s_file);
1617 prog->functions[i].numparms = LittleLong (dfunctions[i].numparms);
1618 prog->functions[i].locals = LittleLong (dfunctions[i].locals);
1619 memcpy(prog->functions[i].parm_size, dfunctions[i].parm_size, sizeof(dfunctions[i].parm_size));
1622 for (i=0 ; i<prog->progs->numglobaldefs ; i++)
1624 prog->globaldefs[i].type = LittleShort (prog->globaldefs[i].type);
1625 prog->globaldefs[i].ofs = LittleShort (prog->globaldefs[i].ofs);
1626 prog->globaldefs[i].s_name = LittleLong (prog->globaldefs[i].s_name);
1629 // copy the progs fields to the new fields list
1630 for (i = 0;i < prog->progs->numfielddefs;i++)
1632 prog->fielddefs[i].type = LittleShort (infielddefs[i].type);
1633 if (prog->fielddefs[i].type & DEF_SAVEGLOBAL)
1634 PRVM_ERROR ("PRVM_LoadProgs: prog->fielddefs[i].type & DEF_SAVEGLOBAL in %s", PRVM_NAME);
1635 prog->fielddefs[i].ofs = LittleShort (infielddefs[i].ofs);
1636 prog->fielddefs[i].s_name = LittleLong (infielddefs[i].s_name);
1639 // append the required fields
1640 for (i = 0;i < (int) numrequiredfields;i++)
1642 prog->fielddefs[prog->progs->numfielddefs].type = required_field[i].type;
1643 prog->fielddefs[prog->progs->numfielddefs].ofs = prog->progs->entityfields;
1644 prog->fielddefs[prog->progs->numfielddefs].s_name = PRVM_SetEngineString(required_field[i].name);
1645 if (prog->fielddefs[prog->progs->numfielddefs].type == ev_vector)
1646 prog->progs->entityfields += 3;
1648 prog->progs->entityfields++;
1649 prog->progs->numfielddefs++;
1652 // check required functions
1653 for(i=0 ; i < numrequiredfunc ; i++)
1654 if(PRVM_ED_FindFunction(required_func[i]) == 0)
1655 PRVM_ERROR("%s: %s not found in %s",PRVM_NAME, required_func[i], filename);
1657 // check required globals
1658 for(i=0 ; i < numrequiredglobals ; i++)
1659 if(PRVM_ED_FindGlobal(required_global[i]) == 0)
1660 PRVM_ERROR("%s: %s not found in %s",PRVM_NAME, required_global[i], filename);
1662 for (i=0 ; i<prog->progs->numglobals ; i++)
1663 ((int *)prog->globals.generic)[i] = LittleLong (((int *)prog->globals.generic)[i]);
1665 // moved edict_size calculation down here, below field adding code
1666 // LordHavoc: this no longer includes the prvm_edict_t header
1667 prog->edict_size = prog->progs->entityfields * 4;
1668 prog->edictareasize = prog->edict_size * prog->limit_edicts;
1670 // LordHavoc: bounds check anything static
1671 for (i = 0,st = prog->statements;i < prog->progs->numstatements;i++,st++)
1677 if ((unsigned short) st->a >= prog->progs->numglobals || st->b + i < 0 || st->b + i >= prog->progs->numstatements)
1678 PRVM_ERROR("PRVM_LoadProgs: out of bounds IF/IFNOT (statement %d) in %s", i, PRVM_NAME);
1681 if (st->a + i < 0 || st->a + i >= prog->progs->numstatements)
1682 PRVM_ERROR("PRVM_LoadProgs: out of bounds GOTO (statement %d) in %s", i, PRVM_NAME);
1684 // global global global
1719 if ((unsigned short) st->a >= prog->progs->numglobals || (unsigned short) st->b >= prog->progs->numglobals || (unsigned short) st->c >= prog->progs->numglobals)
1720 PRVM_ERROR("PRVM_LoadProgs: out of bounds global index (statement %d)", i);
1722 // global none global
1728 if ((unsigned short) st->a >= prog->progs->numglobals || (unsigned short) st->c >= prog->progs->numglobals)
1729 PRVM_ERROR("PRVM_LoadProgs: out of bounds global index (statement %d) in %s", i, PRVM_NAME);
1745 if ((unsigned short) st->a >= prog->progs->numglobals || (unsigned short) st->b >= prog->progs->numglobals)
1746 PRVM_ERROR("PRVM_LoadProgs: out of bounds global index (statement %d) in %s", i, PRVM_NAME);
1760 if ((unsigned short) st->a >= prog->progs->numglobals)
1761 PRVM_ERROR("PRVM_LoadProgs: out of bounds global index (statement %d) in %s", i, PRVM_NAME);
1764 Con_DPrintf("PRVM_LoadProgs: unknown opcode %d at statement %d in %s\n", st->op, i, PRVM_NAME);
1769 PRVM_LoadLNO(filename);
1773 prog->loaded = TRUE;
1775 // set flags & ddef_ts in prog
1781 PRVM_GCALL(init_cmd)();
1788 void PRVM_Fields_f (void)
1790 int i, j, ednum, used, usedamount;
1792 char tempstring[MAX_INPUTLINE], tempstring2[260];
1802 Con_Print("no progs loaded\n");
1809 Con_Print("prvm_fields <program name>\n");
1814 if(!PRVM_SetProgFromString(Cmd_Argv(1)))
1817 counts = (int *)Mem_Alloc(tempmempool, prog->progs->numfielddefs * sizeof(int));
1818 for (ednum = 0;ednum < prog->max_edicts;ednum++)
1820 ed = PRVM_EDICT_NUM(ednum);
1821 if (ed->priv.required->free)
1823 for (i = 1;i < prog->progs->numfielddefs;i++)
1825 d = &prog->fielddefs[i];
1826 name = PRVM_GetString(d->s_name);
1827 if (name[strlen(name)-2] == '_')
1828 continue; // skip _x, _y, _z vars
1829 v = (int *)((char *)ed->fields.vp + d->ofs*4);
1830 // if the value is still all 0, skip the field
1831 for (j = 0;j < prvm_type_size[d->type & ~DEF_SAVEGLOBAL];j++)
1844 for (i = 0;i < prog->progs->numfielddefs;i++)
1846 d = &prog->fielddefs[i];
1847 name = PRVM_GetString(d->s_name);
1848 if (name[strlen(name)-2] == '_')
1849 continue; // skip _x, _y, _z vars
1850 switch(d->type & ~DEF_SAVEGLOBAL)
1853 strlcat(tempstring, "string ", sizeof(tempstring));
1856 strlcat(tempstring, "entity ", sizeof(tempstring));
1859 strlcat(tempstring, "function ", sizeof(tempstring));
1862 strlcat(tempstring, "field ", sizeof(tempstring));
1865 strlcat(tempstring, "void ", sizeof(tempstring));
1868 strlcat(tempstring, "float ", sizeof(tempstring));
1871 strlcat(tempstring, "vector ", sizeof(tempstring));
1874 strlcat(tempstring, "pointer ", sizeof(tempstring));
1877 sprintf (tempstring2, "bad type %i ", d->type & ~DEF_SAVEGLOBAL);
1878 strlcat(tempstring, tempstring2, sizeof(tempstring));
1881 if (strlen(name) > sizeof(tempstring2)-4)
1883 memcpy (tempstring2, name, sizeof(tempstring2)-4);
1884 tempstring2[sizeof(tempstring2)-4] = tempstring2[sizeof(tempstring2)-3] = tempstring2[sizeof(tempstring2)-2] = '.';
1885 tempstring2[sizeof(tempstring2)-1] = 0;
1888 strlcat(tempstring, name, sizeof(tempstring));
1889 for (j = (int)strlen(name);j < 25;j++)
1890 strlcat(tempstring, " ", sizeof(tempstring));
1891 sprintf(tempstring2, "%5d", counts[i]);
1892 strlcat(tempstring, tempstring2, sizeof(tempstring));
1893 strlcat(tempstring, "\n", sizeof(tempstring));
1894 if (strlen(tempstring) >= sizeof(tempstring)/2)
1896 Con_Print(tempstring);
1902 usedamount += prvm_type_size[d->type & ~DEF_SAVEGLOBAL];
1906 Con_Printf("%s: %i entity fields (%i in use), totalling %i bytes per edict (%i in use), %i edicts allocated, %i bytes total spent on edict fields (%i needed)\n", PRVM_NAME, prog->progs->entityfields, used, prog->progs->entityfields * 4, usedamount * 4, prog->max_edicts, prog->progs->entityfields * 4 * prog->max_edicts, usedamount * 4 * prog->max_edicts);
1911 void PRVM_Globals_f (void)
1914 const char *wildcard;
1920 Con_Print("no progs loaded\n");
1923 if(Cmd_Argc () < 2 || Cmd_Argc() > 3)
1925 Con_Print("prvm_globals <program name> <optional name wildcard>\n");
1930 if(!PRVM_SetProgFromString (Cmd_Argv (1)))
1933 if( Cmd_Argc() == 3)
1934 wildcard = Cmd_Argv(2);
1938 Con_Printf("%s :", PRVM_NAME);
1940 for (i = 0;i < prog->progs->numglobaldefs;i++)
1943 if( !matchpattern( PRVM_GetString(prog->globaldefs[i].s_name), wildcard, 1) )
1948 Con_Printf("%s\n", PRVM_GetString(prog->globaldefs[i].s_name));
1950 Con_Printf("%i global variables, %i culled, totalling %i bytes\n", prog->progs->numglobals, numculled, prog->progs->numglobals * 4);
1960 void PRVM_Global_f(void)
1963 if( Cmd_Argc() != 3 ) {
1964 Con_Printf( "prvm_global <program name> <global name>\n" );
1969 if( !PRVM_SetProgFromString( Cmd_Argv(1) ) )
1972 global = PRVM_ED_FindGlobal( Cmd_Argv(2) );
1974 Con_Printf( "No global '%s' in %s!\n", Cmd_Argv(2), Cmd_Argv(1) );
1976 Con_Printf( "%s: %s\n", Cmd_Argv(2), PRVM_ValueString( (etype_t)global->type, (prvm_eval_t *) &prog->globals.generic[ global->ofs ] ) );
1985 void PRVM_GlobalSet_f(void)
1988 if( Cmd_Argc() != 4 ) {
1989 Con_Printf( "prvm_globalset <program name> <global name> <value>\n" );
1994 if( !PRVM_SetProgFromString( Cmd_Argv(1) ) )
1997 global = PRVM_ED_FindGlobal( Cmd_Argv(2) );
1999 Con_Printf( "No global '%s' in %s!\n", Cmd_Argv(2), Cmd_Argv(1) );
2001 PRVM_ED_ParseEpair( NULL, global, Cmd_Argv(3) );
2010 void PRVM_Init (void)
2012 Cmd_AddCommand ("prvm_edict", PRVM_ED_PrintEdict_f, "print all data about an entity number in the selected VM (server, client, menu)");
2013 Cmd_AddCommand ("prvm_edicts", PRVM_ED_PrintEdicts_f, "prints all data about all entities in the selected VM (server, client, menu)");
2014 Cmd_AddCommand ("prvm_edictcount", PRVM_ED_Count_f, "prints number of active entities in the selected VM (server, client, menu)");
2015 Cmd_AddCommand ("prvm_profile", PRVM_Profile_f, "prints execution statistics about the most used QuakeC functions in the selected VM (server, client, menu)");
2016 Cmd_AddCommand ("prvm_fields", PRVM_Fields_f, "prints usage statistics on properties (how many entities have non-zero values) in the selected VM (server, client, menu)");
2017 Cmd_AddCommand ("prvm_globals", PRVM_Globals_f, "prints all global variables in the selected VM (server, client, menu)");
2018 Cmd_AddCommand ("prvm_global", PRVM_Global_f, "prints value of a specified global variable in the selected VM (server, client, menu)");
2019 Cmd_AddCommand ("prvm_globalset", PRVM_GlobalSet_f, "sets value of a specified global variable in the selected VM (server, client, menu)");
2020 Cmd_AddCommand ("prvm_edictset", PRVM_ED_EdictSet_f, "changes value of a specified property of a specified entity in the selected VM (server, client, menu)");
2021 Cmd_AddCommand ("prvm_printfunction", PRVM_PrintFunction_f, "prints a disassembly (QuakeC instructions) of the specified function in the selected VM (server, client, menu)");
2022 Cmd_AddCommand ("cl_cmd", PRVM_GameCommand_Client_f, "calls the client QC function GameCommand with the supplied string as argument");
2023 Cmd_AddCommand ("menu_cmd", PRVM_GameCommand_Menu_f, "calls the menu QC function GameCommand with the supplied string as argument");
2024 Cmd_AddCommand ("sv_cmd", PRVM_GameCommand_Server_f, "calls the server QC function GameCommand with the supplied string as argument");
2025 // LordHavoc: optional runtime bounds checking (speed drain, but worth it for security, on by default - breaks most QCCX features (used by CRMod and others))
2026 Cvar_RegisterVariable (&prvm_boundscheck);
2027 Cvar_RegisterVariable (&prvm_traceqc);
2028 Cvar_RegisterVariable (&prvm_statementprofiling);
2038 void PRVM_InitProg(int prognr)
2040 if(prognr < 0 || prognr >= PRVM_MAXPROGS)
2041 Sys_Error("PRVM_InitProg: Invalid program number %i",prognr);
2043 prog = &prog_list[prognr];
2048 memset(prog, 0, sizeof(prvm_prog_t));
2050 prog->error_cmd = Host_Error;
2053 int PRVM_GetProgNr()
2055 return prog - prog_list;
2058 void *_PRVM_Alloc(size_t buffersize, const char *filename, int fileline)
2060 return _Mem_Alloc(prog->progs_mempool, buffersize, filename, fileline);
2063 void _PRVM_Free(void *buffer, const char *filename, int fileline)
2065 _Mem_Free(buffer, filename, fileline);
2068 void _PRVM_FreeAll(const char *filename, int fileline)
2071 prog->fielddefs = NULL;
2072 prog->functions = NULL;
2073 _Mem_EmptyPool(prog->progs_mempool, filename, fileline);
2076 // LordHavoc: turned PRVM_EDICT_NUM into a #define for speed reasons
2077 prvm_edict_t *PRVM_EDICT_NUM_ERROR(int n, char *filename, int fileline)
2079 PRVM_ERROR ("PRVM_EDICT_NUM: %s: bad number %i (called at %s:%i)", PRVM_NAME, n, filename, fileline);
2084 int NUM_FOR_EDICT_ERROR(prvm_edict_t *e)
2086 PRVM_ERROR ("PRVM_NUM_FOR_EDICT: bad pointer %p (world is %p, entity number would be %i)", e, prog->edicts, e - prog->edicts);
2090 int PRVM_NUM_FOR_EDICT(prvm_edict_t *e)
2093 n = e - prog->edicts;
2094 if ((unsigned int)n >= prog->limit_edicts)
2095 Host_Error ("PRVM_NUM_FOR_EDICT: bad pointer");
2099 //int NoCrash_NUM_FOR_EDICT(prvm_edict_t *e)
2101 // return e - prog->edicts;
2104 //#define PRVM_EDICT_TO_PROG(e) ((unsigned char *)(((prvm_edict_t *)e)->v) - (unsigned char *)(prog->edictsfields))
2105 //#define PRVM_PROG_TO_EDICT(e) (prog->edicts + ((e) / (progs->entityfields * 4)))
2106 int PRVM_EDICT_TO_PROG(prvm_edict_t *e)
2109 n = e - prog->edicts;
2110 if ((unsigned int)n >= (unsigned int)prog->max_edicts)
2111 Host_Error("PRVM_EDICT_TO_PROG: invalid edict %8p (number %i compared to world at %8p)", e, n, prog->edicts);
2112 return n;// EXPERIMENTAL
2113 //return (unsigned char *)e->v - (unsigned char *)prog->edictsfields;
2115 prvm_edict_t *PRVM_PROG_TO_EDICT(int n)
2117 if ((unsigned int)n >= (unsigned int)prog->max_edicts)
2118 Host_Error("PRVM_PROG_TO_EDICT: invalid edict number %i", n);
2119 return prog->edicts + n; // EXPERIMENTAL
2120 //return prog->edicts + ((n) / (progs->entityfields * 4));
2125 sizebuf_t vm_tempstringsbuf;
2127 const char *PRVM_GetString(int num)
2131 if (num < prog->stringssize)
2132 return prog->strings + num;
2135 if (num <= prog->stringssize + vm_tempstringsbuf.maxsize)
2137 num -= prog->stringssize;
2138 if (num < vm_tempstringsbuf.cursize)
2139 return (char *)vm_tempstringsbuf.data + num;
2142 VM_Warning("PRVM_GetString: Invalid temp-string offset (%i >= %i vm_tempstringsbuf.cursize)", num, vm_tempstringsbuf.cursize);
2149 VM_Warning("PRVM_GetString: Invalid constant-string offset (%i >= %i prog->stringssize)", num, prog->stringssize);
2159 // special range reserved for tempstrings
2161 if (num < vm_tempstringsbuf.cursize)
2162 return (char *)vm_tempstringsbuf.data + num;
2165 VM_Warning("PRVM_GetString: Invalid temp-string offset (%i >= %i vm_tempstringsbuf.cursize)", num, vm_tempstringsbuf.cursize);
2171 if (num < prog->numknownstrings)
2173 if (!prog->knownstrings[num])
2174 VM_Warning("PRVM_GetString: Invalid zone-string offset (%i has been freed)", num);
2175 return prog->knownstrings[num];
2179 VM_Warning("PRVM_GetString: Invalid zone-string offset (%i >= %i)", num, prog->numknownstrings);
2185 int PRVM_SetEngineString(const char *s)
2190 if (s >= prog->strings && s <= prog->strings + prog->stringssize)
2191 PRVM_ERROR("PRVM_SetEngineString: s in prog->strings area");
2192 // if it's in the tempstrings area, use a reserved range
2193 // (otherwise we'd get millions of useless string offsets cluttering the database)
2194 if (s >= (char *)vm_tempstringsbuf.data && s < (char *)vm_tempstringsbuf.data + vm_tempstringsbuf.maxsize)
2196 return prog->stringssize + (s - (char *)vm_tempstringsbuf.data);
2198 return -1 - ((1<<30) + (s - (char *)vm_tempstringsbuf.data));
2200 // see if it's a known string address
2201 for (i = 0;i < prog->numknownstrings;i++)
2202 if (prog->knownstrings[i] == s)
2204 // new unknown engine string
2205 if (developer.integer >= 200)
2206 Con_Printf("new engine string %p = \"%s\"\n", s, s);
2207 for (i = prog->firstfreeknownstring;i < prog->numknownstrings;i++)
2208 if (!prog->knownstrings[i])
2210 if (i >= prog->numknownstrings)
2212 if (i >= prog->maxknownstrings)
2214 const char **oldstrings = prog->knownstrings;
2215 const unsigned char *oldstrings_freeable = prog->knownstrings_freeable;
2216 prog->maxknownstrings += 128;
2217 prog->knownstrings = (const char **)PRVM_Alloc(prog->maxknownstrings * sizeof(char *));
2218 prog->knownstrings_freeable = (unsigned char *)PRVM_Alloc(prog->maxknownstrings * sizeof(unsigned char));
2219 if (prog->numknownstrings)
2221 memcpy((char **)prog->knownstrings, oldstrings, prog->numknownstrings * sizeof(char *));
2222 memcpy((char **)prog->knownstrings_freeable, oldstrings_freeable, prog->numknownstrings * sizeof(unsigned char));
2225 prog->numknownstrings++;
2227 prog->firstfreeknownstring = i + 1;
2228 prog->knownstrings[i] = s;
2232 // temp string handling
2234 // all tempstrings go into this buffer consecutively, and it is reset
2235 // whenever PRVM_ExecuteProgram returns to the engine
2236 // (technically each PRVM_ExecuteProgram call saves the cursize value and
2237 // restores it on return, so multiple recursive calls can share the same
2239 // the buffer size is automatically grown as needed
2241 int PRVM_SetTempString(const char *s)
2247 size = (int)strlen(s) + 1;
2248 if (developer.integer >= 300)
2249 Con_Printf("PRVM_SetTempString: cursize %i, size %i\n", vm_tempstringsbuf.cursize, size);
2250 if (vm_tempstringsbuf.maxsize < vm_tempstringsbuf.cursize + size)
2252 sizebuf_t old = vm_tempstringsbuf;
2253 if (vm_tempstringsbuf.cursize + size >= 1<<28)
2254 PRVM_ERROR("PRVM_SetTempString: ran out of tempstring memory! (refusing to grow tempstring buffer over 256MB, cursize %i, size %i)\n", vm_tempstringsbuf.cursize, size);
2255 vm_tempstringsbuf.maxsize = max(vm_tempstringsbuf.maxsize, 65536);
2256 while (vm_tempstringsbuf.maxsize < vm_tempstringsbuf.cursize + size)
2257 vm_tempstringsbuf.maxsize *= 2;
2258 if (vm_tempstringsbuf.maxsize != old.maxsize || vm_tempstringsbuf.data == NULL)
2260 if (developer.integer >= 100)
2261 Con_Printf("PRVM_SetTempString: enlarging tempstrings buffer (%iKB -> %iKB)\n", old.maxsize/1024, vm_tempstringsbuf.maxsize/1024);
2262 vm_tempstringsbuf.data = Mem_Alloc(sv_mempool, vm_tempstringsbuf.maxsize);
2264 memcpy(vm_tempstringsbuf.data, old.data, old.cursize);
2269 t = (char *)vm_tempstringsbuf.data + vm_tempstringsbuf.cursize;
2271 vm_tempstringsbuf.cursize += size;
2272 return PRVM_SetEngineString(t);
2275 int PRVM_AllocString(size_t bufferlength, char **pointer)
2280 for (i = prog->firstfreeknownstring;i < prog->numknownstrings;i++)
2281 if (!prog->knownstrings[i])
2283 if (i >= prog->numknownstrings)
2285 if (i >= prog->maxknownstrings)
2287 const char **oldstrings = prog->knownstrings;
2288 const unsigned char *oldstrings_freeable = prog->knownstrings_freeable;
2289 prog->maxknownstrings += 128;
2290 prog->knownstrings = (const char **)PRVM_Alloc(prog->maxknownstrings * sizeof(char *));
2291 prog->knownstrings_freeable = (unsigned char *)PRVM_Alloc(prog->maxknownstrings * sizeof(unsigned char));
2292 if (prog->numknownstrings)
2294 memcpy((char **)prog->knownstrings, oldstrings, prog->numknownstrings * sizeof(char *));
2295 memcpy((char **)prog->knownstrings_freeable, oldstrings_freeable, prog->numknownstrings * sizeof(unsigned char));
2298 prog->numknownstrings++;
2300 prog->firstfreeknownstring = i + 1;
2301 prog->knownstrings[i] = (char *)PRVM_Alloc(bufferlength);
2302 prog->knownstrings_freeable[i] = true;
2304 *pointer = (char *)(prog->knownstrings[i]);
2308 void PRVM_FreeString(int num)
2311 PRVM_ERROR("PRVM_FreeString: attempt to free a NULL string");
2312 else if (num >= 0 && num < prog->stringssize)
2313 PRVM_ERROR("PRVM_FreeString: attempt to free a constant string");
2314 else if (num < 0 && num >= -prog->numknownstrings)
2317 if (!prog->knownstrings[num])
2318 PRVM_ERROR("PRVM_FreeString: attempt to free a non-existent or already freed string");
2319 if (!prog->knownstrings[num])
2320 PRVM_ERROR("PRVM_FreeString: attempt to free a string owned by the engine");
2321 PRVM_Free((char *)prog->knownstrings[num]);
2322 prog->knownstrings[num] = NULL;
2323 prog->knownstrings_freeable[num] = false;
2324 prog->firstfreeknownstring = min(prog->firstfreeknownstring, num);
2327 PRVM_ERROR("PRVM_FreeString: invalid string offset %i", num);