2 // Basically every vm builtin cmd should be in here.
3 // All 3 builtin and extension lists can be found here
4 // cause large (I think they will) parts are from pr_cmds the same copyright like in pr_cmds
13 #include "cl_collision.h"
14 #include "clvm_cmds.h"
19 extern cvar_t prvm_backtraceforwarnings;
21 extern dllhandle_t ode_dll;
24 // LadyHavoc: changed this to NOT use a return statement, so that it can be used in functions that must return a value
25 void VM_Warning(prvm_prog_t *prog, const char *fmt, ...)
28 char msg[MAX_INPUTLINE];
29 static double recursive = -1;
30 int outfd = sys.outfd;
32 // set output to stderr
33 sys.outfd = fileno(stderr);
36 dpvsnprintf(msg,sizeof(msg),fmt,argptr);
39 Con_Printf(CON_WARN "%s VM warning: %s", prog->name, msg);
41 // TODO: either add a cvar/cmd to control the state dumping or replace some of the calls with Con_Printf [9/13/2006 Black]
42 if(prvm_backtraceforwarnings.integer && recursive != host.realtime) // NOTE: this compares to the time, just in case if PRVM_PrintState causes a Host_Error and keeps recursive set
44 recursive = host.realtime;
45 PRVM_PrintState(prog, 0);
49 // restore configured outfd
54 //============================================================================
57 // TODO DONE: move vm_files and vm_fssearchlist to prvm_prog_t struct
58 // TODO: move vm_files and vm_fssearchlist back [9/13/2006 Black]
59 // TODO: (move vm_files and vm_fssearchlist to prvm_prog_t struct again) [2007-01-23 LadyHavoc]
60 // TODO: will this war ever end? [2007-01-23 LadyHavoc]
62 void VM_CheckEmptyString(prvm_prog_t *prog, const char *s)
64 if (ISWHITESPACE(s[0]))
65 prog->error_cmd("%s: Bad string", prog->name);
68 qbool PRVM_ConsoleCommand (prvm_prog_t *prog, const char *text, int *func, qbool preserve_self, int curself, double ptime, qbool prog_loaded, const char *error_message)
70 int restorevm_tempstringsbuf_cursize;
71 int save_self = 0; // hush compiler warning
80 save_self = PRVM_gameglobaledict(self);
82 PRVM_gameglobalfloat(time) = ptime;
83 PRVM_gameglobaledict(self) = curself;
84 restorevm_tempstringsbuf_cursize = prog->tempstringsbuf.cursize;
85 PRVM_G_INT(OFS_PARM0) = PRVM_SetTempString(prog, text);
86 prog->ExecuteProgram(prog, *func, error_message);
87 prog->tempstringsbuf.cursize = restorevm_tempstringsbuf_cursize;
89 PRVM_gameglobaledict(self) = save_self;
90 r = (int) PRVM_G_FLOAT(OFS_RETURN) != 0;
96 void VM_GenerateFrameGroupBlend(prvm_prog_t *prog, framegroupblend_t *framegroupblend, const prvm_edict_t *ed)
98 // self.frame is the interpolation target (new frame)
99 // self.frame1time is the animation base time for the interpolation target
100 // self.frame2 is the interpolation start (previous frame)
101 // self.frame2time is the animation base time for the interpolation start
102 // self.lerpfrac is the interpolation strength for self.frame2
103 // self.lerpfrac3 is the interpolation strength for self.frame3
104 // self.lerpfrac4 is the interpolation strength for self.frame4
105 // pitch angle on a player model where the animator set up 5 sets of
106 // animations and the csqc simply lerps between sets)
107 framegroupblend[0].frame = (int) PRVM_gameedictfloat(ed, frame );
108 framegroupblend[1].frame = (int) PRVM_gameedictfloat(ed, frame2 );
109 framegroupblend[2].frame = (int) PRVM_gameedictfloat(ed, frame3 );
110 framegroupblend[3].frame = (int) PRVM_gameedictfloat(ed, frame4 );
111 framegroupblend[0].start = PRVM_gameedictfloat(ed, frame1time);
112 framegroupblend[1].start = PRVM_gameedictfloat(ed, frame2time);
113 framegroupblend[2].start = PRVM_gameedictfloat(ed, frame3time);
114 framegroupblend[3].start = PRVM_gameedictfloat(ed, frame4time);
115 framegroupblend[1].lerp = PRVM_gameedictfloat(ed, lerpfrac );
116 framegroupblend[2].lerp = PRVM_gameedictfloat(ed, lerpfrac3 );
117 framegroupblend[3].lerp = PRVM_gameedictfloat(ed, lerpfrac4 );
118 // assume that the (missing) lerpfrac1 is whatever remains after lerpfrac2+lerpfrac3+lerpfrac4 are summed
119 framegroupblend[0].lerp = 1 - framegroupblend[1].lerp - framegroupblend[2].lerp - framegroupblend[3].lerp;
122 // LadyHavoc: quite tempting to break apart this function to reuse the
123 // duplicated code, but I suspect it is better for performance
125 void VM_FrameBlendFromFrameGroupBlend(frameblend_t *frameblend, const framegroupblend_t *framegroupblend, const model_t *model, double curtime)
127 int sub2, numframes, f, i, k;
128 int isfirstframegroup = true;
130 double sublerp, lerp, d;
131 const animscene_t *scene;
132 const framegroupblend_t *g;
133 frameblend_t *blend = frameblend;
135 memset(blend, 0, MAX_FRAMEBLENDS * sizeof(*blend));
137 // rpolzer: Not testing isanimated here - a model might have
138 // "animations" that move no vertices (but only bones), thus rendering
139 // may assume it's not animated while processing can't.
146 nolerp = ((model->type == mod_sprite) ? !r_lerpsprites.integer : !r_lerpmodels.integer) || (model->nolerp == true);
147 numframes = model->numframes;
148 for (k = 0, g = framegroupblend;k < MAX_FRAMEGROUPBLENDS;k++, g++)
151 if ((unsigned int)f >= (unsigned int)numframes)
153 if (developer_extra.integer)
154 Con_DPrintf("VM_FrameBlendFromFrameGroupBlend: no such frame %d in model %s\n", f, model->name);
162 if (isfirstframegroup)
165 isfirstframegroup = false;
170 if (model->animscenes)
172 scene = model->animscenes + f;
173 f = scene->firstframe;
174 if (scene->framecount > 1)
176 // this code path is only used on .zym models and torches
177 sublerp = scene->framerate * (curtime - g->start);
178 f = (int) floor(sublerp);
181 if (sublerp < (1.0 / 65536.0f))
183 if (sublerp > (65535.0f / 65536.0f))
189 f = (f % scene->framecount);
190 sub2 = (sub2 % scene->framecount);
192 f = bound(0, f, (scene->framecount - 1)) + scene->firstframe;
193 sub2 = bound(0, sub2, (scene->framecount - 1)) + scene->firstframe;
195 // two framelerps produced from one animation
198 for (i = 0;i < MAX_FRAMEBLENDS;i++)
200 if (blend[i].lerp <= 0 || blend[i].subframe == sub2)
202 blend[i].subframe = sub2;
208 d = (1 - sublerp) * lerp;
213 for (i = 0;i < MAX_FRAMEBLENDS;i++)
215 if (blend[i].lerp <= 0 || blend[i].subframe == f)
217 blend[i].subframe = f;
226 void VM_UpdateEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed, const model_t *edmodel, const frameblend_t *frameblend)
228 if (ed->priv.server->skeleton.model != edmodel)
230 VM_RemoveEdictSkeleton(prog, ed);
231 ed->priv.server->skeleton.model = edmodel;
233 if (!ed->priv.server->skeleton.model || !ed->priv.server->skeleton.model->num_bones)
235 if(ed->priv.server->skeleton.relativetransforms)
236 Mem_Free(ed->priv.server->skeleton.relativetransforms);
237 ed->priv.server->skeleton.relativetransforms = NULL;
242 int skeletonindex = -1;
243 skeleton_t *skeleton;
244 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
245 if (skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones)
247 // custom skeleton controlled by the game (FTE_CSQC_SKELETONOBJECTS)
248 if (!ed->priv.server->skeleton.relativetransforms)
249 ed->priv.server->skeleton.relativetransforms = (matrix4x4_t *)Mem_Alloc(prog->progs_mempool, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
250 memcpy(ed->priv.server->skeleton.relativetransforms, skeleton->relativetransforms, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
254 if(ed->priv.server->skeleton.relativetransforms)
255 Mem_Free(ed->priv.server->skeleton.relativetransforms);
256 ed->priv.server->skeleton.relativetransforms = NULL;
261 void VM_RemoveEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed)
263 if (ed->priv.server->skeleton.relativetransforms)
264 Mem_Free(ed->priv.server->skeleton.relativetransforms);
265 memset(&ed->priv.server->skeleton, 0, sizeof(ed->priv.server->skeleton));
271 //============================================================================
274 void VM_VarString(prvm_prog_t *prog, int first, char *out, int outlength)
280 outend = out + outlength - 1;
281 for (i = first;i < prog->argc && out < outend;i++)
283 s = PRVM_G_STRING((OFS_PARM0+i*3));
284 while (out < outend && *s)
294 returns true if the extension is supported by the server
296 checkextension(extensionname)
300 // kind of helper function
301 static qbool checkextension(prvm_prog_t *prog, const char *name)
305 for (e = prog->extensionstring;*e;e++)
307 if(!strcasecmp(*e, name))
310 // special sheck for ODE
311 if (!strncasecmp("DP_PHYSICS_ODE", name, 14))
313 #ifndef LINK_TO_LIBODE
314 return ode_dll ? true : false;
316 #ifdef LINK_TO_LIBODE
325 // special sheck for d0_blind_id
326 if (!strcasecmp("DP_CRYPTO", name))
327 return Crypto_Available();
328 if (!strcasecmp("DP_QC_DIGEST_SHA256", name))
329 return Crypto_Available();
331 // special shreck for libcurl
332 if (!strcasecmp("DP_QC_URI_GET", name) || !strcasecmp("DP_QC_URI_POST", name))
333 return Curl_Available();
341 void VM_checkextension(prvm_prog_t *prog)
343 VM_SAFEPARMCOUNT(1,VM_checkextension);
345 PRVM_G_FLOAT(OFS_RETURN) = checkextension(prog, PRVM_G_STRING(OFS_PARM0));
352 This is a TERMINAL error, which will kill off the entire prog.
358 void VM_error(prvm_prog_t *prog)
361 char string[VM_STRINGTEMP_LENGTH];
363 VM_VarString(prog, 0, string, sizeof(string));
364 Con_Printf(CON_ERROR "======%s ERROR in %s:\n%s\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
365 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
366 PRVM_ED_Print(prog, ed, NULL);
368 prog->error_cmd("%s: Program error in function %s:\n%s\nTip: read above for entity information\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
375 Dumps out self, then an error message. The program is aborted and self is
376 removed, but the level can continue.
381 void VM_objerror(prvm_prog_t *prog)
384 char string[VM_STRINGTEMP_LENGTH];
386 VM_VarString(prog, 0, string, sizeof(string));
387 Con_Printf(CON_ERROR "======OBJECT ERROR======\n"); // , prog->name, PRVM_GetString(prog->xfunction->s_name), string); // or include them? FIXME
388 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
389 PRVM_ED_Print(prog, ed, NULL);
390 PRVM_ED_Free (prog, ed);
391 Con_Printf(CON_ERROR "%s OBJECT ERROR in %s:\n%s\nTip: read above for entity information\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
403 void VM_print(prvm_prog_t *prog)
405 char string[VM_STRINGTEMP_LENGTH];
407 VM_VarString(prog, 0, string, sizeof(string));
415 broadcast print to everyone on server
420 void VM_bprint(prvm_prog_t *prog)
422 char string[VM_STRINGTEMP_LENGTH];
426 VM_Warning(prog, "VM_bprint: game is not server(%s) !\n", prog->name);
430 VM_VarString(prog, 0, string, sizeof(string));
431 SV_BroadcastPrint(string);
436 VM_sprint (menu & client but only if server.active == true)
438 single print to a specific client
440 sprint(float clientnum,...[string])
443 void VM_sprint(prvm_prog_t *prog)
447 char string[VM_STRINGTEMP_LENGTH];
449 VM_SAFEPARMCOUNTRANGE(1, 8, VM_sprint);
451 //find client for this entity
452 clientnum = (int)PRVM_G_FLOAT(OFS_PARM0);
453 if (!sv.active || clientnum < 0 || clientnum >= svs.maxclients || !svs.clients[clientnum].active)
455 VM_Warning(prog, "VM_sprint: %s: invalid client or server is not active !\n", prog->name);
459 client = svs.clients + clientnum;
460 if (!client->netconnection)
463 VM_VarString(prog, 1, string, sizeof(string));
464 MSG_WriteChar(&client->netconnection->message,svc_print);
465 MSG_WriteString(&client->netconnection->message, string);
472 single print to the screen
477 void VM_centerprint(prvm_prog_t *prog)
479 char string[VM_STRINGTEMP_LENGTH];
481 VM_SAFEPARMCOUNTRANGE(1, 8, VM_centerprint);
482 VM_VarString(prog, 0, string, sizeof(string));
483 SCR_CenterPrint(string);
490 vector normalize(vector)
493 void VM_normalize(prvm_prog_t *prog)
499 VM_SAFEPARMCOUNT(1,VM_normalize);
501 value1 = PRVM_G_VECTOR(OFS_PARM0);
503 f = VectorLength2(value1);
507 VectorScale(value1, f, newvalue);
510 VectorClear(newvalue);
512 VectorCopy (newvalue, PRVM_G_VECTOR(OFS_RETURN));
522 void VM_vlen(prvm_prog_t *prog)
524 VM_SAFEPARMCOUNT(1,VM_vlen);
525 PRVM_G_FLOAT(OFS_RETURN) = VectorLength(PRVM_G_VECTOR(OFS_PARM0));
532 float vectoyaw(vector)
535 void VM_vectoyaw(prvm_prog_t *prog)
540 VM_SAFEPARMCOUNT(1,VM_vectoyaw);
542 value1 = PRVM_G_VECTOR(OFS_PARM0);
544 if (value1[1] == 0 && value1[0] == 0)
548 yaw = (int) (atan2(value1[1], value1[0]) * 180 / M_PI);
553 PRVM_G_FLOAT(OFS_RETURN) = yaw;
561 vector vectoangles(vector[, vector])
564 void VM_vectoangles(prvm_prog_t *prog)
566 vec3_t result, forward, up;
567 VM_SAFEPARMCOUNTRANGE(1, 2,VM_vectoangles);
569 VectorCopy(PRVM_G_VECTOR(OFS_PARM0), forward);
572 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), up);
573 AnglesFromVectors(result, forward, up, true);
576 AnglesFromVectors(result, forward, NULL, true);
577 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
584 Returns a random number > 0 and < 1
589 void VM_random(prvm_prog_t *prog)
591 VM_SAFEPARMCOUNT(0,VM_random);
593 PRVM_G_FLOAT(OFS_RETURN) = lhrandom(0, 1);
600 localsound(string sample, float chan, float vol)
603 void VM_localsound(prvm_prog_t *prog)
608 VM_SAFEPARMCOUNTRANGE(1, 3,VM_localsound);
610 s = PRVM_G_STRING(OFS_PARM0);
613 chan = PRVM_G_FLOAT(OFS_PARM1);
614 vol = PRVM_G_FLOAT(OFS_PARM2) == 0 ? 1 : PRVM_G_FLOAT(OFS_PARM2);
615 if(!S_LocalSoundEx(s, chan, vol))
617 PRVM_G_FLOAT(OFS_RETURN) = -4;
618 VM_Warning(prog, "VM_localsound: Failed to play %s for %s !\n", s, prog->name);
622 else if(!S_LocalSound (s))
624 PRVM_G_FLOAT(OFS_RETURN) = -4;
625 VM_Warning(prog, "VM_localsound: Failed to play %s for %s !\n", s, prog->name);
629 PRVM_G_FLOAT(OFS_RETURN) = 1;
639 void VM_break(prvm_prog_t *prog)
641 prog->error_cmd("%s: break statement", prog->name);
644 //============================================================================
650 Sends text over to the client's execution buffer
652 [localcmd (string, ...) or]
656 void VM_localcmd_local(prvm_prog_t *prog)
658 char string[VM_STRINGTEMP_LENGTH];
659 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd_local);
660 VM_VarString(prog, 0, string, sizeof(string));
661 Cbuf_AddText(cmd_local, string);
668 Sends text over to the server's execution buffer
670 [localcmd (string, ...) or]
674 void VM_localcmd_server(prvm_prog_t *prog)
676 char string[VM_STRINGTEMP_LENGTH];
677 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd_server);
678 VM_VarString(prog, 0, string, sizeof(string));
679 Cbuf_AddText(cmd_local, string);
682 static qbool PRVM_Cvar_ReadOk(prvm_prog_t *prog, const char *string)
685 cvar = Cvar_FindVar(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask);
686 return ((cvar) && ((cvar->flags & CF_PRIVATE) == 0));
696 void VM_cvar(prvm_prog_t *prog)
698 char string[VM_STRINGTEMP_LENGTH];
699 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
700 VM_VarString(prog, 0, string, sizeof(string));
701 VM_CheckEmptyString(prog, string);
702 PRVM_G_FLOAT(OFS_RETURN) = PRVM_Cvar_ReadOk(prog, string) ? Cvar_VariableValue(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask) : 0;
709 float cvar_type (string)
710 float CVAR_TYPEFLAG_EXISTS = 1;
711 float CVAR_TYPEFLAG_SAVED = 2;
712 float CVAR_TYPEFLAG_PRIVATE = 4;
713 float CVAR_TYPEFLAG_ENGINE = 8;
714 float CVAR_TYPEFLAG_HASDESCRIPTION = 16;
715 float CVAR_TYPEFLAG_READONLY = 32;
718 void VM_cvar_type(prvm_prog_t *prog)
720 char string[VM_STRINGTEMP_LENGTH];
724 VM_SAFEPARMCOUNTRANGE(1, 8, VM_cvar_type);
725 VM_VarString(prog, 0, string, sizeof(string));
726 VM_CheckEmptyString(prog, string);
727 cvar = Cvar_FindVar(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask);
732 PRVM_G_FLOAT(OFS_RETURN) = 0;
733 return; // CVAR_TYPE_NONE
736 ret = 1; // CVAR_EXISTS
737 if(cvar->flags & CF_ARCHIVE)
738 ret |= 2; // CVAR_TYPE_SAVED
739 if(cvar->flags & CF_PRIVATE)
740 ret |= 4; // CVAR_TYPE_PRIVATE
741 if(!(cvar->flags & CF_ALLOCATED))
742 ret |= 8; // CVAR_TYPE_ENGINE
743 if(cvar->description != cvar_dummy_description)
744 ret |= 16; // CVAR_TYPE_HASDESCRIPTION
745 if(cvar->flags & CF_READONLY)
746 ret |= 32; // CVAR_TYPE_READONLY
748 PRVM_G_FLOAT(OFS_RETURN) = ret;
755 const string VM_cvar_string (string, ...)
758 void VM_cvar_string(prvm_prog_t *prog)
760 char string[VM_STRINGTEMP_LENGTH];
761 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_string);
762 VM_VarString(prog, 0, string, sizeof(string));
763 VM_CheckEmptyString(prog, string);
764 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_Cvar_ReadOk(prog, string) ? Cvar_VariableString(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask) : "");
769 ========================
772 const string VM_cvar_defstring (string, ...)
773 ========================
775 void VM_cvar_defstring(prvm_prog_t *prog)
777 char string[VM_STRINGTEMP_LENGTH];
778 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_defstring);
779 VM_VarString(prog, 0, string, sizeof(string));
780 VM_CheckEmptyString(prog, string);
781 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDefString(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask));
785 ========================
788 const string VM_cvar_description (string, ...)
789 ========================
791 void VM_cvar_description(prvm_prog_t *prog)
793 char string[VM_STRINGTEMP_LENGTH];
794 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_description);
795 VM_VarString(prog, 0, string, sizeof(string));
796 VM_CheckEmptyString(prog, string);
797 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDescription(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask));
803 void cvar_set (string,string, ...)
806 void VM_cvar_set(prvm_prog_t *prog)
809 char string[VM_STRINGTEMP_LENGTH];
810 VM_SAFEPARMCOUNTRANGE(2,8,VM_cvar_set);
811 VM_VarString(prog, 1, string, sizeof(string));
812 name = PRVM_G_STRING(OFS_PARM0);
813 VM_CheckEmptyString(prog, name);
814 Cvar_Set(prog->console_cmd->cvars, name, string);
824 void VM_dprint(prvm_prog_t *prog)
826 char string[VM_STRINGTEMP_LENGTH];
827 VM_SAFEPARMCOUNTRANGE(1, 8, VM_dprint);
828 VM_VarString(prog, 0, string, sizeof(string));
830 Con_DPrintf("%s", string);
832 Con_DPrintf("%s: %s", prog->name, string);
844 void VM_ftos(prvm_prog_t *prog)
849 VM_SAFEPARMCOUNT(1, VM_ftos);
851 v = PRVM_G_FLOAT(OFS_PARM0);
853 if ((prvm_vec_t)((prvm_int_t)v) == v)
854 dpsnprintf(s, sizeof(s), "%.0f", v);
856 dpsnprintf(s, sizeof(s), "%f", v);
857 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
868 void VM_fabs(prvm_prog_t *prog)
872 VM_SAFEPARMCOUNT(1,VM_fabs);
874 v = PRVM_G_FLOAT(OFS_PARM0);
875 PRVM_G_FLOAT(OFS_RETURN) = fabs(v);
886 void VM_vtos(prvm_prog_t *prog)
890 VM_SAFEPARMCOUNT(1,VM_vtos);
892 dpsnprintf (s, sizeof(s), "'%5.1f %5.1f %5.1f'", PRVM_G_VECTOR(OFS_PARM0)[0], PRVM_G_VECTOR(OFS_PARM0)[1], PRVM_G_VECTOR(OFS_PARM0)[2]);
893 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
904 void VM_etos(prvm_prog_t *prog)
908 VM_SAFEPARMCOUNT(1, VM_etos);
910 dpsnprintf (s, sizeof(s), "entity %i", PRVM_G_EDICTNUM(OFS_PARM0));
911 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
918 float stof(...[string])
921 void VM_stof(prvm_prog_t *prog)
923 char string[VM_STRINGTEMP_LENGTH];
924 VM_SAFEPARMCOUNTRANGE(1, 8, VM_stof);
925 VM_VarString(prog, 0, string, sizeof(string));
926 PRVM_G_FLOAT(OFS_RETURN) = atof(string);
930 ========================
934 ========================
936 void VM_itof(prvm_prog_t *prog)
938 VM_SAFEPARMCOUNT(1, VM_itof);
939 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
943 ========================
946 entity ftoe(float num)
947 ========================
949 void VM_ftoe(prvm_prog_t *prog)
952 VM_SAFEPARMCOUNT(1, VM_ftoe);
954 ent = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM0);
955 if (ent < 0 || ent >= prog->max_edicts || PRVM_PROG_TO_EDICT(ent)->free)
956 ent = 0; // return world instead of a free or invalid entity
958 PRVM_G_INT(OFS_RETURN) = ent;
962 ========================
965 float etof(entity ent)
966 ========================
968 void VM_etof(prvm_prog_t *prog)
970 VM_SAFEPARMCOUNT(1, VM_etof);
971 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICTNUM(OFS_PARM0);
978 string strftime(float uselocaltime, string[, string ...])
981 void VM_strftime(prvm_prog_t *prog)
990 char fmt[VM_STRINGTEMP_LENGTH];
991 char result[VM_STRINGTEMP_LENGTH];
992 VM_SAFEPARMCOUNTRANGE(2, 8, VM_strftime);
993 VM_VarString(prog, 1, fmt, sizeof(fmt));
996 if (PRVM_G_FLOAT(OFS_PARM0))
997 tmresult = localtime_s(&tm, &t);
999 tmresult = gmtime_s(&tm, &t);
1002 if (PRVM_G_FLOAT(OFS_PARM0))
1009 PRVM_G_INT(OFS_RETURN) = 0;
1012 #if _MSC_VER >= 1400
1013 strftime(result, sizeof(result), fmt, &tm);
1015 strftime(result, sizeof(result), fmt, tm);
1017 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, result);
1028 void VM_spawn(prvm_prog_t *prog)
1031 VM_SAFEPARMCOUNT(0, VM_spawn);
1032 prog->xfunction->builtinsprofile += 20;
1033 ed = PRVM_ED_Alloc(prog);
1034 VM_RETURN_EDICT(ed);
1045 void VM_remove(prvm_prog_t *prog)
1048 prog->xfunction->builtinsprofile += 20;
1050 VM_SAFEPARMCOUNT(1, VM_remove);
1052 ed = PRVM_G_EDICT(OFS_PARM0);
1053 if( PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
1055 if (developer.integer > 0)
1056 VM_Warning(prog, "VM_remove: tried to remove the null entity or a reserved entity!\n" );
1060 if (developer.integer > 0)
1061 VM_Warning(prog, "VM_remove: tried to remove an already freed entity!\n" );
1064 PRVM_ED_Free (prog, ed);
1071 entity find(entity start, .string field, string match)
1075 void VM_find(prvm_prog_t *prog)
1082 VM_SAFEPARMCOUNT(3,VM_find);
1084 e = PRVM_G_EDICTNUM(OFS_PARM0);
1085 f = PRVM_G_INT(OFS_PARM1);
1086 s = PRVM_G_STRING(OFS_PARM2);
1088 // LadyHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1089 // expects it to find all the monsters, so we must be careful to support
1092 for (e++ ; e < prog->num_edicts ; e++)
1094 prog->xfunction->builtinsprofile++;
1095 ed = PRVM_EDICT_NUM(e);
1098 t = PRVM_E_STRING(ed,f);
1103 VM_RETURN_EDICT(ed);
1108 VM_RETURN_EDICT(prog->edicts);
1115 entity findfloat(entity start, .float field, float match)
1116 entity findentity(entity start, .entity field, entity match)
1119 // LadyHavoc: added this for searching float, int, and entity reference fields
1120 void VM_findfloat(prvm_prog_t *prog)
1127 VM_SAFEPARMCOUNT(3,VM_findfloat);
1129 e = PRVM_G_EDICTNUM(OFS_PARM0);
1130 f = PRVM_G_INT(OFS_PARM1);
1131 s = PRVM_G_FLOAT(OFS_PARM2);
1133 for (e++ ; e < prog->num_edicts ; e++)
1135 prog->xfunction->builtinsprofile++;
1136 ed = PRVM_EDICT_NUM(e);
1139 if (PRVM_E_FLOAT(ed,f) == s)
1141 VM_RETURN_EDICT(ed);
1146 VM_RETURN_EDICT(prog->edicts);
1153 entity findchain(.string field, string match)
1156 // chained search for strings in entity fields
1157 // entity(.string field, string match) findchain = #402;
1158 void VM_findchain(prvm_prog_t *prog)
1163 prvm_edict_t *ent, *chain;
1166 VM_SAFEPARMCOUNTRANGE(2,3,VM_findchain);
1169 chainfield = PRVM_G_INT(OFS_PARM2);
1171 chainfield = prog->fieldoffsets.chain;
1173 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1175 chain = prog->edicts;
1177 f = PRVM_G_INT(OFS_PARM0);
1178 s = PRVM_G_STRING(OFS_PARM1);
1180 // LadyHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1181 // expects it to find all the monsters, so we must be careful to support
1184 ent = PRVM_NEXT_EDICT(prog->edicts);
1185 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1187 prog->xfunction->builtinsprofile++;
1190 t = PRVM_E_STRING(ent,f);
1196 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_NUM_FOR_EDICT(chain);
1200 VM_RETURN_EDICT(chain);
1207 entity findchainfloat(.string field, float match)
1208 entity findchainentity(.string field, entity match)
1211 // LadyHavoc: chained search for float, int, and entity reference fields
1212 // entity(.string field, float match) findchainfloat = #403;
1213 void VM_findchainfloat(prvm_prog_t *prog)
1218 prvm_edict_t *ent, *chain;
1221 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainfloat);
1224 chainfield = PRVM_G_INT(OFS_PARM2);
1226 chainfield = prog->fieldoffsets.chain;
1228 prog->error_cmd("VM_findchainfloat: %s doesnt have the specified chain field !", prog->name);
1230 chain = (prvm_edict_t *)prog->edicts;
1232 f = PRVM_G_INT(OFS_PARM0);
1233 s = PRVM_G_FLOAT(OFS_PARM1);
1235 ent = PRVM_NEXT_EDICT(prog->edicts);
1236 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1238 prog->xfunction->builtinsprofile++;
1241 if (PRVM_E_FLOAT(ent,f) != s)
1244 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1248 VM_RETURN_EDICT(chain);
1252 ========================
1255 entity findflags(entity start, .float field, float match)
1256 ========================
1258 // LadyHavoc: search for flags in float fields
1259 void VM_findflags(prvm_prog_t *prog)
1266 VM_SAFEPARMCOUNT(3, VM_findflags);
1269 e = PRVM_G_EDICTNUM(OFS_PARM0);
1270 f = PRVM_G_INT(OFS_PARM1);
1271 s = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM2);
1273 for (e++ ; e < prog->num_edicts ; e++)
1275 prog->xfunction->builtinsprofile++;
1276 ed = PRVM_EDICT_NUM(e);
1279 if (!PRVM_E_FLOAT(ed,f))
1281 if ((prvm_int_t)PRVM_E_FLOAT(ed,f) & s)
1283 VM_RETURN_EDICT(ed);
1288 VM_RETURN_EDICT(prog->edicts);
1292 ========================
1295 entity findchainflags(.float field, float match)
1296 ========================
1298 // LadyHavoc: chained search for flags in float fields
1299 void VM_findchainflags(prvm_prog_t *prog)
1304 prvm_edict_t *ent, *chain;
1307 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainflags);
1310 chainfield = PRVM_G_INT(OFS_PARM2);
1312 chainfield = prog->fieldoffsets.chain;
1314 prog->error_cmd("VM_findchainflags: %s doesnt have the specified chain field !", prog->name);
1316 chain = (prvm_edict_t *)prog->edicts;
1318 f = PRVM_G_INT(OFS_PARM0);
1319 s = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM1);
1321 ent = PRVM_NEXT_EDICT(prog->edicts);
1322 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1324 prog->xfunction->builtinsprofile++;
1327 if (!PRVM_E_FLOAT(ent,f))
1329 if (!((prvm_int_t)PRVM_E_FLOAT(ent,f) & s))
1332 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1336 VM_RETURN_EDICT(chain);
1343 string precache_sound (string sample)
1346 void VM_precache_sound(prvm_prog_t *prog)
1350 VM_SAFEPARMCOUNT(1, VM_precache_sound);
1352 s = PRVM_G_STRING(OFS_PARM0);
1353 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1354 //VM_CheckEmptyString(prog, s);
1356 if(snd_initialized.integer && !S_PrecacheSound(s, true, true))
1358 VM_Warning(prog, "VM_precache_sound: Failed to load %s for %s\n", s, prog->name);
1367 returns the same string as output
1369 does nothing, only used by qcc to build .pak archives
1372 void VM_precache_file(prvm_prog_t *prog)
1374 VM_SAFEPARMCOUNT(1,VM_precache_file);
1375 // precache_file is only used to copy files with qcc, it does nothing
1376 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1386 void VM_coredump(prvm_prog_t *prog)
1388 VM_SAFEPARMCOUNT(0,VM_coredump);
1390 Cbuf_AddText(cmd_local, "prvm_edicts ");
1391 Cbuf_AddText(cmd_local, prog->name);
1392 Cbuf_AddText(cmd_local, "\n");
1402 void VM_stackdump(prvm_prog_t *prog)
1404 VM_SAFEPARMCOUNT(0, VM_stackdump);
1406 PRVM_StackTrace(prog);
1417 void VM_crash(prvm_prog_t *prog)
1419 VM_SAFEPARMCOUNT(0, VM_crash);
1421 prog->error_cmd("Crash called by %s",prog->name);
1431 void VM_traceon(prvm_prog_t *prog)
1433 VM_SAFEPARMCOUNT(0,VM_traceon);
1445 void VM_traceoff(prvm_prog_t *prog)
1447 VM_SAFEPARMCOUNT(0,VM_traceoff);
1449 prog->trace = false;
1459 void VM_eprint(prvm_prog_t *prog)
1461 VM_SAFEPARMCOUNT(1,VM_eprint);
1463 PRVM_ED_PrintNum (prog, PRVM_G_EDICTNUM(OFS_PARM0), NULL);
1473 void VM_rint(prvm_prog_t *prog)
1476 VM_SAFEPARMCOUNT(1,VM_rint);
1478 f = PRVM_G_FLOAT(OFS_PARM0);
1480 PRVM_G_FLOAT(OFS_RETURN) = floor(f + 0.5);
1482 PRVM_G_FLOAT(OFS_RETURN) = ceil(f - 0.5);
1492 void VM_floor(prvm_prog_t *prog)
1494 VM_SAFEPARMCOUNT(1,VM_floor);
1496 PRVM_G_FLOAT(OFS_RETURN) = floor(PRVM_G_FLOAT(OFS_PARM0));
1506 void VM_ceil(prvm_prog_t *prog)
1508 VM_SAFEPARMCOUNT(1,VM_ceil);
1510 PRVM_G_FLOAT(OFS_RETURN) = ceil(PRVM_G_FLOAT(OFS_PARM0));
1518 entity nextent(entity)
1521 void VM_nextent(prvm_prog_t *prog)
1526 VM_SAFEPARMCOUNT(1, VM_nextent);
1528 i = PRVM_G_EDICTNUM(OFS_PARM0);
1531 prog->xfunction->builtinsprofile++;
1533 if (i == prog->num_edicts)
1535 VM_RETURN_EDICT(prog->edicts);
1538 ent = PRVM_EDICT_NUM(i);
1541 VM_RETURN_EDICT(ent);
1547 //=============================================================================
1554 changelevel(string map)
1557 void VM_changelevel(prvm_prog_t *prog)
1560 VM_SAFEPARMCOUNT(1, VM_changelevel);
1564 VM_Warning(prog, "VM_changelevel: game is not server (%s)\n", prog->name);
1568 // make sure we don't issue two changelevels
1569 if (svs.changelevel_issued)
1571 svs.changelevel_issued = true;
1573 Cbuf_AddText(cmd_local, va(vabuf, sizeof(vabuf), "changelevel %s\n", PRVM_G_STRING(OFS_PARM0)));
1583 void VM_sin(prvm_prog_t *prog)
1585 VM_SAFEPARMCOUNT(1,VM_sin);
1586 PRVM_G_FLOAT(OFS_RETURN) = sin(PRVM_G_FLOAT(OFS_PARM0));
1595 void VM_cos(prvm_prog_t *prog)
1597 VM_SAFEPARMCOUNT(1,VM_cos);
1598 PRVM_G_FLOAT(OFS_RETURN) = cos(PRVM_G_FLOAT(OFS_PARM0));
1608 void VM_sqrt(prvm_prog_t *prog)
1610 VM_SAFEPARMCOUNT(1,VM_sqrt);
1611 PRVM_G_FLOAT(OFS_RETURN) = sqrt(PRVM_G_FLOAT(OFS_PARM0));
1621 void VM_asin(prvm_prog_t *prog)
1623 VM_SAFEPARMCOUNT(1,VM_asin);
1624 PRVM_G_FLOAT(OFS_RETURN) = asin(PRVM_G_FLOAT(OFS_PARM0));
1633 void VM_acos(prvm_prog_t *prog)
1635 VM_SAFEPARMCOUNT(1,VM_acos);
1636 PRVM_G_FLOAT(OFS_RETURN) = acos(PRVM_G_FLOAT(OFS_PARM0));
1645 void VM_atan(prvm_prog_t *prog)
1647 VM_SAFEPARMCOUNT(1,VM_atan);
1648 PRVM_G_FLOAT(OFS_RETURN) = atan(PRVM_G_FLOAT(OFS_PARM0));
1654 float atan2(float,float)
1657 void VM_atan2(prvm_prog_t *prog)
1659 VM_SAFEPARMCOUNT(2,VM_atan2);
1660 PRVM_G_FLOAT(OFS_RETURN) = atan2(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1669 void VM_tan(prvm_prog_t *prog)
1671 VM_SAFEPARMCOUNT(1,VM_tan);
1672 PRVM_G_FLOAT(OFS_RETURN) = tan(PRVM_G_FLOAT(OFS_PARM0));
1679 Returns a vector of length < 1 and > 0
1684 void VM_randomvec(prvm_prog_t *prog)
1687 VM_SAFEPARMCOUNT(0, VM_randomvec);
1689 VectorCopy(temp, PRVM_G_VECTOR(OFS_RETURN));
1692 //=============================================================================
1698 float registercvar (string name, string value[, float flags])
1701 void VM_registercvar(prvm_prog_t *prog)
1703 const char *name, *value;
1706 VM_SAFEPARMCOUNTRANGE(2, 3, VM_registercvar);
1708 name = PRVM_G_STRING(OFS_PARM0);
1709 value = PRVM_G_STRING(OFS_PARM1);
1710 flags = prog->argc >= 3 ? (int)PRVM_G_FLOAT(OFS_PARM2) : 0;
1711 PRVM_G_FLOAT(OFS_RETURN) = 0;
1713 if(flags > CF_MAXFLAGSVAL)
1716 // first check to see if it has already been defined
1717 if (Cvar_FindVar (prog->console_cmd->cvars, name, prog->console_cmd->cvars_flagsmask))
1720 // check for overlap with a command
1721 if (Cmd_Exists(cmd_local, name))
1723 VM_Warning(prog, "VM_registercvar: %s is a command\n", name);
1727 Cvar_Get(prog->console_cmd->cvars, name, value, prog->console_cmd->cvars_flagsmask | flags, NULL);
1729 PRVM_G_FLOAT(OFS_RETURN) = 1; // success
1737 returns the minimum of two supplied floats
1739 float min(float a, float b, ...[float])
1742 void VM_min(prvm_prog_t *prog)
1744 VM_SAFEPARMCOUNTRANGE(2, 8, VM_min);
1745 // LadyHavoc: 3+ argument enhancement suggested by FrikaC
1746 if (prog->argc >= 3)
1749 float f = PRVM_G_FLOAT(OFS_PARM0);
1750 for (i = 1;i < prog->argc;i++)
1751 if (f > PRVM_G_FLOAT((OFS_PARM0+i*3)))
1752 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1753 PRVM_G_FLOAT(OFS_RETURN) = f;
1756 PRVM_G_FLOAT(OFS_RETURN) = min(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1763 returns the maximum of two supplied floats
1765 float max(float a, float b, ...[float])
1768 void VM_max(prvm_prog_t *prog)
1770 VM_SAFEPARMCOUNTRANGE(2, 8, VM_max);
1771 // LadyHavoc: 3+ argument enhancement suggested by FrikaC
1772 if (prog->argc >= 3)
1775 float f = PRVM_G_FLOAT(OFS_PARM0);
1776 for (i = 1;i < prog->argc;i++)
1777 if (f < PRVM_G_FLOAT((OFS_PARM0+i*3)))
1778 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1779 PRVM_G_FLOAT(OFS_RETURN) = f;
1782 PRVM_G_FLOAT(OFS_RETURN) = max(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1789 returns number bounded by supplied range
1791 float bound(float min, float value, float max)
1794 void VM_bound(prvm_prog_t *prog)
1796 VM_SAFEPARMCOUNT(3,VM_bound);
1797 PRVM_G_FLOAT(OFS_RETURN) = bound(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1), PRVM_G_FLOAT(OFS_PARM2));
1804 returns a raised to power b
1806 float pow(float a, float b)
1809 void VM_pow(prvm_prog_t *prog)
1811 VM_SAFEPARMCOUNT(2,VM_pow);
1812 PRVM_G_FLOAT(OFS_RETURN) = pow(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1815 void VM_log(prvm_prog_t *prog)
1817 VM_SAFEPARMCOUNT(1,VM_log);
1818 PRVM_G_FLOAT(OFS_RETURN) = log(PRVM_G_FLOAT(OFS_PARM0));
1821 void VM_Files_Init(prvm_prog_t *prog)
1824 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1825 prog->openfiles[i] = NULL;
1828 void VM_Files_CloseAll(prvm_prog_t *prog)
1831 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1833 if (prog->openfiles[i])
1834 FS_Close(prog->openfiles[i]);
1835 prog->openfiles[i] = NULL;
1839 static qfile_t *VM_GetFileHandle(prvm_prog_t *prog, int index)
1841 if (index < 0 || index >= PRVM_MAX_OPENFILES)
1843 Con_Printf("VM_GetFileHandle: invalid file handle %i used in %s\n", index, prog->name);
1846 if (prog->openfiles[index] == NULL)
1848 Con_Printf("VM_GetFileHandle: no such file handle %i (or file has been closed) in %s\n", index, prog->name);
1851 return prog->openfiles[index];
1858 float fopen(string filename, float mode)
1861 // float(string filename, float mode) fopen = #110;
1862 // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE),
1863 // returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason
1864 void VM_fopen(prvm_prog_t *prog)
1867 const char *modestring, *filename;
1870 VM_SAFEPARMCOUNT(2,VM_fopen);
1872 for (filenum = 0;filenum < PRVM_MAX_OPENFILES;filenum++)
1873 if (prog->openfiles[filenum] == NULL)
1875 if (filenum >= PRVM_MAX_OPENFILES)
1877 PRVM_G_FLOAT(OFS_RETURN) = -2;
1878 VM_Warning(prog, "VM_fopen: %s ran out of file handles (%i)\n", prog->name, PRVM_MAX_OPENFILES);
1881 filename = PRVM_G_STRING(OFS_PARM0);
1882 mode = (int)PRVM_G_FLOAT(OFS_PARM1);
1885 case 0: // FILE_READ
1887 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
1888 if (prog->openfiles[filenum] == NULL)
1889 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
1891 case 1: // FILE_APPEND
1893 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1895 case 2: // FILE_WRITE
1897 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1900 PRVM_G_FLOAT(OFS_RETURN) = -3;
1901 VM_Warning(prog, "VM_fopen: %s: no such mode %i (valid: 0 = read, 1 = append, 2 = write)\n", prog->name, mode);
1905 if (prog->openfiles[filenum] == NULL)
1907 PRVM_G_FLOAT(OFS_RETURN) = -1;
1908 if (developer_extra.integer)
1909 VM_Warning(prog, "VM_fopen: %s: %s mode %s failed\n", prog->name, filename, modestring);
1913 PRVM_G_FLOAT(OFS_RETURN) = filenum;
1914 if (developer_extra.integer)
1915 Con_DPrintf("VM_fopen: %s: %s mode %s opened as #%i\n", prog->name, filename, modestring, filenum);
1916 prog->openfiles_origin[filenum] = PRVM_AllocationOrigin(prog);
1924 fclose(float fhandle)
1927 //void(float fhandle) fclose = #111; // closes a file
1928 void VM_fclose(prvm_prog_t *prog)
1932 VM_SAFEPARMCOUNT(1,VM_fclose);
1934 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1935 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1937 VM_Warning(prog, "VM_fclose: invalid file handle %i used in %s\n", filenum, prog->name);
1940 if (prog->openfiles[filenum] == NULL)
1942 VM_Warning(prog, "VM_fclose: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1945 FS_Close(prog->openfiles[filenum]);
1946 prog->openfiles[filenum] = NULL;
1947 if(prog->openfiles_origin[filenum])
1948 PRVM_Free((char *)prog->openfiles_origin[filenum]);
1949 if (developer_extra.integer)
1950 Con_DPrintf("VM_fclose: %s: #%i closed\n", prog->name, filenum);
1957 string fgets(float fhandle)
1960 //string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring
1961 void VM_fgets(prvm_prog_t *prog)
1964 char string[VM_STRINGTEMP_LENGTH];
1967 VM_SAFEPARMCOUNT(1,VM_fgets);
1969 // set the return value regardless of any possible errors
1970 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
1972 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1973 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1975 VM_Warning(prog, "VM_fgets: invalid file handle %i used in %s\n", filenum, prog->name);
1978 if (prog->openfiles[filenum] == NULL)
1980 VM_Warning(prog, "VM_fgets: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1986 c = FS_Getc(prog->openfiles[filenum]);
1987 if (c == '\r' || c == '\n' || c < 0)
1989 if (end < VM_STRINGTEMP_LENGTH - 1)
1993 // remove \n following \r
1996 c = FS_Getc(prog->openfiles[filenum]);
1998 FS_UnGetc(prog->openfiles[filenum], (unsigned char)c);
2000 if (developer_extra.integer)
2001 Con_DPrintf("fgets: %s: %s\n", prog->name, string);
2003 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2010 fputs(float fhandle, string s)
2013 //void(float fhandle, string s) fputs = #113; // writes a line of text to the end of the file
2014 void VM_fputs(prvm_prog_t *prog)
2017 char string[VM_STRINGTEMP_LENGTH];
2020 VM_SAFEPARMCOUNT(2,VM_fputs);
2022 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
2023 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
2025 VM_Warning(prog, "VM_fputs: invalid file handle %i used in %s\n", filenum, prog->name);
2028 if (prog->openfiles[filenum] == NULL)
2030 VM_Warning(prog, "VM_fputs: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
2033 VM_VarString(prog, 1, string, sizeof(string));
2034 if ((stringlength = (int)strlen(string)))
2035 FS_Write(prog->openfiles[filenum], string, stringlength);
2036 if (developer_extra.integer)
2037 Con_DPrintf("fputs: %s: %s\n", prog->name, string);
2044 writetofile(float fhandle, entity ent)
2047 void VM_writetofile(prvm_prog_t *prog)
2052 VM_SAFEPARMCOUNT(2, VM_writetofile);
2054 file = VM_GetFileHandle(prog, (int)PRVM_G_FLOAT(OFS_PARM0));
2057 VM_Warning(prog, "VM_writetofile: invalid or closed file handle\n");
2061 ent = PRVM_G_EDICT(OFS_PARM1);
2064 VM_Warning(prog, "VM_writetofile: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2068 PRVM_ED_Write (prog, file, ent);
2071 // KrimZon - DP_QC_ENTITYDATA
2076 float() numentityfields
2077 Return the number of entity fields - NOT offsets
2080 void VM_numentityfields(prvm_prog_t *prog)
2082 PRVM_G_FLOAT(OFS_RETURN) = prog->numfielddefs;
2085 // KrimZon - DP_QC_ENTITYDATA
2090 string(float fieldnum) entityfieldname
2091 Return name of the specified field as a string, or empty if the field is invalid (warning)
2094 void VM_entityfieldname(prvm_prog_t *prog)
2097 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2099 if (i < 0 || i >= prog->numfielddefs)
2101 VM_Warning(prog, "VM_entityfieldname: %s: field index out of bounds\n", prog->name);
2102 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2106 d = &prog->fielddefs[i];
2107 PRVM_G_INT(OFS_RETURN) = d->s_name; // presuming that s_name points to a string already
2110 // KrimZon - DP_QC_ENTITYDATA
2115 float(float fieldnum) entityfieldtype
2118 void VM_entityfieldtype(prvm_prog_t *prog)
2121 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2123 if (i < 0 || i >= prog->numfielddefs)
2125 VM_Warning(prog, "VM_entityfieldtype: %s: field index out of bounds\n", prog->name);
2126 PRVM_G_FLOAT(OFS_RETURN) = -1.0;
2130 d = &prog->fielddefs[i];
2131 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t)d->type;
2134 // KrimZon - DP_QC_ENTITYDATA
2137 VM_getentityfieldstring
2139 string(float fieldnum, entity ent) getentityfieldstring
2142 void VM_getentityfieldstring(prvm_prog_t *prog)
2144 // put the data into a string
2149 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2150 char valuebuf[MAX_INPUTLINE];
2152 if (i < 0 || i >= prog->numfielddefs)
2154 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2155 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2159 d = &prog->fielddefs[i];
2162 ent = PRVM_G_EDICT(OFS_PARM1);
2165 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2166 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2169 val = (prvm_eval_t *)(ent->fields.fp + d->ofs);
2171 // if it's 0 or blank, return an empty string
2172 type = d->type & ~DEF_SAVEGLOBAL;
2173 for (j=0 ; j<prvm_type_size[type] ; j++)
2174 if (val->ivector[j])
2176 if (j == prvm_type_size[type])
2178 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2182 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_UglyValueString(prog, (etype_t)d->type, val, valuebuf, sizeof(valuebuf)));
2185 // KrimZon - DP_QC_ENTITYDATA
2188 VM_putentityfieldstring
2190 float(float fieldnum, entity ent, string s) putentityfieldstring
2193 void VM_putentityfieldstring(prvm_prog_t *prog)
2197 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2199 if (i < 0 || i >= prog->numfielddefs)
2201 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2202 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2206 d = &prog->fielddefs[i];
2209 ent = PRVM_G_EDICT(OFS_PARM1);
2212 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2213 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2217 // parse the string into the value
2218 PRVM_G_FLOAT(OFS_RETURN) = ( PRVM_ED_ParseEpair(prog, ent, d, PRVM_G_STRING(OFS_PARM2), false) ) ? 1.0f : 0.0f;
2225 float strlen(string s)
2228 //float(string s) strlen = #114; // returns how many characters are in a string
2229 void VM_strlen(prvm_prog_t *prog)
2231 VM_SAFEPARMCOUNT(1,VM_strlen);
2233 //PRVM_G_FLOAT(OFS_RETURN) = strlen(PRVM_G_STRING(OFS_PARM0));
2234 PRVM_G_FLOAT(OFS_RETURN) = u8_strlen(PRVM_G_STRING(OFS_PARM0));
2237 // DRESK - Decolorized String
2242 string strdecolorize(string s)
2245 // string (string s) strdecolorize = #472; // returns the passed in string with color codes stripped
2246 void VM_strdecolorize(prvm_prog_t *prog)
2248 char szNewString[VM_STRINGTEMP_LENGTH];
2249 const char *szString;
2252 VM_SAFEPARMCOUNT(1,VM_strdecolorize);
2253 szString = PRVM_G_STRING(OFS_PARM0);
2254 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), true);
2255 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2258 // DRESK - String Length (not counting color codes)
2263 float strlennocol(string s)
2266 // float(string s) strlennocol = #471; // returns how many characters are in a string not including color codes
2267 // For example, ^2Dresk returns a length of 5
2268 void VM_strlennocol(prvm_prog_t *prog)
2270 const char *szString;
2273 VM_SAFEPARMCOUNT(1,VM_strlennocol);
2275 szString = PRVM_G_STRING(OFS_PARM0);
2277 //nCnt = (int)COM_StringLengthNoColors(szString, 0, NULL);
2278 nCnt = (int)u8_COM_StringLengthNoColors(szString, 0, NULL);
2280 PRVM_G_FLOAT(OFS_RETURN) = nCnt;
2283 // DRESK - String to Uppercase and Lowercase
2288 string strtolower(string s)
2291 // string (string s) strtolower = #480; // returns passed in string in lowercase form
2292 void VM_strtolower(prvm_prog_t *prog)
2294 char szNewString[VM_STRINGTEMP_LENGTH];
2295 const char *szString;
2298 VM_SAFEPARMCOUNT(1,VM_strtolower);
2299 szString = PRVM_G_STRING(OFS_PARM0);
2301 COM_ToLowerString(szString, szNewString, sizeof(szNewString) );
2303 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2310 string strtoupper(string s)
2313 // string (string s) strtoupper = #481; // returns passed in string in uppercase form
2314 void VM_strtoupper(prvm_prog_t *prog)
2316 char szNewString[VM_STRINGTEMP_LENGTH];
2317 const char *szString;
2320 VM_SAFEPARMCOUNT(1,VM_strtoupper);
2321 szString = PRVM_G_STRING(OFS_PARM0);
2323 COM_ToUpperString(szString, szNewString, sizeof(szNewString) );
2325 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2332 string strcat(string s, string...)
2335 //string(string s, string...) strcat = #115;
2336 // concatenates strings (for example "abc", "def" would return "abcdef")
2337 // and returns as a tempstring
2338 void VM_strcat(prvm_prog_t *prog)
2340 char s[VM_STRINGTEMP_LENGTH];
2341 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strcat);
2343 VM_VarString(prog, 0, s, sizeof(s));
2344 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
2351 string substring(string s, float start, float length)
2354 // string(string s, float start, float length) substring = #116;
2355 // returns a section of a string as a tempstring
2356 void VM_substring(prvm_prog_t *prog)
2359 int u_slength = 0, u_start;
2362 char string[VM_STRINGTEMP_LENGTH];
2364 VM_SAFEPARMCOUNT(3,VM_substring);
2367 s = PRVM_G_STRING(OFS_PARM0);
2368 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2369 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2370 slength = strlen(s);
2372 if (start < 0) // FTE_STRINGS feature
2374 start = bound(0, start, slength);
2376 if (length < 0) // FTE_STRINGS feature
2377 length += slength - start + 1;
2378 maxlen = min((int)sizeof(string) - 1, slength - start);
2379 length = bound(0, length, maxlen);
2381 memcpy(string, s + start, length);
2383 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2386 s = PRVM_G_STRING(OFS_PARM0);
2387 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2388 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2390 if (start < 0) // FTE_STRINGS feature
2392 u_slength = (int)u8_strlen(s);
2394 start = bound(0, start, u_slength);
2397 if (length < 0) // FTE_STRINGS feature
2399 if (!u_slength) // it's not calculated when it's not needed above
2400 u_slength = (int)u8_strlen(s);
2401 length += u_slength - start + 1;
2404 // positive start, positive length
2405 u_start = u8_byteofs(s, start, NULL);
2408 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2411 u_length = u8_bytelen(s + u_start, length);
2412 if (u_length >= sizeof(string)-1)
2413 u_length = sizeof(string)-1;
2415 memcpy(string, s + u_start, u_length);
2416 string[u_length] = 0;
2417 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2424 string(string search, string replace, string subject) strreplace = #484;
2427 // replaces all occurrences of search with replace in the string subject, and returns the result
2428 void VM_strreplace(prvm_prog_t *prog)
2431 const char *search, *replace, *subject;
2432 char string[VM_STRINGTEMP_LENGTH];
2433 int search_len, replace_len, subject_len;
2435 VM_SAFEPARMCOUNT(3,VM_strreplace);
2437 search = PRVM_G_STRING(OFS_PARM0);
2438 replace = PRVM_G_STRING(OFS_PARM1);
2439 subject = PRVM_G_STRING(OFS_PARM2);
2441 search_len = (int)strlen(search);
2442 replace_len = (int)strlen(replace);
2443 subject_len = (int)strlen(subject);
2446 for (i = 0; i <= subject_len - search_len; i++)
2448 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2449 if (subject[i+j] != search[j])
2451 if (j == search_len)
2453 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2454 // found it at offset 'i'
2455 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2456 string[si++] = replace[j];
2459 i += search_len - 1;
2463 // the above would subtract 1 from i... so we
2464 // don't do that, but instead output the next
2466 if (si < (int)sizeof(string) - 1)
2467 string[si++] = subject[i];
2472 // in THIS case, we know search_len > 0, thus i < subject_len
2474 if (si < (int)sizeof(string) - 1)
2475 string[si++] = subject[i];
2478 // remaining chars (these cannot match)
2479 for (; i < subject_len; i++)
2480 if (si < (int)sizeof(string) - 1)
2481 string[si++] = subject[i];
2484 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2491 string(string search, string replace, string subject) strireplace = #485;
2494 // case-insensitive version of strreplace
2495 void VM_strireplace(prvm_prog_t *prog)
2498 const char *search, *replace, *subject;
2499 char string[VM_STRINGTEMP_LENGTH];
2500 int search_len, replace_len, subject_len;
2502 VM_SAFEPARMCOUNT(3, VM_strireplace);
2504 search = PRVM_G_STRING(OFS_PARM0);
2505 replace = PRVM_G_STRING(OFS_PARM1);
2506 subject = PRVM_G_STRING(OFS_PARM2);
2508 search_len = (int)strlen(search);
2509 replace_len = (int)strlen(replace);
2510 subject_len = (int)strlen(subject);
2513 for (i = 0; i <= subject_len - search_len; i++)
2515 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2516 if (tolower(subject[i+j]) != tolower(search[j]))
2518 if (j == search_len)
2520 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2521 // found it at offset 'i'
2522 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2523 string[si++] = replace[j];
2526 i += search_len - 1;
2530 // the above would subtract 1 from i... so we
2531 // don't do that, but instead output the next
2533 if (si < (int)sizeof(string) - 1)
2534 string[si++] = subject[i];
2539 // in THIS case, we know search_len > 0, thus i < subject_len
2541 if (si < (int)sizeof(string) - 1)
2542 string[si++] = subject[i];
2545 // remaining chars (these cannot match)
2546 for (; i < subject_len; i++)
2547 if (si < (int)sizeof(string) - 1)
2548 string[si++] = subject[i];
2551 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2558 vector stov(string s)
2561 //vector(string s) stov = #117; // returns vector value from a string
2562 void VM_stov(prvm_prog_t *prog)
2564 char string[VM_STRINGTEMP_LENGTH];
2566 VM_SAFEPARMCOUNT(1,VM_stov);
2568 VM_VarString(prog, 0, string, sizeof(string));
2569 Math_atov(string, PRVM_G_VECTOR(OFS_RETURN));
2576 string strzone(string s)
2579 //string(string s, ...) strzone = #118; // makes a copy of a string into the string zone and returns it, this is often used to keep around a tempstring for longer periods of time (tempstrings are replaced often)
2580 void VM_strzone(prvm_prog_t *prog)
2583 char string[VM_STRINGTEMP_LENGTH];
2586 VM_SAFEPARMCOUNT(1,VM_strzone);
2588 VM_VarString(prog, 0, string, sizeof(string));
2589 alloclen = strlen(string) + 1;
2590 PRVM_G_INT(OFS_RETURN) = PRVM_AllocString(prog, alloclen, &out);
2591 memcpy(out, string, alloclen);
2601 //void(string s) strunzone = #119; // removes a copy of a string from the string zone (you can not use that string again or it may crash!!!)
2602 void VM_strunzone(prvm_prog_t *prog)
2604 VM_SAFEPARMCOUNT(1,VM_strunzone);
2605 PRVM_FreeString(prog, PRVM_G_INT(OFS_PARM0));
2612 float tokenize(string s)
2615 //float(string s) tokenize = #441; // takes apart a string into individal words (access them with argv), returns how many
2616 //this function originally written by KrimZon, made shorter by LadyHavoc
2617 //20040203: rewritten by LadyHavoc (no longer uses allocations)
2618 static int num_tokens = 0;
2619 static int tokens[VM_STRINGTEMP_LENGTH / 2];
2620 static int tokens_startpos[VM_STRINGTEMP_LENGTH / 2];
2621 static int tokens_endpos[VM_STRINGTEMP_LENGTH / 2];
2622 static char tokenize_string[VM_STRINGTEMP_LENGTH];
2623 void VM_tokenize (prvm_prog_t *prog)
2627 VM_SAFEPARMCOUNT(1,VM_tokenize);
2629 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2630 p = tokenize_string;
2635 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2638 // skip whitespace here to find token start pos
2639 while(*p && ISWHITESPACE(*p))
2642 tokens_startpos[num_tokens] = p - tokenize_string;
2643 if(!COM_ParseToken_VM_Tokenize(&p, false))
2645 tokens_endpos[num_tokens] = p - tokenize_string;
2646 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2650 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2653 //float(string s) tokenize = #514; // takes apart a string into individal words (access them with argv), returns how many
2654 void VM_tokenize_console (prvm_prog_t *prog)
2658 VM_SAFEPARMCOUNT(1, VM_tokenize_console);
2660 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2661 p = tokenize_string;
2666 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2669 // skip whitespace here to find token start pos
2670 while(*p && ISWHITESPACE(*p))
2673 tokens_startpos[num_tokens] = p - tokenize_string;
2674 if(!COM_ParseToken_Console(&p))
2676 tokens_endpos[num_tokens] = p - tokenize_string;
2677 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2681 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2686 VM_tokenizebyseparator
2688 float tokenizebyseparator(string s, string separator1, ...)
2691 //float(string s, string separator1, ...) tokenizebyseparator = #479; // takes apart a string into individal words (access them with argv), returns how many
2692 //this function returns the token preceding each instance of a separator (of
2693 //which there can be multiple), and the text following the last separator
2694 //useful for parsing certain kinds of data like IP addresses
2696 //numnumbers = tokenizebyseparator("10.1.2.3", ".");
2697 //returns 4 and the tokens "10" "1" "2" "3".
2698 void VM_tokenizebyseparator (prvm_prog_t *prog)
2702 int separatorlen[7];
2703 const char *separators[7];
2706 char tokentext[MAX_INPUTLINE];
2708 VM_SAFEPARMCOUNTRANGE(2, 8,VM_tokenizebyseparator);
2710 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2711 p = tokenize_string;
2714 for (j = 1;j < prog->argc;j++)
2716 // skip any blank separator strings
2717 const char *s = PRVM_G_STRING(OFS_PARM0+j*3);
2720 separators[numseparators] = s;
2721 separatorlen[numseparators] = (int)strlen(s);
2728 while (num_tokens < (int)(sizeof(tokens)/sizeof(tokens[0])))
2730 token = tokentext + j;
2731 tokens_startpos[num_tokens] = p - tokenize_string;
2735 for (k = 0;k < numseparators;k++)
2737 if (!strncmp(p, separators[k], separatorlen[k]))
2739 p += separatorlen[k];
2743 if (k < numseparators)
2745 if (j < (int)sizeof(tokentext)-1)
2746 tokentext[j++] = *p;
2750 tokens_endpos[num_tokens] = p0 - tokenize_string;
2751 if (j >= (int)sizeof(tokentext))
2754 tokens[num_tokens++] = PRVM_SetTempString(prog, token);
2759 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2762 //string(float n) argv = #442; // returns a word from the tokenized string (returns nothing for an invalid index)
2763 //this function originally written by KrimZon, made shorter by LadyHavoc
2764 void VM_argv (prvm_prog_t *prog)
2768 VM_SAFEPARMCOUNT(1,VM_argv);
2770 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2773 token_num += num_tokens;
2775 if (token_num >= 0 && token_num < num_tokens)
2776 PRVM_G_INT(OFS_RETURN) = tokens[token_num];
2778 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2781 //float(float n) argv_start_index = #515; // returns the start index of a token
2782 void VM_argv_start_index (prvm_prog_t *prog)
2786 VM_SAFEPARMCOUNT(1,VM_argv);
2788 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2791 token_num += num_tokens;
2793 if (token_num >= 0 && token_num < num_tokens)
2794 PRVM_G_FLOAT(OFS_RETURN) = tokens_startpos[token_num];
2796 PRVM_G_FLOAT(OFS_RETURN) = -1;
2799 //float(float n) argv_end_index = #516; // returns the end index of a token
2800 void VM_argv_end_index (prvm_prog_t *prog)
2804 VM_SAFEPARMCOUNT(1,VM_argv);
2806 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2809 token_num += num_tokens;
2811 if (token_num >= 0 && token_num < num_tokens)
2812 PRVM_G_FLOAT(OFS_RETURN) = tokens_endpos[token_num];
2814 PRVM_G_FLOAT(OFS_RETURN) = -1;
2824 void VM_isserver(prvm_prog_t *prog)
2826 VM_SAFEPARMCOUNT(0, VM_isserver);
2828 PRVM_G_FLOAT(OFS_RETURN) = sv.active;
2838 void VM_clientcount(prvm_prog_t *prog)
2840 VM_SAFEPARMCOUNT(0,VM_clientcount);
2842 PRVM_G_FLOAT(OFS_RETURN) = svs.maxclients;
2852 void VM_clientstate(prvm_prog_t *prog)
2854 VM_SAFEPARMCOUNT(0,VM_clientstate);
2857 switch( cls.state ) {
2858 case ca_uninitialized:
2860 PRVM_G_FLOAT(OFS_RETURN) = 0;
2862 case ca_disconnected:
2863 PRVM_G_FLOAT(OFS_RETURN) = 1;
2866 PRVM_G_FLOAT(OFS_RETURN) = 2;
2869 // should never be reached!
2878 float getostype(prvm_prog_t *prog)
2880 */ // not used at the moment -> not included in the common list
2881 void VM_getostype(prvm_prog_t *prog)
2883 VM_SAFEPARMCOUNT(0,VM_getostype);
2888 OS_MAC - not supported
2892 PRVM_G_FLOAT(OFS_RETURN) = 0;
2893 #elif defined(MACOSX)
2894 PRVM_G_FLOAT(OFS_RETURN) = 2;
2896 PRVM_G_FLOAT(OFS_RETURN) = 1;
2904 float gettime(prvm_prog_t *prog)
2907 float CDAudio_GetPosition(void);
2908 void VM_gettime(prvm_prog_t *prog)
2912 VM_SAFEPARMCOUNTRANGE(0,1,VM_gettime);
2916 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t) host.realtime;
2920 timer_index = (int) PRVM_G_FLOAT(OFS_PARM0);
2923 case 0: // GETTIME_FRAMESTART
2924 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2926 case 1: // GETTIME_REALTIME
2927 PRVM_G_FLOAT(OFS_RETURN) = Sys_DirtyTime();
2929 case 2: // GETTIME_HIRES
2930 PRVM_G_FLOAT(OFS_RETURN) = (Sys_DirtyTime() - host.dirtytime);
2932 case 3: // GETTIME_UPTIME
2933 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2935 case 4: // GETTIME_CDTRACK
2936 PRVM_G_FLOAT(OFS_RETURN) = CDAudio_GetPosition();
2939 VM_Warning(prog, "VM_gettime: %s: unsupported timer specified, returning realtime\n", prog->name);
2940 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2950 float getsoundtime(prvm_prog_t *prog)
2954 void VM_getsoundtime (prvm_prog_t *prog)
2956 int entnum, entchannel;
2957 VM_SAFEPARMCOUNT(2,VM_getsoundtime);
2959 if (prog == SVVM_prog)
2960 entnum = PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2961 else if (prog == CLVM_prog)
2962 entnum = MAX_EDICTS + PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2965 VM_Warning(prog, "VM_getsoundtime: %s: not supported on this progs\n", prog->name);
2966 PRVM_G_FLOAT(OFS_RETURN) = -1;
2969 entchannel = (int)PRVM_G_FLOAT(OFS_PARM1);
2970 entchannel = CHAN_USER2ENGINE(entchannel);
2971 if (!IS_CHAN(entchannel))
2972 VM_Warning(prog, "VM_getsoundtime: %s: bad channel %i\n", prog->name, entchannel);
2973 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t)S_GetEntChannelPosition(entnum, entchannel);
2980 string soundlength (string sample)
2983 void VM_soundlength (prvm_prog_t *prog)
2987 VM_SAFEPARMCOUNT(1, VM_soundlength);
2989 s = PRVM_G_STRING(OFS_PARM0);
2990 PRVM_G_FLOAT(OFS_RETURN) = S_SoundLength(s);
2997 loadfromdata(string data)
3000 void VM_loadfromdata(prvm_prog_t *prog)
3002 VM_SAFEPARMCOUNT(1, VM_loadfromdata);
3004 PRVM_ED_LoadFromFile(prog, PRVM_G_STRING(OFS_PARM0));
3008 ========================
3011 parseentitydata(entity ent, string data)
3012 ========================
3014 void VM_parseentitydata(prvm_prog_t *prog)
3019 VM_SAFEPARMCOUNT(2, VM_parseentitydata);
3021 // get edict and test it
3022 ent = PRVM_G_EDICT(OFS_PARM0);
3024 prog->error_cmd("VM_parseentitydata: %s: Can only set already spawned entities (entity %i is free)!", prog->name, PRVM_NUM_FOR_EDICT(ent));
3026 data = PRVM_G_STRING(OFS_PARM1);
3028 // parse the opening brace
3029 if (!COM_ParseToken_Simple(&data, false, false, true) || com_token[0] != '{' )
3030 prog->error_cmd("VM_parseentitydata: %s: Couldn't parse entity data:\n%s", prog->name, data );
3032 PRVM_ED_ParseEdict (prog, data, ent);
3039 loadfromfile(string file)
3042 void VM_loadfromfile(prvm_prog_t *prog)
3044 const char *filename;
3047 VM_SAFEPARMCOUNT(1,VM_loadfromfile);
3049 filename = PRVM_G_STRING(OFS_PARM0);
3050 if (FS_CheckNastyPath(filename, false))
3052 PRVM_G_FLOAT(OFS_RETURN) = -4;
3053 VM_Warning(prog, "VM_loadfromfile: %s dangerous or non-portable filename \"%s\" not allowed. (contains : or \\ or begins with .. or /)\n", prog->name, filename);
3057 // not conform with VM_fopen
3058 data = (char *)FS_LoadFile(filename, tempmempool, false, NULL);
3060 PRVM_G_FLOAT(OFS_RETURN) = -1;
3062 PRVM_ED_LoadFromFile(prog, data);
3073 float mod(float val, float m)
3076 void VM_modulo(prvm_prog_t *prog)
3080 VM_SAFEPARMCOUNT(2, VM_modulo);
3082 val = PRVM_G_FLOAT(OFS_PARM0);
3083 m = PRVM_G_FLOAT(OFS_PARM1);
3085 // matches how gmqcc implements % when mod() builtin isn't defined, and FTEQW mod()
3087 PRVM_G_FLOAT(OFS_RETURN) = val - m * (prvm_int_t)(val / m);
3090 VM_Warning(prog, "Attempted modulo of %f by zero\n", val);
3091 PRVM_G_FLOAT(OFS_RETURN) = 0;
3095 static void VM_Search_Init(prvm_prog_t *prog)
3098 for (i = 0;i < PRVM_MAX_OPENSEARCHES;i++)
3099 prog->opensearches[i] = NULL;
3102 static void VM_Search_Reset(prvm_prog_t *prog)
3105 // reset the fssearch list
3106 for(i = 0; i < PRVM_MAX_OPENSEARCHES; i++)
3108 if(prog->opensearches[i])
3109 FS_FreeSearch(prog->opensearches[i]);
3110 prog->opensearches[i] = NULL;
3118 float search_begin(string pattern, float caseinsensitive, float quiet[, string packfile])
3121 void VM_search_begin(prvm_prog_t *prog)
3124 const char *packfile = NULL, *pattern;
3125 int caseinsens, quiet;
3127 VM_SAFEPARMCOUNTRANGE(3, 4, VM_search_begin);
3129 pattern = PRVM_G_STRING(OFS_PARM0);
3131 VM_CheckEmptyString(prog, pattern);
3133 caseinsens = (int)PRVM_G_FLOAT(OFS_PARM1);
3134 quiet = (int)PRVM_G_FLOAT(OFS_PARM2);
3136 // optional packfile parameter (DP_QC_FS_SEARCH_PACKFILE)
3138 packfile = PRVM_G_STRING(OFS_PARM3);
3140 for(handle = 0; handle < PRVM_MAX_OPENSEARCHES; handle++)
3141 if(!prog->opensearches[handle])
3144 if(handle >= PRVM_MAX_OPENSEARCHES)
3146 PRVM_G_FLOAT(OFS_RETURN) = -2;
3147 VM_Warning(prog, "VM_search_begin: %s ran out of search handles (%i)\n", prog->name, PRVM_MAX_OPENSEARCHES);
3151 if(!(prog->opensearches[handle] = FS_Search(pattern,caseinsens, quiet, packfile)))
3152 PRVM_G_FLOAT(OFS_RETURN) = -1;
3155 prog->opensearches_origin[handle] = PRVM_AllocationOrigin(prog);
3156 PRVM_G_FLOAT(OFS_RETURN) = handle;
3164 void search_end(float handle)
3167 void VM_search_end(prvm_prog_t *prog)
3170 VM_SAFEPARMCOUNT(1, VM_search_end);
3172 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3174 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3176 VM_Warning(prog, "VM_search_end: invalid handle %i used in %s\n", handle, prog->name);
3179 if(prog->opensearches[handle] == NULL)
3181 VM_Warning(prog, "VM_search_end: no such handle %i in %s\n", handle, prog->name);
3185 FS_FreeSearch(prog->opensearches[handle]);
3186 prog->opensearches[handle] = NULL;
3187 if(prog->opensearches_origin[handle])
3188 PRVM_Free((char *)prog->opensearches_origin[handle]);
3195 float search_getsize(float handle)
3198 void VM_search_getsize(prvm_prog_t *prog)
3201 VM_SAFEPARMCOUNT(1, VM_search_getsize);
3203 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3205 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3207 VM_Warning(prog, "VM_search_getsize: invalid handle %i used in %s\n", handle, prog->name);
3210 if(prog->opensearches[handle] == NULL)
3212 VM_Warning(prog, "VM_search_getsize: no such handle %i in %s\n", handle, prog->name);
3216 PRVM_G_FLOAT(OFS_RETURN) = prog->opensearches[handle]->numfilenames;
3221 VM_search_getfilename
3223 string search_getfilename(float handle, float num)
3226 void VM_search_getfilename(prvm_prog_t *prog)
3228 int handle, filenum;
3229 VM_SAFEPARMCOUNT(2, VM_search_getfilename);
3231 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3232 filenum = (int)PRVM_G_FLOAT(OFS_PARM1);
3234 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3236 VM_Warning(prog, "VM_search_getfilename: invalid handle %i used in %s\n", handle, prog->name);
3239 if(prog->opensearches[handle] == NULL)
3241 VM_Warning(prog, "VM_search_getfilename: no such handle %i in %s\n", handle, prog->name);
3244 if(filenum < 0 || filenum >= prog->opensearches[handle]->numfilenames)
3246 VM_Warning(prog, "VM_search_getfilename: invalid filenum %i in %s\n", filenum, prog->name);
3250 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, prog->opensearches[handle]->filenames[filenum]);
3257 string chr(float ascii)
3260 void VM_chr(prvm_prog_t *prog)
3264 VM_SAFEPARMCOUNT(1, VM_chr);
3266 tmp[0] = (unsigned char) PRVM_G_FLOAT(OFS_PARM0);
3269 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3274 VM_SAFEPARMCOUNT(1, VM_chr);
3276 len = u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0), tmp, sizeof(tmp));
3278 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3285 string keynumtostring(float keynum)
3288 void VM_keynumtostring (prvm_prog_t *prog)
3290 char tinystr[TINYSTR_LEN];
3291 VM_SAFEPARMCOUNT(1, VM_keynumtostring);
3293 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_KeynumToString((int)PRVM_G_FLOAT(OFS_PARM0), tinystr, TINYSTR_LEN));
3298 VM_findkeysforcommand
3300 string findkeysforcommand(string command, float bindmap)
3302 the returned string is an altstring
3305 #define FKFC_NUMKEYS 5
3306 void M_FindKeysForCommand(const char *command, int *keys);
3307 void VM_findkeysforcommand(prvm_prog_t *prog)
3310 char ret[VM_STRINGTEMP_LENGTH];
3311 int keys[FKFC_NUMKEYS];
3316 VM_SAFEPARMCOUNTRANGE(1, 2, VM_findkeysforcommand);
3318 cmd = PRVM_G_STRING(OFS_PARM0);
3320 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
3322 bindmap = 0; // consistent to "bind"
3324 VM_CheckEmptyString(prog, cmd);
3326 Key_FindKeysForCommand(cmd, keys, FKFC_NUMKEYS, bindmap);
3329 for(i = 0; i < FKFC_NUMKEYS; i++)
3330 strlcat(ret, va(vabuf, sizeof(vabuf), " \'%i\'", keys[i]), sizeof(ret));
3332 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, ret);
3339 float stringtokeynum(string key)
3342 void VM_stringtokeynum (prvm_prog_t *prog)
3344 VM_SAFEPARMCOUNT( 1, VM_stringtokeynum );
3346 PRVM_G_FLOAT(OFS_RETURN) = Key_StringToKeynum(PRVM_G_STRING(OFS_PARM0));
3353 string getkeybind(float key, float bindmap)
3356 void VM_getkeybind (prvm_prog_t *prog)
3359 VM_SAFEPARMCOUNTRANGE(1, 2, VM_getkeybind);
3361 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
3363 bindmap = 0; // consistent to "bind"
3365 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_GetBind((int)PRVM_G_FLOAT(OFS_PARM0), bindmap));
3372 float setkeybind(float key, string cmd, float bindmap)
3375 void VM_setkeybind (prvm_prog_t *prog)
3378 VM_SAFEPARMCOUNTRANGE(2, 3, VM_setkeybind);
3380 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM2), MAX_BINDMAPS-1);
3382 bindmap = 0; // consistent to "bind"
3384 PRVM_G_FLOAT(OFS_RETURN) = 0;
3385 if(Key_SetBinding((int)PRVM_G_FLOAT(OFS_PARM0), bindmap, PRVM_G_STRING(OFS_PARM1)))
3386 PRVM_G_FLOAT(OFS_RETURN) = 1;
3393 vector getbindmaps()
3396 void VM_getbindmaps (prvm_prog_t *prog)
3399 VM_SAFEPARMCOUNT(0, VM_getbindmaps);
3400 Key_GetBindMap(&fg, &bg);
3401 PRVM_G_VECTOR(OFS_RETURN)[0] = fg;
3402 PRVM_G_VECTOR(OFS_RETURN)[1] = bg;
3403 PRVM_G_VECTOR(OFS_RETURN)[2] = 0;
3410 float setbindmaps(vector bindmap)
3413 void VM_setbindmaps (prvm_prog_t *prog)
3415 VM_SAFEPARMCOUNT(1, VM_setbindmaps);
3416 PRVM_G_FLOAT(OFS_RETURN) = 0;
3417 if(PRVM_G_VECTOR(OFS_PARM0)[2] == 0)
3418 if(Key_SetBindMap((int)PRVM_G_VECTOR(OFS_PARM0)[0], (int)PRVM_G_VECTOR(OFS_PARM0)[1]))
3419 PRVM_G_FLOAT(OFS_RETURN) = 1;
3423 ========================
3426 float[bool] gecko_create( string name )
3427 ========================
3429 void VM_gecko_create(prvm_prog_t *prog) {
3431 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3435 ========================
3438 void gecko_destroy( string name )
3439 ========================
3441 void VM_gecko_destroy(prvm_prog_t *prog) {
3446 ========================
3449 void gecko_navigate( string name, string URI )
3450 ========================
3452 void VM_gecko_navigate(prvm_prog_t *prog) {
3457 ========================
3460 float[bool] gecko_keyevent( string name, float key, float eventtype )
3461 ========================
3463 void VM_gecko_keyevent(prvm_prog_t *prog) {
3465 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3469 ========================
3472 void gecko_mousemove( string name, float x, float y )
3473 ========================
3475 void VM_gecko_movemouse(prvm_prog_t *prog) {
3481 ========================
3484 void gecko_resize( string name, float w, float h )
3485 ========================
3487 void VM_gecko_resize(prvm_prog_t *prog) {
3493 ========================
3494 VM_gecko_get_texture_extent
3496 vector gecko_get_texture_extent( string name )
3497 ========================
3499 void VM_gecko_get_texture_extent(prvm_prog_t *prog) {
3501 PRVM_G_VECTOR(OFS_RETURN)[0] = 0;
3502 PRVM_G_VECTOR(OFS_RETURN)[1] = 0;
3511 Writes new values for v_forward, v_up, and v_right based on angles
3512 void makevectors(vector angle)
3515 void VM_makevectors (prvm_prog_t *prog)
3517 vec3_t angles, forward, right, up;
3518 VM_SAFEPARMCOUNT(1, VM_makevectors);
3519 VectorCopy(PRVM_G_VECTOR(OFS_PARM0), angles);
3520 AngleVectors(angles, forward, right, up);
3521 VectorCopy(forward, PRVM_gameglobalvector(v_forward));
3522 VectorCopy(right, PRVM_gameglobalvector(v_right));
3523 VectorCopy(up, PRVM_gameglobalvector(v_up));
3530 Writes new values for v_forward, v_up, and v_right based on the given forward vector
3531 vectorvectors(vector)
3534 void VM_vectorvectors (prvm_prog_t *prog)
3536 vec3_t forward, right, up;
3537 VM_SAFEPARMCOUNT(1, VM_vectorvectors);
3538 VectorNormalize2(PRVM_G_VECTOR(OFS_PARM0), forward);
3539 VectorVectors(forward, right, up);
3540 VectorCopy(forward, PRVM_gameglobalvector(v_forward));
3541 VectorCopy(right, PRVM_gameglobalvector(v_right));
3542 VectorCopy(up, PRVM_gameglobalvector(v_up));
3545 // float(float number, float quantity) bitshift (EXT_BITSHIFT)
3546 void VM_bitshift (prvm_prog_t *prog)
3549 VM_SAFEPARMCOUNT(2, VM_bitshift);
3551 n1 = (prvm_int_t)fabs((prvm_vec_t)((prvm_int_t)PRVM_G_FLOAT(OFS_PARM0)));
3552 n2 = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM1);
3554 PRVM_G_FLOAT(OFS_RETURN) = n1;
3557 PRVM_G_FLOAT(OFS_RETURN) = (n1 >> -n2);
3559 PRVM_G_FLOAT(OFS_RETURN) = (n1 << n2);
3562 ////////////////////////////////////////
3563 // AltString functions
3564 ////////////////////////////////////////
3567 ========================
3570 float altstr_count(string)
3571 ========================
3573 void VM_altstr_count(prvm_prog_t *prog)
3575 const char *altstr, *pos;
3578 VM_SAFEPARMCOUNT( 1, VM_altstr_count );
3580 altstr = PRVM_G_STRING( OFS_PARM0 );
3581 //VM_CheckEmptyString(prog, altstr );
3583 for( count = 0, pos = altstr ; *pos ; pos++ ) {
3584 if( *pos == '\\' ) {
3588 } else if( *pos == '\'' ) {
3593 PRVM_G_FLOAT( OFS_RETURN ) = (prvm_vec_t) (count / 2);
3597 ========================
3600 string altstr_prepare(string)
3601 ========================
3603 void VM_altstr_prepare(prvm_prog_t *prog)
3605 const char *instr, *in;
3606 char outstr[VM_STRINGTEMP_LENGTH];
3609 VM_SAFEPARMCOUNT( 1, VM_altstr_prepare );
3611 instr = PRVM_G_STRING( OFS_PARM0 );
3613 for (in = instr, outpos = 0; *in && outpos < sizeof(outstr) - 1; ++in)
3615 if (*in == '\'' && outpos < sizeof(outstr) - 2)
3617 outstr[outpos++] = '\\';
3618 outstr[outpos++] = '\'';
3621 outstr[outpos++] = *in;
3625 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3629 ========================
3632 string altstr_get(string, float)
3633 ========================
3635 void VM_altstr_get(prvm_prog_t *prog)
3637 const char *altstr, *pos;
3640 char outstr[VM_STRINGTEMP_LENGTH];
3642 VM_SAFEPARMCOUNT( 2, VM_altstr_get );
3644 altstr = PRVM_G_STRING( OFS_PARM0 );
3646 count = (int)PRVM_G_FLOAT( OFS_PARM1 );
3647 count = count * 2 + 1;
3649 for( pos = altstr ; *pos && count ; pos++ )
3650 if( *pos == '\\' ) {
3653 } else if( *pos == '\'' )
3657 PRVM_G_INT( OFS_RETURN ) = 0;
3661 for( out = outstr, size = sizeof(outstr) - 1 ; size && *pos ; size--, pos++, out++ )
3662 if( *pos == '\\' ) {
3667 } else if( *pos == '\'' )
3673 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3677 ========================
3680 string altstr_set(string altstr, float num, string set)
3681 ========================
3683 void VM_altstr_set(prvm_prog_t *prog)
3686 const char *altstr, *str;
3689 char outstr[VM_STRINGTEMP_LENGTH];
3691 VM_SAFEPARMCOUNT( 3, VM_altstr_set );
3693 altstr = PRVM_G_STRING( OFS_PARM0 );
3695 num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3697 str = PRVM_G_STRING( OFS_PARM2 );
3700 for( num = num * 2 + 1, in = altstr; *in && num; *out++ = *in++ )
3705 } else if( *in == '\'' ) {
3710 for( ; *str; *out++ = *str++ );
3711 // now jump over the old content
3713 if( *in == '\'' || (*in == '\\' && !*++in) )
3716 strlcpy(out, in, outstr + sizeof(outstr) - out);
3717 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3721 ========================
3724 string altstr_ins(string altstr, float num, string set)
3725 ========================
3727 void VM_altstr_ins(prvm_prog_t *prog)
3733 char outstr[VM_STRINGTEMP_LENGTH];
3735 VM_SAFEPARMCOUNT(3, VM_altstr_ins);
3737 in = PRVM_G_STRING( OFS_PARM0 );
3738 num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3739 set = PRVM_G_STRING( OFS_PARM2 );
3742 for( num = num * 2 + 2 ; *in && num > 0 ; *out++ = *in++ )
3747 } else if( *in == '\'' ) {
3752 for( ; *set ; *out++ = *set++ );
3755 strlcpy(out, in, outstr + sizeof(outstr) - out);
3756 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3760 ////////////////////////////////////////
3761 // BufString functions
3762 ////////////////////////////////////////
3763 //[515]: string buffers support
3765 static size_t stringbuffers_sortlength;
3767 static void BufStr_Expand(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer, int strindex)
3769 if (stringbuffer->max_strings <= strindex)
3771 char **oldstrings = stringbuffer->strings;
3772 stringbuffer->max_strings = max(stringbuffer->max_strings * 2, 128);
3773 while (stringbuffer->max_strings <= strindex)
3774 stringbuffer->max_strings *= 2;
3775 stringbuffer->strings = (char **) Mem_Alloc(prog->progs_mempool, stringbuffer->max_strings * sizeof(stringbuffer->strings[0]));
3776 if (stringbuffer->num_strings > 0)
3777 memcpy(stringbuffer->strings, oldstrings, stringbuffer->num_strings * sizeof(stringbuffer->strings[0]));
3779 Mem_Free(oldstrings);
3783 static void BufStr_Shrink(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer)
3785 // reduce num_strings if there are empty string slots at the end
3786 while (stringbuffer->num_strings > 0 && stringbuffer->strings[stringbuffer->num_strings - 1] == NULL)
3787 stringbuffer->num_strings--;
3789 // if empty, free the string pointer array
3790 if (stringbuffer->num_strings == 0)
3792 stringbuffer->max_strings = 0;
3793 if (stringbuffer->strings)
3794 Mem_Free(stringbuffer->strings);
3795 stringbuffer->strings = NULL;
3799 static int BufStr_SortStringsUP (const void *in1, const void *in2)
3802 a = *((const char **) in1);
3803 b = *((const char **) in2);
3804 if(!a || !a[0]) return 1;
3805 if(!b || !b[0]) return -1;
3806 return strncmp(a, b, stringbuffers_sortlength);
3809 static int BufStr_SortStringsDOWN (const void *in1, const void *in2)
3812 a = *((const char **) in1);
3813 b = *((const char **) in2);
3814 if(!a || !a[0]) return 1;
3815 if(!b || !b[0]) return -1;
3816 return strncmp(b, a, stringbuffers_sortlength);
3819 prvm_stringbuffer_t *BufStr_FindCreateReplace (prvm_prog_t *prog, int bufindex, int flags, const char *format)
3821 prvm_stringbuffer_t *stringbuffer;
3827 // find buffer with wanted index
3828 if (bufindex < (int)Mem_ExpandableArray_IndexRange(&prog->stringbuffersarray))
3830 if ( (stringbuffer = (prvm_stringbuffer_t*) Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, bufindex)) )
3832 if (stringbuffer->flags & STRINGBUFFER_TEMP)
3833 stringbuffer->flags = flags; // created but has not been used yet
3834 return stringbuffer;
3839 // allocate new buffer with wanted index
3842 stringbuffer = (prvm_stringbuffer_t *) Mem_ExpandableArray_AllocRecord(&prog->stringbuffersarray);
3843 stringbuffer->flags = STRINGBUFFER_TEMP;
3844 for (i = 0;stringbuffer != Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i);i++);
3847 stringbuffer->flags = flags; // mark as used
3851 return stringbuffer;
3854 void BufStr_Set(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer, int strindex, const char *str)
3858 if (!stringbuffer || strindex < 0)
3861 BufStr_Expand(prog, stringbuffer, strindex);
3862 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
3863 if (stringbuffer->strings[strindex])
3864 Mem_Free(stringbuffer->strings[strindex]);
3865 stringbuffer->strings[strindex] = NULL;
3869 // not the NULL string!
3870 alloclen = strlen(str) + 1;
3871 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
3872 memcpy(stringbuffer->strings[strindex], str, alloclen);
3875 BufStr_Shrink(prog, stringbuffer);
3878 void BufStr_Del(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer)
3885 for (i = 0;i < stringbuffer->num_strings;i++)
3886 if (stringbuffer->strings[i])
3887 Mem_Free(stringbuffer->strings[i]);
3888 if (stringbuffer->strings)
3889 Mem_Free(stringbuffer->strings);
3890 if(stringbuffer->origin)
3891 PRVM_Free((char *)stringbuffer->origin);
3892 Mem_ExpandableArray_FreeRecord(&prog->stringbuffersarray, stringbuffer);
3895 void BufStr_Flush(prvm_prog_t *prog)
3897 prvm_stringbuffer_t *stringbuffer;
3900 numbuffers = (int)Mem_ExpandableArray_IndexRange(&prog->stringbuffersarray);
3901 for (i = 0; i < numbuffers; i++)
3902 if ( (stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i)) )
3903 BufStr_Del(prog, stringbuffer);
3904 Mem_ExpandableArray_NewArray(&prog->stringbuffersarray, prog->progs_mempool, sizeof(prvm_stringbuffer_t), 64);
3908 ========================
3910 creates new buffer, and returns it's index, returns -1 if failed
3911 float buf_create(prvm_prog_t *prog) = #460;
3912 float newbuf(string format, float flags) = #460;
3913 ========================
3916 void VM_buf_create (prvm_prog_t *prog)
3918 prvm_stringbuffer_t *stringbuffer;
3921 VM_SAFEPARMCOUNTRANGE(0, 2, VM_buf_create);
3923 // VorteX: optional parm1 (buffer format) is unfinished, to keep intact with future databuffers extension must be set to "string"
3924 if(prog->argc >= 1 && strcmp(PRVM_G_STRING(OFS_PARM0), "string"))
3926 PRVM_G_FLOAT(OFS_RETURN) = -1;
3929 stringbuffer = (prvm_stringbuffer_t *) Mem_ExpandableArray_AllocRecord(&prog->stringbuffersarray);
3930 for (i = 0;stringbuffer != Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i);i++);
3931 stringbuffer->origin = PRVM_AllocationOrigin(prog);
3932 // optional flags parm
3933 if (prog->argc >= 2)
3934 stringbuffer->flags = (int)PRVM_G_FLOAT(OFS_PARM1) & STRINGBUFFER_QCFLAGS;
3935 PRVM_G_FLOAT(OFS_RETURN) = i;
3941 ========================
3943 deletes buffer and all strings in it
3944 void buf_del(float bufhandle) = #461;
3945 ========================
3947 void VM_buf_del (prvm_prog_t *prog)
3949 prvm_stringbuffer_t *stringbuffer;
3950 VM_SAFEPARMCOUNT(1, VM_buf_del);
3951 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3953 BufStr_Del(prog, stringbuffer);
3956 VM_Warning(prog, "VM_buf_del: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3962 ========================
3964 how many strings are stored in buffer
3965 float buf_getsize(float bufhandle) = #462;
3966 ========================
3968 void VM_buf_getsize (prvm_prog_t *prog)
3970 prvm_stringbuffer_t *stringbuffer;
3971 VM_SAFEPARMCOUNT(1, VM_buf_getsize);
3973 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3976 PRVM_G_FLOAT(OFS_RETURN) = -1;
3977 VM_Warning(prog, "VM_buf_getsize: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3981 PRVM_G_FLOAT(OFS_RETURN) = stringbuffer->num_strings;
3985 ========================
3987 copy all content from one buffer to another, make sure it exists
3988 void buf_copy(float bufhandle_from, float bufhandle_to) = #463;
3989 ========================
3991 void VM_buf_copy (prvm_prog_t *prog)
3993 prvm_stringbuffer_t *srcstringbuffer, *dststringbuffer;
3995 VM_SAFEPARMCOUNT(2, VM_buf_copy);
3997 srcstringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3998 if(!srcstringbuffer)
4000 VM_Warning(prog, "VM_buf_copy: invalid source buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4003 i = (int)PRVM_G_FLOAT(OFS_PARM1);
4004 if(i == (int)PRVM_G_FLOAT(OFS_PARM0))
4006 VM_Warning(prog, "VM_buf_copy: source == destination (%i) in %s\n", i, prog->name);
4009 dststringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4010 if(!dststringbuffer)
4012 VM_Warning(prog, "VM_buf_copy: invalid destination buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4016 for (i = 0;i < dststringbuffer->num_strings;i++)
4017 if (dststringbuffer->strings[i])
4018 Mem_Free(dststringbuffer->strings[i]);
4019 if (dststringbuffer->strings)
4020 Mem_Free(dststringbuffer->strings);
4021 *dststringbuffer = *srcstringbuffer;
4022 if (dststringbuffer->max_strings)
4023 dststringbuffer->strings = (char **)Mem_Alloc(prog->progs_mempool, sizeof(dststringbuffer->strings[0]) * dststringbuffer->max_strings);
4025 for (i = 0;i < dststringbuffer->num_strings;i++)
4027 if (srcstringbuffer->strings[i])
4030 stringlen = strlen(srcstringbuffer->strings[i]) + 1;
4031 dststringbuffer->strings[i] = (char *)Mem_Alloc(prog->progs_mempool, stringlen);
4032 memcpy(dststringbuffer->strings[i], srcstringbuffer->strings[i], stringlen);
4038 ========================
4040 sort buffer by beginnings of strings (cmplength defaults it's length)
4041 "backward == true" means that sorting goes upside-down
4042 void buf_sort(float bufhandle, float cmplength, float backward) = #464;
4043 ========================
4045 void VM_buf_sort (prvm_prog_t *prog)
4047 prvm_stringbuffer_t *stringbuffer;
4048 VM_SAFEPARMCOUNT(3, VM_buf_sort);
4050 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4053 VM_Warning(prog, "VM_buf_sort: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4056 if(stringbuffer->num_strings <= 0)
4058 VM_Warning(prog, "VM_buf_sort: tried to sort empty buffer %i in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4061 stringbuffers_sortlength = (int)PRVM_G_FLOAT(OFS_PARM1);
4062 if(stringbuffers_sortlength <= 0)
4063 stringbuffers_sortlength = 0x7FFFFFFF;
4065 if(!PRVM_G_FLOAT(OFS_PARM2))
4066 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsUP);
4068 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsDOWN);
4070 BufStr_Shrink(prog, stringbuffer);
4074 ========================
4076 concantenates all buffer string into one with "glue" separator and returns it as tempstring
4077 string buf_implode(float bufhandle, string glue) = #465;
4078 ========================
4080 void VM_buf_implode (prvm_prog_t *prog)
4082 prvm_stringbuffer_t *stringbuffer;
4083 char k[VM_STRINGTEMP_LENGTH];
4087 VM_SAFEPARMCOUNT(2, VM_buf_implode);
4089 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4090 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4093 VM_Warning(prog, "VM_buf_implode: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4096 if(!stringbuffer->num_strings)
4098 sep = PRVM_G_STRING(OFS_PARM1);
4100 for(l = i = 0;i < stringbuffer->num_strings;i++)
4102 if(stringbuffer->strings[i])
4104 l += (i > 0 ? strlen(sep) : 0) + strlen(stringbuffer->strings[i]);
4105 if (l >= sizeof(k) - 1)
4107 strlcat(k, sep, sizeof(k));
4108 strlcat(k, stringbuffer->strings[i], sizeof(k));
4111 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, k);
4115 ========================
4117 get a string from buffer, returns tempstring, dont str_unzone it!
4118 string bufstr_get(float bufhandle, float string_index) = #465;
4119 ========================
4121 void VM_bufstr_get (prvm_prog_t *prog)
4123 prvm_stringbuffer_t *stringbuffer;
4125 VM_SAFEPARMCOUNT(2, VM_bufstr_get);
4127 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4128 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4131 VM_Warning(prog, "VM_bufstr_get: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4134 strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4137 // VM_Warning(prog, "VM_bufstr_get: invalid string index %i used in %s\n", strindex, prog->name);
4140 if (strindex < stringbuffer->num_strings && stringbuffer->strings[strindex])
4141 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, stringbuffer->strings[strindex]);
4145 ========================
4147 copies a string into selected slot of buffer
4148 void bufstr_set(float bufhandle, float string_index, string str) = #466;
4149 ========================
4151 void VM_bufstr_set (prvm_prog_t *prog)
4154 prvm_stringbuffer_t *stringbuffer;
4157 VM_SAFEPARMCOUNT(3, VM_bufstr_set);
4159 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4162 VM_Warning(prog, "VM_bufstr_set: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4165 strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4166 if(strindex < 0 || strindex >= 1000000) // huge number of strings
4168 VM_Warning(prog, "VM_bufstr_set: invalid string index %i used in %s\n", strindex, prog->name);
4172 news = PRVM_G_STRING(OFS_PARM2);
4173 BufStr_Set(prog, stringbuffer, strindex, news);
4177 ========================
4179 adds string to buffer in first free slot and returns its index
4180 "order == true" means that string will be added after last "full" slot
4181 float bufstr_add(float bufhandle, string str, float order) = #467;
4182 ========================
4184 void VM_bufstr_add (prvm_prog_t *prog)
4186 int order, strindex;
4187 prvm_stringbuffer_t *stringbuffer;
4191 VM_SAFEPARMCOUNT(3, VM_bufstr_add);
4193 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4194 PRVM_G_FLOAT(OFS_RETURN) = -1;
4197 VM_Warning(prog, "VM_bufstr_add: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4200 if(!PRVM_G_INT(OFS_PARM1)) // NULL string
4202 VM_Warning(prog, "VM_bufstr_add: can not add an empty string to buffer %i in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4205 string = PRVM_G_STRING(OFS_PARM1);
4206 order = (int)PRVM_G_FLOAT(OFS_PARM2);
4208 strindex = stringbuffer->num_strings;
4210 for (strindex = 0;strindex < stringbuffer->num_strings;strindex++)
4211 if (stringbuffer->strings[strindex] == NULL)
4214 BufStr_Expand(prog, stringbuffer, strindex);
4216 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4217 alloclen = strlen(string) + 1;
4218 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4219 memcpy(stringbuffer->strings[strindex], string, alloclen);
4221 PRVM_G_FLOAT(OFS_RETURN) = strindex;
4225 ========================
4227 delete string from buffer
4228 void bufstr_free(float bufhandle, float string_index) = #468;
4229 ========================
4231 void VM_bufstr_free (prvm_prog_t *prog)
4234 prvm_stringbuffer_t *stringbuffer;
4235 VM_SAFEPARMCOUNT(2, VM_bufstr_free);
4237 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4240 VM_Warning(prog, "VM_bufstr_free: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4243 i = (int)PRVM_G_FLOAT(OFS_PARM1);
4246 VM_Warning(prog, "VM_bufstr_free: invalid string index %i used in %s\n", i, prog->name);
4250 if (i < stringbuffer->num_strings)
4252 if(stringbuffer->strings[i])
4253 Mem_Free(stringbuffer->strings[i]);
4254 stringbuffer->strings[i] = NULL;
4257 BufStr_Shrink(prog, stringbuffer);
4261 ========================
4263 load a file into string buffer, return 0 or 1
4264 float buf_loadfile(string filename, float bufhandle) = #535;
4265 ========================
4267 void VM_buf_loadfile(prvm_prog_t *prog)
4270 prvm_stringbuffer_t *stringbuffer;
4271 char string[VM_STRINGTEMP_LENGTH];
4272 int strindex, c, end;
4273 const char *filename;
4277 VM_SAFEPARMCOUNT(2, VM_buf_loadfile);
4280 filename = PRVM_G_STRING(OFS_PARM0);
4281 file = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
4283 file = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
4286 if (developer_extra.integer)
4287 VM_Warning(prog, "VM_buf_loadfile: failed to open file %s in %s\n", filename, prog->name);
4288 PRVM_G_FLOAT(OFS_RETURN) = 0;
4292 // get string buffer
4293 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM1));
4296 VM_Warning(prog, "VM_buf_loadfile: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4297 PRVM_G_FLOAT(OFS_RETURN) = 0;
4301 // read file (append to the end of buffer)
4302 strindex = stringbuffer->num_strings;
4310 if (c == '\r' || c == '\n' || c < 0)
4312 if (end < VM_STRINGTEMP_LENGTH - 1)
4316 // remove \n following \r
4321 FS_UnGetc(file, (unsigned char)c);
4326 BufStr_Expand(prog, stringbuffer, strindex);
4327 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4328 alloclen = strlen(string) + 1;
4329 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4330 memcpy(stringbuffer->strings[strindex], string, alloclen);
4331 strindex = stringbuffer->num_strings;
4339 PRVM_G_FLOAT(OFS_RETURN) = 1;
4343 ========================
4345 writes stringbuffer to a file, returns 0 or 1
4346 float buf_writefile(float filehandle, float bufhandle, [, float startpos, float numstrings]) = #468;
4347 ========================
4350 void VM_buf_writefile(prvm_prog_t *prog)
4352 int filenum, strindex, strnum, strlength;
4353 prvm_stringbuffer_t *stringbuffer;
4355 VM_SAFEPARMCOUNTRANGE(2, 4, VM_buf_writefile);
4358 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
4359 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
4361 VM_Warning(prog, "VM_buf_writefile: invalid file handle %i used in %s\n", filenum, prog->name);
4364 if (prog->openfiles[filenum] == NULL)
4366 VM_Warning(prog, "VM_buf_writefile: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
4370 // get string buffer
4371 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM1));
4374 VM_Warning(prog, "VM_buf_writefile: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4375 PRVM_G_FLOAT(OFS_RETURN) = 0;
4379 // get start and end parms
4382 strindex = (int)PRVM_G_FLOAT(OFS_PARM2);
4383 strnum = (int)PRVM_G_FLOAT(OFS_PARM3);
4385 else if (prog->argc > 2)
4387 strindex = (int)PRVM_G_FLOAT(OFS_PARM2);
4388 strnum = stringbuffer->num_strings - strindex;
4393 strnum = stringbuffer->num_strings;
4395 if (strindex < 0 || strindex >= stringbuffer->num_strings)
4397 VM_Warning(prog, "VM_buf_writefile: wrong start string index %i used in %s\n", strindex, prog->name);
4398 PRVM_G_FLOAT(OFS_RETURN) = 0;
4403 VM_Warning(prog, "VM_buf_writefile: wrong strings count %i used in %s\n", strnum, prog->name);
4404 PRVM_G_FLOAT(OFS_RETURN) = 0;
4409 while(strindex < stringbuffer->num_strings && strnum)
4411 if (stringbuffer->strings[strindex])
4413 if ((strlength = (int)strlen(stringbuffer->strings[strindex])))
4414 FS_Write(prog->openfiles[filenum], stringbuffer->strings[strindex], strlength);
4415 FS_Write(prog->openfiles[filenum], "\n", 1);
4421 PRVM_G_FLOAT(OFS_RETURN) = 1;
4424 #define MATCH_AUTO 0
4425 #define MATCH_WHOLE 1
4426 #define MATCH_LEFT 2
4427 #define MATCH_RIGHT 3
4428 #define MATCH_MIDDLE 4
4429 #define MATCH_PATTERN 5
4431 static const char *detect_match_rule(char *pattern, int *matchrule)
4436 patternlength = (int)strlen(pattern);
4437 ppos = strchr(pattern, '*');
4438 qpos = strchr(pattern, '?');
4442 *matchrule = MATCH_PATTERN;
4445 // has * - left, mid, right or pattern
4448 // starts with * - may be right/mid or pattern
4449 if ((ppos - pattern) == 0)
4451 ppos = strchr(pattern+1, '*');
4455 *matchrule = MATCH_RIGHT;
4459 if ((ppos - pattern) == patternlength)
4461 *matchrule = MATCH_MIDDLE;
4466 *matchrule = MATCH_PATTERN;
4469 // end with * - left
4470 if ((ppos - pattern) == patternlength)
4472 *matchrule = MATCH_LEFT;
4477 *matchrule = MATCH_PATTERN;
4480 // have no wildcards - whole string
4481 *matchrule = MATCH_WHOLE;
4485 // todo: support UTF8
4486 static qbool match_rule(const char *string, int max_string, const char *pattern, int patternlength, int rule)
4491 return !strncmp(string, pattern, max_string) ? true : false;
4493 return !strncmp(string, pattern, patternlength) ? true : false;
4496 mid = strstr(string, pattern);
4497 return mid && !*(mid+patternlength);
4500 return strstr(string, pattern) ? true : false;
4502 return matchpattern_with_separator(string, pattern, false, "", false) ? true : false;
4506 ========================
4508 find an index of bufstring matching rule
4509 float bufstr_find(float bufhandle, string match, float matchrule, float startpos, float step) = #468;
4510 ========================
4513 void VM_bufstr_find(prvm_prog_t *prog)
4515 prvm_stringbuffer_t *stringbuffer;
4516 char string[VM_STRINGTEMP_LENGTH];
4517 int matchrule, matchlen, i, step;
4520 VM_SAFEPARMCOUNTRANGE(3, 5, VM_bufstr_find);
4522 PRVM_G_FLOAT(OFS_RETURN) = -1;
4524 // get string buffer
4525 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4528 VM_Warning(prog, "VM_bufstr_find: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4533 matchrule = (int)PRVM_G_FLOAT(OFS_PARM2);
4534 if (matchrule < 0 || matchrule > 5)
4536 VM_Warning(prog, "VM_bufstr_find: invalid match rule %i in %s\n", matchrule, prog->name);
4540 match = PRVM_G_STRING(OFS_PARM1);
4543 strlcpy(string, PRVM_G_STRING(OFS_PARM1), sizeof(string));
4544 match = detect_match_rule(string, &matchrule);
4546 matchlen = (int)strlen(match);
4549 i = (prog->argc > 3) ? (int)PRVM_G_FLOAT(OFS_PARM3) : 0;
4550 step = (prog->argc > 4) ? (int)PRVM_G_FLOAT(OFS_PARM4) : 1;
4551 while(i < stringbuffer->num_strings)
4553 if (stringbuffer->strings[i] && match_rule(stringbuffer->strings[i], VM_STRINGTEMP_LENGTH, match, matchlen, matchrule))
4555 PRVM_G_FLOAT(OFS_RETURN) = i;
4563 ========================
4565 float matchpattern(string s, string pattern, float matchrule, float startpos) = #468;
4566 ========================
4568 void VM_matchpattern(prvm_prog_t *prog)
4570 const char *s, *match;
4571 char string[VM_STRINGTEMP_LENGTH];
4574 VM_SAFEPARMCOUNTRANGE(2, 4, VM_matchpattern);
4576 s = PRVM_G_STRING(OFS_PARM0);
4579 matchrule = (int)PRVM_G_FLOAT(OFS_PARM2);
4580 if (matchrule < 0 || matchrule > 5)
4582 VM_Warning(prog, "VM_matchpattern: invalid match rule %i in %s\n", matchrule, prog->name);
4586 match = PRVM_G_STRING(OFS_PARM1);
4589 strlcpy(string, PRVM_G_STRING(OFS_PARM1), sizeof(string));
4590 match = detect_match_rule(string, &matchrule);
4594 l = (int)strlen(match);
4596 s += max(0, min((unsigned int)PRVM_G_FLOAT(OFS_PARM3), strlen(s)-1));
4599 PRVM_G_FLOAT(OFS_RETURN) = match_rule(s, VM_STRINGTEMP_LENGTH, match, l, matchrule);
4603 ========================
4605 ========================
4608 void VM_buf_cvarlist(prvm_prog_t *prog)
4611 const char *partial, *antipartial;
4612 size_t len, antilen;
4614 qbool ispattern, antiispattern;
4616 prvm_stringbuffer_t *stringbuffer;
4617 VM_SAFEPARMCOUNTRANGE(2, 3, VM_buf_cvarlist);
4619 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4622 VM_Warning(prog, "VM_bufstr_free: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4626 partial = PRVM_G_STRING(OFS_PARM1);
4630 len = strlen(partial);
4633 antipartial = PRVM_G_STRING(OFS_PARM2);
4639 antilen = strlen(antipartial);
4641 for (n = 0;n < stringbuffer->num_strings;n++)
4642 if (stringbuffer->strings[n])
4643 Mem_Free(stringbuffer->strings[n]);
4644 if (stringbuffer->strings)
4645 Mem_Free(stringbuffer->strings);
4646 stringbuffer->strings = NULL;
4648 ispattern = partial && (strchr(partial, '*') || strchr(partial, '?'));
4649 antiispattern = antipartial && (strchr(antipartial, '*') || strchr(antipartial, '?'));
4652 for(cvar = prog->console_cmd->cvars->vars; cvar; cvar = cvar->next)
4654 if(len && (ispattern ? !matchpattern_with_separator(cvar->name, partial, false, "", false) : strncmp(partial, cvar->name, len)))
4657 if(antilen && (antiispattern ? matchpattern_with_separator(cvar->name, antipartial, false, "", false) : !strncmp(antipartial, cvar->name, antilen)))
4663 stringbuffer->max_strings = stringbuffer->num_strings = n;
4664 if (stringbuffer->max_strings)
4665 stringbuffer->strings = (char **)Mem_Alloc(prog->progs_mempool, sizeof(stringbuffer->strings[0]) * stringbuffer->max_strings);
4668 for(cvar = prog->console_cmd->cvars->vars; cvar; cvar = cvar->next)
4670 if(len && (ispattern ? !matchpattern_with_separator(cvar->name, partial, false, "", false) : strncmp(partial, cvar->name, len)))
4673 if(antilen && (antiispattern ? matchpattern_with_separator(cvar->name, antipartial, false, "", false) : !strncmp(antipartial, cvar->name, antilen)))
4676 alloclen = strlen(cvar->name) + 1;
4677 stringbuffer->strings[n] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4678 memcpy(stringbuffer->strings[n], cvar->name, alloclen);
4693 This was a major timewaster in progs, so it was converted to C
4696 void VM_changeyaw (prvm_prog_t *prog)
4699 float ideal, current, move, speed;
4701 // this is called (VERY HACKISHLY) by VM_SV_MoveToGoal, so it can not use any
4702 // parameters because they are the parameters to VM_SV_MoveToGoal, not this
4703 //VM_SAFEPARMCOUNT(0, VM_changeyaw);
4705 ent = PRVM_PROG_TO_EDICT(PRVM_gameglobaledict(self));
4706 if (ent == prog->edicts)
4708 VM_Warning(prog, "changeyaw: can not modify world entity\n");
4713 VM_Warning(prog, "changeyaw: can not modify free entity\n");
4716 current = PRVM_gameedictvector(ent, angles)[1];
4717 current = ANGLEMOD(current);
4718 ideal = PRVM_gameedictfloat(ent, ideal_yaw);
4719 speed = PRVM_gameedictfloat(ent, yaw_speed);
4721 if (current == ideal)
4723 move = ideal - current;
4724 if (ideal > current)
4746 PRVM_gameedictvector(ent, angles)[1] = ANGLEMOD(current);
4754 void VM_changepitch (prvm_prog_t *prog)
4757 float ideal, current, move, speed;
4759 VM_SAFEPARMCOUNT(1, VM_changepitch);
4761 ent = PRVM_G_EDICT(OFS_PARM0);
4762 if (ent == prog->edicts)
4764 VM_Warning(prog, "changepitch: can not modify world entity\n");
4769 VM_Warning(prog, "changepitch: can not modify free entity\n");
4772 current = PRVM_gameedictvector(ent, angles)[0];
4773 current = ANGLEMOD(current);
4774 ideal = PRVM_gameedictfloat(ent, idealpitch);
4775 speed = PRVM_gameedictfloat(ent, pitch_speed);
4777 if (current == ideal)
4779 move = ideal - current;
4780 if (ideal > current)
4802 PRVM_gameedictvector(ent, angles)[0] = ANGLEMOD(current);
4806 void VM_uncolorstring (prvm_prog_t *prog)
4808 char szNewString[VM_STRINGTEMP_LENGTH];
4809 const char *szString;
4812 VM_SAFEPARMCOUNT(1, VM_uncolorstring);
4813 szString = PRVM_G_STRING(OFS_PARM0);
4814 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), true);
4815 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
4819 // #221 float(string str, string sub[, float startpos]) strstrofs (FTE_STRINGS)
4820 //strstr, without generating a new string. Use in conjunction with FRIK_FILE's substring for more similar strstr.
4821 void VM_strstrofs (prvm_prog_t *prog)
4823 const char *instr, *match;
4825 VM_SAFEPARMCOUNTRANGE(2, 3, VM_strstrofs);
4826 instr = PRVM_G_STRING(OFS_PARM0);
4827 match = PRVM_G_STRING(OFS_PARM1);
4828 firstofs = (prog->argc > 2)?(int)PRVM_G_FLOAT(OFS_PARM2):0;
4829 firstofs = (int)u8_bytelen(instr, firstofs);
4831 if (firstofs && (firstofs < 0 || firstofs > (int)strlen(instr)))
4833 PRVM_G_FLOAT(OFS_RETURN) = -1;
4837 match = strstr(instr+firstofs, match);
4839 PRVM_G_FLOAT(OFS_RETURN) = -1;
4841 PRVM_G_FLOAT(OFS_RETURN) = u8_strnlen(instr, match-instr);
4844 //#222 string(string s, float index) str2chr (FTE_STRINGS)
4845 void VM_str2chr (prvm_prog_t *prog)
4850 VM_SAFEPARMCOUNT(2, VM_str2chr);
4851 s = PRVM_G_STRING(OFS_PARM0);
4852 index = (int)u8_bytelen(s, (int)PRVM_G_FLOAT(OFS_PARM1));
4854 if((unsigned)index < strlen(s))
4856 if (utf8_enable.integer)
4857 ch = u8_getchar_noendptr(s + index);
4859 ch = (unsigned char)s[index];
4860 PRVM_G_FLOAT(OFS_RETURN) = ch;
4863 PRVM_G_FLOAT(OFS_RETURN) = 0;
4866 //#223 string(float c, ...) chr2str (FTE_STRINGS)
4867 void VM_chr2str (prvm_prog_t *prog)
4872 VM_SAFEPARMCOUNTRANGE(0, 8, VM_chr2str);
4873 for(i = 0;i < prog->argc && i < (int)sizeof(t) - 1;i++)
4874 t[i] = (unsigned char)PRVM_G_FLOAT(OFS_PARM0+i*3);
4876 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, t);
4881 VM_SAFEPARMCOUNTRANGE(0, 8, VM_chr2str);
4882 for(i = 0; i < prog->argc && len < sizeof(t)-1; ++i)
4883 len += u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0+i*3), t + len, sizeof(t)-1);
4885 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, t);
4888 static int chrconv_number(int i, int base, int conv)
4913 static int chrconv_punct(int i, int base, int conv)
4931 static int chrchar_alpha(int i, int basec, int baset, int convc, int convt, int charnum)
4933 //convert case and colour seperatly...
4950 baset = 128*((charnum&1) == (convt-5));
4966 return i + basec + baset;
4968 // #224 string(float ccase, float calpha, float cnum, string s, ...) strconv (FTE_STRINGS)
4969 //bulk convert a string. change case or colouring.
4970 void VM_strconv (prvm_prog_t *prog)
4972 int ccase, redalpha, rednum, len, i;
4973 unsigned char resbuf[VM_STRINGTEMP_LENGTH];
4974 unsigned char *result = resbuf;
4976 VM_SAFEPARMCOUNTRANGE(3, 8, VM_strconv);
4978 ccase = (int) PRVM_G_FLOAT(OFS_PARM0); //0 same, 1 lower, 2 upper
4979 redalpha = (int) PRVM_G_FLOAT(OFS_PARM1); //0 same, 1 white, 2 red, 5 alternate, 6 alternate-alternate
4980 rednum = (int) PRVM_G_FLOAT(OFS_PARM2); //0 same, 1 white, 2 red, 3 redspecial, 4 whitespecial, 5 alternate, 6 alternate-alternate
4981 VM_VarString(prog, 3, (char *) resbuf, sizeof(resbuf));
4982 len = (int)strlen((char *) resbuf);
4984 for (i = 0; i < len; i++, result++) //should this be done backwards?
4986 if (*result >= '0' && *result <= '9') //normal numbers...
4987 *result = chrconv_number(*result, '0', rednum);
4988 else if (*result >= '0'+128 && *result <= '9'+128)
4989 *result = chrconv_number(*result, '0'+128, rednum);
4990 else if (*result >= '0'+128-30 && *result <= '9'+128-30)
4991 *result = chrconv_number(*result, '0'+128-30, rednum);
4992 else if (*result >= '0'-30 && *result <= '9'-30)
4993 *result = chrconv_number(*result, '0'-30, rednum);
4995 else if (*result >= 'a' && *result <= 'z') //normal numbers...
4996 *result = chrchar_alpha(*result, 'a', 0, ccase, redalpha, i);
4997 else if (*result >= 'A' && *result <= 'Z') //normal numbers...
4998 *result = chrchar_alpha(*result, 'A', 0, ccase, redalpha, i);
4999 else if (*result >= 'a'+128 && *result <= 'z'+128) //normal numbers...
5000 *result = chrchar_alpha(*result, 'a', 128, ccase, redalpha, i);
5001 else if (*result >= 'A'+128 && *result <= 'Z'+128) //normal numbers...
5002 *result = chrchar_alpha(*result, 'A', 128, ccase, redalpha, i);
5004 else if ((*result & 127) < 16 || !redalpha) //special chars..
5006 else if (*result < 128)
5007 *result = chrconv_punct(*result, 0, redalpha);
5009 *result = chrconv_punct(*result, 128, redalpha);
5013 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, (char *) resbuf);
5016 // #225 string(float chars, string s, ...) strpad (FTE_STRINGS)
5017 void VM_strpad (prvm_prog_t *prog)
5019 char src[VM_STRINGTEMP_LENGTH];
5020 char destbuf[VM_STRINGTEMP_LENGTH];
5022 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strpad);
5023 pad = (int) PRVM_G_FLOAT(OFS_PARM0);
5024 VM_VarString(prog, 1, src, sizeof(src));
5026 // note: < 0 = left padding, > 0 = right padding,
5027 // this is reverse logic of printf!
5028 dpsnprintf(destbuf, sizeof(destbuf), "%*s", -pad, src);
5030 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, destbuf);
5033 // #226 string(string info, string key, string value, ...) infoadd (FTE_STRINGS)
5034 //uses qw style \key\value strings
5035 void VM_infoadd (prvm_prog_t *prog)
5037 const char *info, *key;
5038 char value[VM_STRINGTEMP_LENGTH];
5039 char temp[VM_STRINGTEMP_LENGTH];
5041 VM_SAFEPARMCOUNTRANGE(2, 8, VM_infoadd);
5042 info = PRVM_G_STRING(OFS_PARM0);
5043 key = PRVM_G_STRING(OFS_PARM1);
5044 VM_VarString(prog, 2, value, sizeof(value));
5046 strlcpy(temp, info, VM_STRINGTEMP_LENGTH);
5048 InfoString_SetValue(temp, VM_STRINGTEMP_LENGTH, key, value);
5050 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, temp);
5053 // #227 string(string info, string key) infoget (FTE_STRINGS)
5054 //uses qw style \key\value strings
5055 void VM_infoget (prvm_prog_t *prog)
5059 char value[VM_STRINGTEMP_LENGTH];
5061 VM_SAFEPARMCOUNT(2, VM_infoget);
5062 info = PRVM_G_STRING(OFS_PARM0);
5063 key = PRVM_G_STRING(OFS_PARM1);
5065 InfoString_GetValue(info, key, value, VM_STRINGTEMP_LENGTH);
5067 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, value);
5070 //#228 float(string s1, string s2, float len) strncmp (FTE_STRINGS)
5071 // also float(string s1, string s2) strcmp (FRIK_FILE)
5072 void VM_strncmp (prvm_prog_t *prog)
5074 const char *s1, *s2;
5075 VM_SAFEPARMCOUNTRANGE(2, 3, VM_strncmp);
5076 s1 = PRVM_G_STRING(OFS_PARM0);
5077 s2 = PRVM_G_STRING(OFS_PARM1);
5080 PRVM_G_FLOAT(OFS_RETURN) = strncmp(s1, s2, (size_t)PRVM_G_FLOAT(OFS_PARM2));
5084 PRVM_G_FLOAT(OFS_RETURN) = strcmp(s1, s2);
5088 // #229 float(string s1, string s2) strcasecmp (FTE_STRINGS)
5089 // #230 float(string s1, string s2, float len) strncasecmp (FTE_STRINGS)
5090 void VM_strncasecmp (prvm_prog_t *prog)
5092 const char *s1, *s2;
5093 VM_SAFEPARMCOUNTRANGE(2, 3, VM_strncasecmp);
5094 s1 = PRVM_G_STRING(OFS_PARM0);
5095 s2 = PRVM_G_STRING(OFS_PARM1);
5098 PRVM_G_FLOAT(OFS_RETURN) = strncasecmp(s1, s2, (size_t)PRVM_G_FLOAT(OFS_PARM2));
5102 PRVM_G_FLOAT(OFS_RETURN) = strcasecmp(s1, s2);
5106 // #494 float(float caseinsensitive, string s, ...) crc16
5107 void VM_crc16(prvm_prog_t *prog)
5110 char s[VM_STRINGTEMP_LENGTH];
5111 VM_SAFEPARMCOUNTRANGE(2, 8, VM_crc16);
5112 insensitive = PRVM_G_FLOAT(OFS_PARM0);
5113 VM_VarString(prog, 1, s, sizeof(s));
5114 PRVM_G_FLOAT(OFS_RETURN) = (unsigned short) ((insensitive ? CRC_Block_CaseInsensitive : CRC_Block) ((unsigned char *) s, strlen(s)));
5117 // #639 float(string digest, string data, ...) digest_hex
5118 void VM_digest_hex(prvm_prog_t *prog)
5126 char s[VM_STRINGTEMP_LENGTH];
5129 VM_SAFEPARMCOUNTRANGE(2, 8, VM_digest_hex);
5130 digest = PRVM_G_STRING(OFS_PARM0);
5133 VM_VarString(prog, 1, s, sizeof(s));
5134 len = (int)strlen(s);
5138 if(!strcmp(digest, "MD4"))
5141 mdfour((unsigned char *) out, (unsigned char *) s, len);
5143 else if(!strcmp(digest, "SHA256") && Crypto_Available())
5146 sha256((unsigned char *) out, (unsigned char *) s, len);
5148 // no warning needed on mismatch - we return string_null to QC
5153 static const char *hexmap = "0123456789abcdef";
5154 for(i = 0; i < outlen; ++i)
5156 outhex[2*i] = hexmap[(out[i] >> 4) & 15];
5157 outhex[2*i+1] = hexmap[(out[i] >> 0) & 15];
5160 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, outhex);
5163 PRVM_G_INT(OFS_RETURN) = 0;
5166 void VM_wasfreed (prvm_prog_t *prog)
5168 VM_SAFEPARMCOUNT(1, VM_wasfreed);
5169 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICT(OFS_PARM0)->free;
5172 void VM_SetTraceGlobals(prvm_prog_t *prog, const trace_t *trace)
5174 PRVM_gameglobalfloat(trace_allsolid) = trace->allsolid;
5175 PRVM_gameglobalfloat(trace_startsolid) = trace->startsolid;
5176 PRVM_gameglobalfloat(trace_fraction) = trace->fraction;
5177 PRVM_gameglobalfloat(trace_inwater) = trace->inwater;
5178 PRVM_gameglobalfloat(trace_inopen) = trace->inopen;
5179 VectorCopy(trace->endpos, PRVM_gameglobalvector(trace_endpos));
5180 VectorCopy(trace->plane.normal, PRVM_gameglobalvector(trace_plane_normal));
5181 PRVM_gameglobalfloat(trace_plane_dist) = trace->plane.dist;
5182 PRVM_gameglobaledict(trace_ent) = PRVM_EDICT_TO_PROG(trace->ent ? trace->ent : prog->edicts);
5183 PRVM_gameglobalfloat(trace_dpstartcontents) = trace->startsupercontents;
5184 PRVM_gameglobalfloat(trace_dphitcontents) = trace->hitsupercontents;
5185 PRVM_gameglobalfloat(trace_dphitq3surfaceflags) = trace->hitq3surfaceflags;
5186 PRVM_gameglobalstring(trace_dphittexturename) = trace->hittexture ? PRVM_SetTempString(prog, trace->hittexture->name) : 0;
5189 void VM_ClearTraceGlobals(prvm_prog_t *prog)
5191 // clean up all trace globals when leaving the VM (anti-triggerbot safeguard)
5192 PRVM_gameglobalfloat(trace_allsolid) = 0;
5193 PRVM_gameglobalfloat(trace_startsolid) = 0;
5194 PRVM_gameglobalfloat(trace_fraction) = 0;
5195 PRVM_gameglobalfloat(trace_inwater) = 0;
5196 PRVM_gameglobalfloat(trace_inopen) = 0;
5197 VectorClear(PRVM_gameglobalvector(trace_endpos));
5198 VectorClear(PRVM_gameglobalvector(trace_plane_normal));
5199 PRVM_gameglobalfloat(trace_plane_dist) = 0;
5200 PRVM_gameglobaledict(trace_ent) = PRVM_EDICT_TO_PROG(prog->edicts);
5201 PRVM_gameglobalfloat(trace_dpstartcontents) = 0;
5202 PRVM_gameglobalfloat(trace_dphitcontents) = 0;
5203 PRVM_gameglobalfloat(trace_dphitq3surfaceflags) = 0;
5204 PRVM_gameglobalstring(trace_dphittexturename) = 0;
5209 void VM_Cmd_Init(prvm_prog_t *prog)
5211 // only init the stuff for the current prog
5212 VM_Files_Init(prog);
5213 VM_Search_Init(prog);
5216 static void animatemodel_reset(prvm_prog_t *prog);
5218 void VM_Cmd_Reset(prvm_prog_t *prog)
5220 CL_PurgeOwner( MENUOWNER );
5221 VM_Search_Reset(prog);
5222 VM_Files_CloseAll(prog);
5223 animatemodel_reset(prog);
5226 // #510 string(string input, ...) uri_escape (DP_QC_URI_ESCAPE)
5227 // does URI escaping on a string (replace evil stuff by %AB escapes)
5228 void VM_uri_escape (prvm_prog_t *prog)
5230 char src[VM_STRINGTEMP_LENGTH];
5231 char dest[VM_STRINGTEMP_LENGTH];
5233 static const char *hex = "0123456789ABCDEF";
5235 VM_SAFEPARMCOUNTRANGE(1, 8, VM_uri_escape);
5236 VM_VarString(prog, 0, src, sizeof(src));
5238 for(p = src, q = dest; *p && q < dest + sizeof(dest) - 3; ++p)
5240 if((*p >= 'A' && *p <= 'Z')
5241 || (*p >= 'a' && *p <= 'z')
5242 || (*p >= '0' && *p <= '9')
5243 || (*p == '-') || (*p == '_') || (*p == '.')
5244 || (*p == '!') || (*p == '~')
5245 || (*p == '\'') || (*p == '(') || (*p == ')'))
5250 *q++ = hex[(*(unsigned char *)p >> 4) & 0xF];
5251 *q++ = hex[ *(unsigned char *)p & 0xF];
5256 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, dest);
5259 // #510 string(string input, ...) uri_unescape (DP_QC_URI_ESCAPE)
5260 // does URI unescaping on a string (get back the evil stuff)
5261 void VM_uri_unescape (prvm_prog_t *prog)
5263 char src[VM_STRINGTEMP_LENGTH];
5264 char dest[VM_STRINGTEMP_LENGTH];
5268 VM_SAFEPARMCOUNTRANGE(1, 8, VM_uri_unescape);
5269 VM_VarString(prog, 0, src, sizeof(src));
5271 for(p = src, q = dest; *p; ) // no need to check size, because unescape can't expand
5275 if(p[1] >= '0' && p[1] <= '9')
5277 else if(p[1] >= 'a' && p[1] <= 'f')
5278 hi = p[1] - 'a' + 10;
5279 else if(p[1] >= 'A' && p[1] <= 'F')
5280 hi = p[1] - 'A' + 10;
5283 if(p[2] >= '0' && p[2] <= '9')
5285 else if(p[2] >= 'a' && p[2] <= 'f')
5286 lo = p[2] - 'a' + 10;
5287 else if(p[2] >= 'A' && p[2] <= 'F')
5288 lo = p[2] - 'A' + 10;
5291 if(hi != 0 || lo != 0) // don't unescape NUL bytes
5292 *q++ = (char) (hi * 0x10 + lo);
5303 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, dest);
5306 // #502 string(string filename) whichpack (DP_QC_WHICHPACK)
5307 // returns the name of the pack containing a file, or "" if it is not in any pack (but local or non-existant)
5308 void VM_whichpack (prvm_prog_t *prog)
5310 const char *fn, *pack;
5312 VM_SAFEPARMCOUNT(1, VM_whichpack);
5313 fn = PRVM_G_STRING(OFS_PARM0);
5314 pack = FS_WhichPack(fn);
5316 PRVM_G_INT(OFS_RETURN) = pack ? PRVM_SetTempString(prog, pack) : 0;
5324 char buffer[MAX_INPUTLINE];
5326 unsigned char *postdata; // free when uri_to_prog_t is freed
5328 char *sigdata; // free when uri_to_prog_t is freed
5333 static void uri_to_string_callback(int status, size_t length_received, unsigned char *buffer, void *cbdata)
5336 uri_to_prog_t *handle = (uri_to_prog_t *) cbdata;
5338 prog = handle->prog;
5341 // curl reply came too late... so just drop it
5342 if(handle->postdata)
5343 Z_Free(handle->postdata);
5345 Z_Free(handle->sigdata);
5350 if((prog->starttime == handle->starttime) && (PRVM_allfunction(URI_Get_Callback)))
5352 if(length_received >= sizeof(handle->buffer))
5353 length_received = sizeof(handle->buffer) - 1;
5354 handle->buffer[length_received] = 0;
5356 PRVM_G_FLOAT(OFS_PARM0) = handle->id;
5357 PRVM_G_FLOAT(OFS_PARM1) = status;
5358 PRVM_G_INT(OFS_PARM2) = PRVM_SetTempString(prog, handle->buffer);
5359 prog->ExecuteProgram(prog, PRVM_allfunction(URI_Get_Callback), "QC function URI_Get_Callback is missing");
5362 if(handle->postdata)
5363 Z_Free(handle->postdata);
5365 Z_Free(handle->sigdata);
5369 // uri_get() gets content from an URL and calls a callback "uri_get_callback" with it set as string; an unique ID of the transfer is returned
5370 // returns 1 on success, and then calls the callback with the ID, 0 or the HTTP status code, and the received data in a string
5371 void VM_uri_get (prvm_prog_t *prog)
5376 uri_to_prog_t *handle;
5377 const char *posttype = NULL;
5378 const char *postseparator = NULL;
5379 int poststringbuffer = -1;
5381 const char *query_string = NULL;
5384 if(!PRVM_allfunction(URI_Get_Callback))
5385 prog->error_cmd("uri_get called by %s without URI_Get_Callback defined", prog->name);
5387 VM_SAFEPARMCOUNTRANGE(2, 6, VM_uri_get);
5389 url = PRVM_G_STRING(OFS_PARM0);
5390 id = PRVM_G_FLOAT(OFS_PARM1);
5392 posttype = PRVM_G_STRING(OFS_PARM2);
5394 postseparator = PRVM_G_STRING(OFS_PARM3);
5396 poststringbuffer = PRVM_G_FLOAT(OFS_PARM4);
5398 postkeyid = PRVM_G_FLOAT(OFS_PARM5);
5399 handle = (uri_to_prog_t *) Z_Malloc(sizeof(*handle)); // this can't be the prog's mem pool, as curl may call the callback later!
5401 query_string = strchr(url, '?');
5404 lq = query_string ? strlen(query_string) : 0;
5406 handle->prog = prog;
5407 handle->starttime = prog->starttime;
5409 if(postseparator && posttype && *posttype)
5411 size_t l = strlen(postseparator);
5412 if(poststringbuffer >= 0)
5417 prvm_stringbuffer_t *stringbuffer;
5418 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, poststringbuffer);
5421 VM_Warning(prog, "uri_get: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
5425 for(i = 0;i < stringbuffer->num_strings;i++)
5429 if(stringbuffer->strings[i])
5430 ltotal += strlen(stringbuffer->strings[i]);
5432 handle->postdata = (unsigned char *)Z_Malloc(ltotal + 1 + lq);
5433 handle->postlen = ltotal;
5435 for(i = 0;i < stringbuffer->num_strings;i++)
5439 memcpy(handle->postdata + ltotal, postseparator, l);
5442 if(stringbuffer->strings[i])
5444 memcpy(handle->postdata + ltotal, stringbuffer->strings[i], strlen(stringbuffer->strings[i]));
5445 ltotal += strlen(stringbuffer->strings[i]);
5448 if(ltotal != handle->postlen)
5449 prog->error_cmd("%s: string buffer content size mismatch, possible overrun", prog->name);
5453 handle->postdata = (unsigned char *)Z_Malloc(l + 1 + lq);
5454 handle->postlen = l;
5455 memcpy(handle->postdata, postseparator, l);
5457 handle->postdata[handle->postlen] = 0;
5459 memcpy(handle->postdata + handle->postlen + 1, query_string, lq);
5462 // POST: we sign postdata \0 query string
5464 handle->sigdata = (char *)Z_Malloc(8192);
5465 strlcpy(handle->sigdata, "X-D0-Blind-ID-Detached-Signature: ", 8192);
5466 l = strlen(handle->sigdata);
5467 handle->siglen = Crypto_SignDataDetached(handle->postdata, handle->postlen + 1 + lq, postkeyid, handle->sigdata + l, 8192 - l);
5470 Z_Free(handle->sigdata);
5471 handle->sigdata = NULL;
5474 ll = base64_encode((unsigned char *) (handle->sigdata + l), handle->siglen, 8192 - l - 1);
5477 Z_Free(handle->sigdata);
5478 handle->sigdata = NULL;
5481 handle->siglen = l + ll;
5482 handle->sigdata[handle->siglen] = 0;
5485 strlcpy(handle->posttype, posttype, sizeof(handle->posttype));
5486 ret = Curl_Begin_ToMemory_POST(url, handle->sigdata, 0, handle->posttype, handle->postdata, handle->postlen, (unsigned char *) handle->buffer, sizeof(handle->buffer), uri_to_string_callback, handle);
5490 if(postkeyid >= 0 && query_string)
5492 // GET: we sign JUST the query string
5494 handle->sigdata = (char *)Z_Malloc(8192);
5495 strlcpy(handle->sigdata, "X-D0-Blind-ID-Detached-Signature: ", 8192);
5496 l = strlen(handle->sigdata);
5497 handle->siglen = Crypto_SignDataDetached(query_string, lq, postkeyid, handle->sigdata + l, 8192 - l);
5500 Z_Free(handle->sigdata);
5501 handle->sigdata = NULL;
5504 ll = base64_encode((unsigned char *) (handle->sigdata + l), handle->siglen, 8192 - l - 1);
5507 Z_Free(handle->sigdata);
5508 handle->sigdata = NULL;
5511 handle->siglen = l + ll;
5512 handle->sigdata[handle->siglen] = 0;
5515 handle->postdata = NULL;
5516 handle->postlen = 0;
5517 ret = Curl_Begin_ToMemory_POST(url, handle->sigdata, 0, NULL, NULL, 0, (unsigned char *) handle->buffer, sizeof(handle->buffer), uri_to_string_callback, handle);
5521 PRVM_G_INT(OFS_RETURN) = 1;
5525 if(handle->postdata)
5526 Z_Free(handle->postdata);
5528 Z_Free(handle->sigdata);
5530 PRVM_G_INT(OFS_RETURN) = 0;
5534 void VM_netaddress_resolve (prvm_prog_t *prog)
5537 char normalized[128];
5539 lhnetaddress_t addr;
5541 VM_SAFEPARMCOUNTRANGE(1, 2, VM_netaddress_resolve);
5543 ip = PRVM_G_STRING(OFS_PARM0);
5546 port = (int) PRVM_G_FLOAT(OFS_PARM1);
5548 if(LHNETADDRESS_FromString(&addr, ip, port) && LHNETADDRESS_ToString(&addr, normalized, sizeof(normalized), prog->argc > 1))
5549 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, normalized);
5551 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
5554 //string(prvm_prog_t *prog) getextresponse = #624; // returns the next extResponse packet that was sent to this client
5555 void VM_CL_getextresponse (prvm_prog_t *prog)
5557 VM_SAFEPARMCOUNT(0,VM_argv);
5559 if (cl_net_extresponse_count <= 0)
5560 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
5564 --cl_net_extresponse_count;
5565 first = (cl_net_extresponse_last + NET_EXTRESPONSE_MAX - cl_net_extresponse_count) % NET_EXTRESPONSE_MAX;
5566 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, cl_net_extresponse[first]);
5570 void VM_SV_getextresponse (prvm_prog_t *prog)
5572 VM_SAFEPARMCOUNT(0,VM_argv);
5574 if (sv_net_extresponse_count <= 0)
5575 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
5579 --sv_net_extresponse_count;
5580 first = (sv_net_extresponse_last + NET_EXTRESPONSE_MAX - sv_net_extresponse_count) % NET_EXTRESPONSE_MAX;
5581 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, sv_net_extresponse[first]);
5585 // DP_QC_NUDGEOUTOFSOLID
5586 // float(entity ent) nudgeoutofsolid = #567;
5587 void VM_nudgeoutofsolid(prvm_prog_t *prog)
5591 VM_SAFEPARMCOUNTRANGE(1, 1, VM_nudgeoutofsolid);
5593 ent = PRVM_G_EDICT(OFS_PARM0);
5594 if (ent == prog->edicts)
5596 VM_Warning(prog, "nudgeoutofsolid: can not modify world entity\n");
5597 PRVM_G_FLOAT(OFS_RETURN) = 0;
5602 VM_Warning(prog, "nudgeoutofsolid: can not modify free entity\n");
5603 PRVM_G_FLOAT(OFS_RETURN) = 0;
5607 PRVM_G_FLOAT(OFS_RETURN) = PHYS_NudgeOutOfSolid(prog, ent);
5609 if (PRVM_G_FLOAT(OFS_RETURN) > 0)
5611 if (prog == SVVM_prog)
5613 else if (prog == CLVM_prog)
5616 Sys_Error("PHYS_NudgeOutOfSolid: cannot be called from %s VM\n", prog->name);
5622 Common functions between menu.dat and clsprogs
5626 //#349 float() isdemo
5627 void VM_CL_isdemo (prvm_prog_t *prog)
5629 VM_SAFEPARMCOUNT(0, VM_CL_isdemo);
5630 PRVM_G_FLOAT(OFS_RETURN) = cls.demoplayback;
5633 //#355 float() videoplaying
5634 void VM_CL_videoplaying (prvm_prog_t *prog)
5636 VM_SAFEPARMCOUNT(0, VM_CL_videoplaying);
5637 PRVM_G_FLOAT(OFS_RETURN) = cl_videoplaying;
5644 callfunction(...,string function_name)
5648 void VM_callfunction(prvm_prog_t *prog)
5653 VM_SAFEPARMCOUNTRANGE(1, 8, VM_callfunction);
5655 s = PRVM_G_STRING(OFS_PARM0+(prog->argc - 1)*3);
5657 VM_CheckEmptyString(prog, s);
5659 func = PRVM_ED_FindFunction(prog, s);
5662 prog->error_cmd("VM_callfunction: function %s not found !", s);
5663 else if (func->first_statement < 0)
5665 // negative statements are built in functions
5666 int builtinnumber = -func->first_statement;
5667 prog->xfunction->builtinsprofile++;
5668 if (builtinnumber < prog->numbuiltins && prog->builtins[builtinnumber])
5669 prog->builtins[builtinnumber](prog);
5671 prog->error_cmd("No such builtin #%i in %s; most likely cause: outdated engine build. Try updating!", builtinnumber, prog->name);
5673 else if(func - prog->functions > 0)
5676 prog->ExecuteProgram(prog, func - prog->functions,"");
5685 float isfunction(string function_name)
5688 void VM_isfunction(prvm_prog_t *prog)
5693 VM_SAFEPARMCOUNT(1, VM_isfunction);
5695 s = PRVM_G_STRING(OFS_PARM0);
5697 VM_CheckEmptyString(prog, s);
5699 func = PRVM_ED_FindFunction(prog, s);
5702 PRVM_G_FLOAT(OFS_RETURN) = false;
5704 PRVM_G_FLOAT(OFS_RETURN) = true;
5711 string sprintf(string format, ...)
5715 void VM_sprintf(prvm_prog_t *prog)
5718 char outbuf[MAX_INPUTLINE];
5719 char *o = outbuf, *end = outbuf + sizeof(outbuf), *err;
5722 int width, precision, thisarg, flags;
5726 static prvm_int_t dummyivec[3] = {0, 0, 0};
5727 static prvm_vec_t dummyvec[3] = {0, 0, 0};
5730 #define PRINTF_ALTERNATE 1
5731 #define PRINTF_ZEROPAD 2
5732 #define PRINTF_LEFT 4
5733 #define PRINTF_SPACEPOSITIVE 8
5734 #define PRINTF_SIGNPOSITIVE 16
5738 s = PRVM_G_STRING(OFS_PARM0);
5740 #define GETARG_FLOAT(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_FLOAT(OFS_PARM0 + 3 * (a))) : 0)
5741 #define GETARG_VECTOR(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_VECTOR(OFS_PARM0 + 3 * (a))) : dummyvec)
5742 #define GETARG_INT(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_INT(OFS_PARM0 + 3 * (a))) : 0)
5743 #define GETARG_INTVECTOR(a) (((a)>=1 && (a)<prog->argc) ? ((prvm_int_t*) PRVM_G_VECTOR(OFS_PARM0 + 3 * (a))) : dummyivec)
5744 #define GETARG_STRING(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_STRING(OFS_PARM0 + 3 * (a))) : "")
5759 // complete directive format:
5768 // is number following?
5769 if(*s >= '0' && *s <= '9')
5771 width = strtol(s, &err, 10);
5774 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5787 flags |= PRINTF_ZEROPAD;
5789 width = -1; // it was just a flag
5801 case '#': flags |= PRINTF_ALTERNATE; break;
5802 case '0': flags |= PRINTF_ZEROPAD; break;
5803 case '-': flags |= PRINTF_LEFT; break;
5804 case ' ': flags |= PRINTF_SPACEPOSITIVE; break;
5805 case '+': flags |= PRINTF_SIGNPOSITIVE; break;
5815 if(*s >= '0' && *s <= '9')
5817 width = strtol(s, &err, 10);
5818 if(!err || *err != '$')
5820 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5827 width = GETARG_FLOAT(width);
5830 flags |= PRINTF_LEFT;
5834 else if(*s >= '0' && *s <= '9')
5836 width = strtol(s, &err, 10);
5839 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5845 flags |= PRINTF_LEFT;
5849 // otherwise width stays -1
5858 if(*s >= '0' && *s <= '9')
5860 precision = strtol(s, &err, 10);
5861 if(!err || *err != '$')
5863 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5869 precision = argpos++;
5870 precision = GETARG_FLOAT(precision);
5872 else if(*s >= '0' && *s <= '9')
5874 precision = strtol(s, &err, 10);
5877 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5884 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5893 case 'h': isfloat = 1; break;
5894 case 'l': isfloat = 0; break;
5895 case 'L': isfloat = 0; break;
5906 // now s points to the final directive char and is no longer changed
5921 if(*s != 's' && *s != 'c')
5922 if(flags & PRINTF_ALTERNATE) *f++ = '#';
5923 if(flags & PRINTF_ZEROPAD) *f++ = '0';
5924 if(flags & PRINTF_LEFT) *f++ = '-';
5925 if(flags & PRINTF_SPACEPOSITIVE) *f++ = ' ';
5926 if(flags & PRINTF_SIGNPOSITIVE) *f++ = '+';
5933 if(*s == 'd' || *s == 'i' || *s == 'o' || *s == 'u' || *s == 'x' || *s == 'X')
5935 // make it use a good integer type
5936 for(p = INT_LOSSLESS_FORMAT_SIZE; *p; )
5942 if(width < 0) // not set
5948 if(precision < 0) // not set
5949 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? INT_LOSSLESS_FORMAT_CONVERT_S(GETARG_FLOAT(thisarg)) : INT_LOSSLESS_FORMAT_CONVERT_S(GETARG_INT(thisarg))));
5951 o += dpsnprintf(o, end - o, formatbuf, width, precision, (isfloat ? INT_LOSSLESS_FORMAT_CONVERT_S(GETARG_FLOAT(thisarg)) : INT_LOSSLESS_FORMAT_CONVERT_S(GETARG_INT(thisarg))));
5953 case 'o': case 'u': case 'x': case 'X':
5954 if(precision < 0) // not set
5955 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? INT_LOSSLESS_FORMAT_CONVERT_U(GETARG_FLOAT(thisarg)) : INT_LOSSLESS_FORMAT_CONVERT_U(GETARG_INT(thisarg))));
5957 o += dpsnprintf(o, end - o, formatbuf, width, precision, (isfloat ? INT_LOSSLESS_FORMAT_CONVERT_U(GETARG_FLOAT(thisarg)) : INT_LOSSLESS_FORMAT_CONVERT_U(GETARG_INT(thisarg))));
5959 case 'e': case 'E': case 'f': case 'F': case 'g': case 'G':
5960 if(precision < 0) // not set
5961 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? (double) GETARG_FLOAT(thisarg) : (double) GETARG_INT(thisarg)));
5963 o += dpsnprintf(o, end - o, formatbuf, width, precision, (isfloat ? (double) GETARG_FLOAT(thisarg) : (double) GETARG_INT(thisarg)));
5967 if(precision < 0) // not set
5968 o += dpsnprintf(o, end - o, va(vabuf, sizeof(vabuf), "%s %s %s", /* NESTED SPRINTF IS NESTED */ formatbuf, formatbuf, formatbuf),
5969 width, (isfloat ? (double) GETARG_VECTOR(thisarg)[0] : (double) GETARG_INTVECTOR(thisarg)[0]),
5970 width, (isfloat ? (double) GETARG_VECTOR(thisarg)[1] : (double) GETARG_INTVECTOR(thisarg)[1]),
5971 width, (isfloat ? (double) GETARG_VECTOR(thisarg)[2] : (double) GETARG_INTVECTOR(thisarg)[2])
5974 o += dpsnprintf(o, end - o, va(vabuf, sizeof(vabuf), "%s %s %s", /* NESTED SPRINTF IS NESTED */ formatbuf, formatbuf, formatbuf),
5975 width, precision, (isfloat ? (double) GETARG_VECTOR(thisarg)[0] : (double) GETARG_INTVECTOR(thisarg)[0]),
5976 width, precision, (isfloat ? (double) GETARG_VECTOR(thisarg)[1] : (double) GETARG_INTVECTOR(thisarg)[1]),
5977 width, precision, (isfloat ? (double) GETARG_VECTOR(thisarg)[2] : (double) GETARG_INTVECTOR(thisarg)[2])
5981 if(flags & PRINTF_ALTERNATE)
5983 if(precision < 0) // not set
5984 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? (unsigned int) GETARG_FLOAT(thisarg) : (unsigned int) GETARG_INT(thisarg)));
5986 o += dpsnprintf(o, end - o, formatbuf, width, precision, (isfloat ? (unsigned int) GETARG_FLOAT(thisarg) : (unsigned int) GETARG_INT(thisarg)));
5990 unsigned int c = (isfloat ? (unsigned int) GETARG_FLOAT(thisarg) : (unsigned int) GETARG_INT(thisarg));
5992 const char *buf = u8_encodech(c, NULL, charbuf16);
5995 if(precision < 0) // not set
5996 precision = end - o - 1;
5997 o += u8_strpad(o, end - o, buf, (flags & PRINTF_LEFT) != 0, width, precision);
6000 //spike FIXME -- 'S' for quoted tokenize-safe-or-print escaping of strings so stuff can safely survive console commands.
6002 if(flags & PRINTF_ALTERNATE)
6004 if(precision < 0) // not set
6005 o += dpsnprintf(o, end - o, formatbuf, width, GETARG_STRING(thisarg));
6007 o += dpsnprintf(o, end - o, formatbuf, width, precision, GETARG_STRING(thisarg));
6011 if(precision < 0) // not set
6012 precision = end - o - 1;
6013 if(flags & PRINTF_SIGNPOSITIVE)
6014 o += u8_strpad(o, end - o, GETARG_STRING(thisarg), (flags & PRINTF_LEFT) != 0, width, precision);
6016 o += u8_strpad_colorcodes(o, end - o, GETARG_STRING(thisarg), (flags & PRINTF_LEFT) != 0, width, precision);
6020 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
6036 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, outbuf);
6042 static model_t *getmodel(prvm_prog_t *prog, prvm_edict_t *ed)
6044 if (prog == SVVM_prog)
6045 return SV_GetModelFromEdict(ed);
6046 else if (prog == CLVM_prog)
6047 return CL_GetModelFromEdict(ed);
6052 struct animatemodel_cache
6055 frameblend_t frameblend[MAX_FRAMEBLENDS];
6056 skeleton_t *skeleton_p;
6057 skeleton_t skeleton;
6058 float *data_vertex3f;
6059 float *data_svector3f;
6060 float *data_tvector3f;
6061 float *data_normal3f;
6063 float *buf_vertex3f;
6064 float *buf_svector3f;
6065 float *buf_tvector3f;
6066 float *buf_normal3f;
6069 static void animatemodel_reset(prvm_prog_t *prog)
6071 if (!prog->animatemodel_cache)
6073 if(prog->animatemodel_cache->buf_vertex3f) Mem_Free(prog->animatemodel_cache->buf_vertex3f);
6074 if(prog->animatemodel_cache->buf_svector3f) Mem_Free(prog->animatemodel_cache->buf_svector3f);
6075 if(prog->animatemodel_cache->buf_tvector3f) Mem_Free(prog->animatemodel_cache->buf_tvector3f);
6076 if(prog->animatemodel_cache->buf_normal3f) Mem_Free(prog->animatemodel_cache->buf_normal3f);
6077 Mem_Free(prog->animatemodel_cache);
6080 static void animatemodel(prvm_prog_t *prog, model_t *model, prvm_edict_t *ed)
6082 skeleton_t *skeleton;
6083 int skeletonindex = -1;
6085 struct animatemodel_cache *animatemodel_cache;
6086 if (!prog->animatemodel_cache)
6088 prog->animatemodel_cache = (struct animatemodel_cache *)Mem_Alloc(prog->progs_mempool, sizeof(struct animatemodel_cache));
6089 memset(prog->animatemodel_cache, 0, sizeof(struct animatemodel_cache));
6091 animatemodel_cache = prog->animatemodel_cache;
6092 if(!(model->surfmesh.isanimated && model->AnimateVertices))
6094 animatemodel_cache->data_vertex3f = model->surfmesh.data_vertex3f;
6095 animatemodel_cache->data_svector3f = model->surfmesh.data_svector3f;
6096 animatemodel_cache->data_tvector3f = model->surfmesh.data_tvector3f;
6097 animatemodel_cache->data_normal3f = model->surfmesh.data_normal3f;
6100 need |= (animatemodel_cache->model != model);
6101 VM_GenerateFrameGroupBlend(prog, ed->priv.server->framegroupblend, ed);
6102 VM_FrameBlendFromFrameGroupBlend(ed->priv.server->frameblend, ed->priv.server->framegroupblend, model, PRVM_serverglobalfloat(time));
6103 need |= (memcmp(&animatemodel_cache->frameblend, &ed->priv.server->frameblend, sizeof(ed->priv.server->frameblend))) != 0;
6104 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
6105 if (!(skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones))
6107 need |= (animatemodel_cache->skeleton_p != skeleton);
6109 need |= (memcmp(&animatemodel_cache->skeleton, skeleton, sizeof(ed->priv.server->skeleton))) != 0;
6112 if(model->surfmesh.num_vertices > animatemodel_cache->max_vertices)
6114 animatemodel_cache->max_vertices = model->surfmesh.num_vertices * 2;
6115 if(animatemodel_cache->buf_vertex3f) Mem_Free(animatemodel_cache->buf_vertex3f);
6116 if(animatemodel_cache->buf_svector3f) Mem_Free(animatemodel_cache->buf_svector3f);
6117 if(animatemodel_cache->buf_tvector3f) Mem_Free(animatemodel_cache->buf_tvector3f);
6118 if(animatemodel_cache->buf_normal3f) Mem_Free(animatemodel_cache->buf_normal3f);
6119 animatemodel_cache->buf_vertex3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6120 animatemodel_cache->buf_svector3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6121 animatemodel_cache->buf_tvector3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6122 animatemodel_cache->buf_normal3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6124 animatemodel_cache->data_vertex3f = animatemodel_cache->buf_vertex3f;
6125 animatemodel_cache->data_svector3f = animatemodel_cache->buf_svector3f;
6126 animatemodel_cache->data_tvector3f = animatemodel_cache->buf_tvector3f;
6127 animatemodel_cache->data_normal3f = animatemodel_cache->buf_normal3f;
6128 VM_UpdateEdictSkeleton(prog, ed, model, ed->priv.server->frameblend);
6129 model->AnimateVertices(model, ed->priv.server->frameblend, &ed->priv.server->skeleton, animatemodel_cache->data_vertex3f, animatemodel_cache->data_normal3f, animatemodel_cache->data_svector3f, animatemodel_cache->data_tvector3f);
6130 animatemodel_cache->model = model;
6131 memcpy(&animatemodel_cache->frameblend, &ed->priv.server->frameblend, sizeof(ed->priv.server->frameblend));
6132 animatemodel_cache->skeleton_p = skeleton;
6134 memcpy(&animatemodel_cache->skeleton, skeleton, sizeof(ed->priv.server->skeleton));
6137 static void getmatrix(prvm_prog_t *prog, prvm_edict_t *ed, matrix4x4_t *out)
6139 if (prog == SVVM_prog)
6140 SV_GetEntityMatrix(prog, ed, out, false);
6141 else if (prog == CLVM_prog)
6142 CL_GetEntityMatrix(prog, ed, out, false);
6144 *out = identitymatrix;
6147 static void applytransform_forward(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6150 getmatrix(prog, ed, &m);
6151 Matrix4x4_Transform(&m, in, out);
6154 static void applytransform_forward_direction(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6157 getmatrix(prog, ed, &m);
6158 Matrix4x4_Transform3x3(&m, in, out);
6161 static void applytransform_inverted(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6164 getmatrix(prog, ed, &m);
6165 Matrix4x4_Invert_Full(&n, &m);
6166 Matrix4x4_Transform3x3(&n, in, out);
6169 static void applytransform_forward_normal(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6173 getmatrix(prog, ed, &m);
6174 Matrix4x4_TransformPositivePlane(&m, in[0], in[1], in[2], 0, p);
6178 static void clippointtosurface(prvm_prog_t *prog, prvm_edict_t *ed, model_t *model, msurface_t *surface, vec3_t p, vec3_t out)
6181 float *v[3], facenormal[3], edgenormal[3], sidenormal[3], temp[3], offsetdist, dist, bestdist;
6183 animatemodel(prog, model, ed);
6184 bestdist = 1000000000;
6186 for (i = 0, e = (model->surfmesh.data_element3i + 3 * surface->num_firsttriangle);i < surface->num_triangles;i++, e += 3)
6188 // clip original point to each triangle of the surface and find the
6189 // triangle that is closest
6190 v[0] = prog->animatemodel_cache->data_vertex3f + e[0] * 3;
6191 v[1] = prog->animatemodel_cache->data_vertex3f + e[1] * 3;
6192 v[2] = prog->animatemodel_cache->data_vertex3f + e[2] * 3;
6193 TriangleNormal(v[0], v[1], v[2], facenormal);
6194 VectorNormalize(facenormal);
6195 offsetdist = DotProduct(v[0], facenormal) - DotProduct(p, facenormal);
6196 VectorMA(p, offsetdist, facenormal, temp);
6197 for (j = 0, k = 2;j < 3;k = j, j++)
6199 VectorSubtract(v[k], v[j], edgenormal);
6200 CrossProduct(edgenormal, facenormal, sidenormal);
6201 VectorNormalize(sidenormal);
6202 offsetdist = DotProduct(v[k], sidenormal) - DotProduct(temp, sidenormal);
6204 VectorMA(temp, offsetdist, sidenormal, temp);
6206 dist = VectorDistance2(temp, p);
6207 if (bestdist > dist)
6210 VectorCopy(temp, out);
6215 static msurface_t *getsurface(model_t *model, int surfacenum)
6217 if (surfacenum < 0 || surfacenum >= model->submodelsurfaces_end - model->submodelsurfaces_start)
6219 return model->data_surfaces + surfacenum + model->submodelsurfaces_start;
6223 //PF_getsurfacenumpoints, // #434 float(entity e, float s) getsurfacenumpoints = #434;
6224 void VM_getsurfacenumpoints(prvm_prog_t *prog)
6227 msurface_t *surface;
6228 VM_SAFEPARMCOUNT(2, VM_getsurfacenumpoints);
6229 // return 0 if no such surface
6230 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6232 PRVM_G_FLOAT(OFS_RETURN) = 0;
6236 // note: this (incorrectly) assumes it is a simple polygon
6237 PRVM_G_FLOAT(OFS_RETURN) = surface->num_vertices;
6239 //PF_getsurfacepoint, // #435 vector(entity e, float s, float n) getsurfacepoint = #435;
6240 void VM_getsurfacepoint(prvm_prog_t *prog)
6244 msurface_t *surface;
6247 VM_SAFEPARMCOUNT(3, VM_getsurfacepoint);
6248 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6249 ed = PRVM_G_EDICT(OFS_PARM0);
6250 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6252 // note: this (incorrectly) assumes it is a simple polygon
6253 pointnum = (int)PRVM_G_FLOAT(OFS_PARM2);
6254 if (pointnum < 0 || pointnum >= surface->num_vertices)
6256 animatemodel(prog, model, ed);
6257 applytransform_forward(prog, &(prog->animatemodel_cache->data_vertex3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6258 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6260 //PF_getsurfacepointattribute, // #486 vector(entity e, float s, float n, float a) getsurfacepointattribute = #486;
6261 // float SPA_POSITION = 0;
6262 // float SPA_S_AXIS = 1;
6263 // float SPA_T_AXIS = 2;
6264 // float SPA_R_AXIS = 3; // same as SPA_NORMAL
6265 // float SPA_TEXCOORDS0 = 4;
6266 // float SPA_LIGHTMAP0_TEXCOORDS = 5;
6267 // float SPA_LIGHTMAP0_COLOR = 6;
6268 void VM_getsurfacepointattribute(prvm_prog_t *prog)
6272 msurface_t *surface;
6277 VM_SAFEPARMCOUNT(4, VM_getsurfacepointattribute);
6278 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6279 ed = PRVM_G_EDICT(OFS_PARM0);
6280 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6282 pointnum = (int)PRVM_G_FLOAT(OFS_PARM2);
6283 if (pointnum < 0 || pointnum >= surface->num_vertices)
6285 attributetype = (int) PRVM_G_FLOAT(OFS_PARM3);
6287 animatemodel(prog, model, ed);
6289 switch( attributetype ) {
6290 // float SPA_POSITION = 0;
6292 applytransform_forward(prog, &(prog->animatemodel_cache->data_vertex3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6293 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6295 // float SPA_S_AXIS = 1;
6297 applytransform_forward_direction(prog, &(prog->animatemodel_cache->data_svector3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6298 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6300 // float SPA_T_AXIS = 2;
6302 applytransform_forward_direction(prog, &(prog->animatemodel_cache->data_tvector3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6303 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6305 // float SPA_R_AXIS = 3; // same as SPA_NORMAL
6307 applytransform_forward_direction(prog, &(prog->animatemodel_cache->data_normal3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6308 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6310 // float SPA_TEXCOORDS0 = 4;
6312 float *texcoord = &(model->surfmesh.data_texcoordtexture2f + 2 * surface->num_firstvertex)[pointnum * 2];
6313 result[0] = texcoord[0];
6314 result[1] = texcoord[1];
6316 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6319 // float SPA_LIGHTMAP0_TEXCOORDS = 5;
6321 float *texcoord = &(model->surfmesh.data_texcoordlightmap2f + 2 * surface->num_firstvertex)[pointnum * 2];
6322 result[0] = texcoord[0];
6323 result[1] = texcoord[1];
6325 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6328 // float SPA_LIGHTMAP0_COLOR = 6;
6330 // ignore alpha for now..
6331 VectorCopy( &(model->surfmesh.data_lightmapcolor4f + 4 * surface->num_firstvertex)[pointnum * 4], PRVM_G_VECTOR(OFS_RETURN));
6334 VectorSet( PRVM_G_VECTOR(OFS_RETURN), 0.0f, 0.0f, 0.0f );
6338 //PF_getsurfacenormal, // #436 vector(entity e, float s) getsurfacenormal = #436;
6339 void VM_getsurfacenormal(prvm_prog_t *prog)
6342 msurface_t *surface;
6345 VM_SAFEPARMCOUNT(2, VM_getsurfacenormal);
6346 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6347 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6349 // note: this only returns the first triangle, so it doesn't work very
6350 // well for curved surfaces or arbitrary meshes
6351 animatemodel(prog, model, PRVM_G_EDICT(OFS_PARM0));
6352 TriangleNormal((prog->animatemodel_cache->data_vertex3f + 3 * surface->num_firstvertex), (prog->animatemodel_cache->data_vertex3f + 3 * surface->num_firstvertex) + 3, (prog->animatemodel_cache->data_vertex3f + 3 * surface->num_firstvertex) + 6, normal);
6353 applytransform_forward_normal(prog, normal, PRVM_G_EDICT(OFS_PARM0), result);
6354 VectorNormalize(result);
6355 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6357 //PF_getsurfacetexture, // #437 string(entity e, float s) getsurfacetexture = #437;
6358 void VM_getsurfacetexture(prvm_prog_t *prog)
6361 msurface_t *surface;
6362 VM_SAFEPARMCOUNT(2, VM_getsurfacetexture);
6363 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
6364 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6366 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, surface->texture->name);
6368 //PF_getsurfacenearpoint, // #438 float(entity e, vector p) getsurfacenearpoint = #438;
6369 void VM_getsurfacenearpoint(prvm_prog_t *prog)
6371 int surfacenum, best;
6373 vec_t dist, bestdist;
6376 msurface_t *surface;
6378 VM_SAFEPARMCOUNT(2, VM_getsurfacenearpoint);
6379 PRVM_G_FLOAT(OFS_RETURN) = -1;
6380 ed = PRVM_G_EDICT(OFS_PARM0);
6381 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), point);
6383 if (!ed || ed->free)
6385 model = getmodel(prog, ed);
6386 if (!model || !model->num_surfaces)
6389 animatemodel(prog, model, ed);
6391 applytransform_inverted(prog, point, ed, p);
6393 bestdist = 1000000000;
6394 for (surfacenum = model->submodelsurfaces_start;surfacenum < model->submodelsurfaces_end;surfacenum++)
6396 surface = model->data_surfaces + surfacenum;
6397 // first see if the nearest point on the surface's box is closer than the previous match
6398 clipped[0] = bound(surface->mins[0], p[0], surface->maxs[0]) - p[0];
6399 clipped[1] = bound(surface->mins[1], p[1], surface->maxs[1]) - p[1];
6400 clipped[2] = bound(surface->mins[2], p[2], surface->maxs[2]) - p[2];
6401 dist = VectorLength2(clipped);
6402 if (dist < bestdist)
6404 // it is, check the nearest point on the actual geometry
6405 clippointtosurface(prog, ed, model, surface, p, clipped);
6406 VectorSubtract(clipped, p, clipped);
6407 dist += VectorLength2(clipped);
6408 if (dist < bestdist)
6410 // that's closer too, store it as the best match
6411 best = surfacenum - model->submodelsurfaces_start;
6416 PRVM_G_FLOAT(OFS_RETURN) = best;
6418 //PF_getsurfaceclippedpoint, // #439 vector(entity e, float s, vector p) getsurfaceclippedpoint = #439;
6419 void VM_getsurfaceclippedpoint(prvm_prog_t *prog)
6423 msurface_t *surface;
6425 VM_SAFEPARMCOUNT(3, VM_getsurfaceclippedpoint);
6426 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6427 ed = PRVM_G_EDICT(OFS_PARM0);
6428 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6430 animatemodel(prog, model, ed);
6431 VectorCopy(PRVM_G_VECTOR(OFS_PARM2), inp);
6432 applytransform_inverted(prog, inp, ed, p);
6433 clippointtosurface(prog, ed, model, surface, p, out);
6434 VectorAdd(out, PRVM_serveredictvector(ed, origin), PRVM_G_VECTOR(OFS_RETURN));
6437 //PF_getsurfacenumtriangles, // #??? float(entity e, float s) getsurfacenumtriangles = #???;
6438 void VM_getsurfacenumtriangles(prvm_prog_t *prog)
6441 msurface_t *surface;
6442 VM_SAFEPARMCOUNT(2, VM_getsurfacenumtriangles);
6443 // return 0 if no such surface
6444 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6446 PRVM_G_FLOAT(OFS_RETURN) = 0;
6450 PRVM_G_FLOAT(OFS_RETURN) = surface->num_triangles;
6452 //PF_getsurfacetriangle, // #??? vector(entity e, float s, float n) getsurfacetriangle = #???;
6453 void VM_getsurfacetriangle(prvm_prog_t *prog)
6455 const vec3_t d = {-1, -1, -1};
6458 msurface_t *surface;
6460 VM_SAFEPARMCOUNT(3, VM_getsurfacetriangle);
6461 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6462 ed = PRVM_G_EDICT(OFS_PARM0);
6463 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6465 trinum = (int)PRVM_G_FLOAT(OFS_PARM2);
6466 if (trinum < 0 || trinum >= surface->num_triangles)
6468 // FIXME: implement rotation/scaling
6469 VectorMA(&(model->surfmesh.data_element3i + 3 * surface->num_firsttriangle)[trinum * 3], surface->num_firstvertex, d, PRVM_G_VECTOR(OFS_RETURN));
6477 #define VM_physics_ApplyCmd(ed,f) if (!ed->priv.server->ode_body) VM_physics_newstackfunction(prog, ed, f); else World_Physics_ApplyCmd(ed, f)
6479 static edict_odefunc_t *VM_physics_newstackfunction(prvm_prog_t *prog, prvm_edict_t *ed, edict_odefunc_t *f)
6481 edict_odefunc_t *newfunc, *func;
6483 newfunc = (edict_odefunc_t *)Mem_Alloc(prog->progs_mempool, sizeof(edict_odefunc_t));
6484 memcpy(newfunc, f, sizeof(edict_odefunc_t));
6485 newfunc->next = NULL;
6486 if (!ed->priv.server->ode_func)
6487 ed->priv.server->ode_func = newfunc;
6490 for (func = ed->priv.server->ode_func; func->next; func = func->next);
6491 func->next = newfunc;
6497 // void(entity e, float physics_enabled) physics_enable = #;
6498 void VM_physics_enable(prvm_prog_t *prog)
6504 VM_SAFEPARMCOUNT(2, VM_physics_enable);
6506 ed = PRVM_G_EDICT(OFS_PARM0);
6509 if (developer.integer > 0)
6510 VM_Warning(prog, "VM_physics_enable: null entity!\n");
6513 // entity should have MOVETYPE_PHYSICS already set, this can damage memory (making leaked allocation) so warn about this even if non-developer
6514 if (PRVM_serveredictfloat(ed, movetype) != MOVETYPE_PHYSICS)
6516 VM_Warning(prog, "VM_physics_enable: entity is not MOVETYPE_PHYSICS!\n");
6519 f.type = PRVM_G_FLOAT(OFS_PARM1) == 0 ? ODEFUNC_DISABLE : ODEFUNC_ENABLE;
6520 VM_physics_ApplyCmd(ed, &f);
6524 // void(entity e, vector force, vector relative_ofs) physics_addforce = #;
6525 void VM_physics_addforce(prvm_prog_t *prog)
6531 VM_SAFEPARMCOUNT(3, VM_physics_addforce);
6533 ed = PRVM_G_EDICT(OFS_PARM0);
6536 if (developer.integer > 0)
6537 VM_Warning(prog, "VM_physics_addforce: null entity!\n");
6540 // entity should have MOVETYPE_PHYSICS already set, this can damage memory (making leaked allocation) so warn about this even if non-developer
6541 if (PRVM_serveredictfloat(ed, movetype) != MOVETYPE_PHYSICS)
6543 VM_Warning(prog, "VM_physics_addforce: entity is not MOVETYPE_PHYSICS!\n");
6546 f.type = ODEFUNC_FORCE;
6547 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), f.v1);
6548 VectorCopy(PRVM_G_VECTOR(OFS_PARM2), f.v2);
6549 VM_physics_ApplyCmd(ed, &f);
6553 // void(entity e, vector torque) physics_addtorque = #;
6554 void VM_physics_addtorque(prvm_prog_t *prog)
6560 VM_SAFEPARMCOUNT(2, VM_physics_addtorque);
6562 ed = PRVM_G_EDICT(OFS_PARM0);
6565 if (developer.integer > 0)
6566 VM_Warning(prog, "VM_physics_addtorque: null entity!\n");
6569 // entity should have MOVETYPE_PHYSICS already set, this can damage memory (making leaked allocation) so warn about this even if non-developer
6570 if (PRVM_serveredictfloat(ed, movetype) != MOVETYPE_PHYSICS)
6572 VM_Warning(prog, "VM_physics_addtorque: entity is not MOVETYPE_PHYSICS!\n");
6575 f.type = ODEFUNC_TORQUE;
6576 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), f.v1);
6577 VM_physics_ApplyCmd(ed, &f);
6581 extern cvar_t prvm_coverage;
6582 void VM_coverage(prvm_prog_t *prog)
6584 VM_SAFEPARMCOUNT(0, VM_coverage);
6585 if (prog->explicit_profile[prog->xstatement]++ == 0 && (prvm_coverage.integer & 2))
6586 PRVM_ExplicitCoverageEvent(prog, prog->xfunction, prog->xstatement);