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;
32 dpvsnprintf(msg,sizeof(msg),fmt,argptr);
35 Con_Printf(CON_WARN "%s VM warning: %s", prog->name, msg);
37 // TODO: either add a cvar/cmd to control the state dumping or replace some of the calls with Con_Printf [9/13/2006 Black]
38 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
40 recursive = host.realtime;
41 PRVM_PrintState(prog, 0);
47 //============================================================================
50 // TODO DONE: move vm_files and vm_fssearchlist to prvm_prog_t struct
51 // TODO: move vm_files and vm_fssearchlist back [9/13/2006 Black]
52 // TODO: (move vm_files and vm_fssearchlist to prvm_prog_t struct again) [2007-01-23 LadyHavoc]
53 // TODO: will this war ever end? [2007-01-23 LadyHavoc]
55 void VM_CheckEmptyString(prvm_prog_t *prog, const char *s)
57 if (ISWHITESPACE(s[0]))
58 prog->error_cmd("%s: Bad string", prog->name);
61 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)
63 int restorevm_tempstringsbuf_cursize;
64 int save_self = 0; // hush compiler warning
73 save_self = PRVM_gameglobaledict(self);
75 PRVM_gameglobalfloat(time) = ptime;
76 PRVM_gameglobaledict(self) = curself;
77 restorevm_tempstringsbuf_cursize = prog->tempstringsbuf.cursize;
78 PRVM_G_INT(OFS_PARM0) = PRVM_SetTempString(prog, text);
79 prog->ExecuteProgram(prog, *func, error_message);
80 prog->tempstringsbuf.cursize = restorevm_tempstringsbuf_cursize;
82 PRVM_gameglobaledict(self) = save_self;
83 r = (int) PRVM_G_FLOAT(OFS_RETURN) != 0;
89 void VM_GenerateFrameGroupBlend(prvm_prog_t *prog, framegroupblend_t *framegroupblend, const prvm_edict_t *ed)
91 // self.frame is the interpolation target (new frame)
92 // self.frame1time is the animation base time for the interpolation target
93 // self.frame2 is the interpolation start (previous frame)
94 // self.frame2time is the animation base time for the interpolation start
95 // self.lerpfrac is the interpolation strength for self.frame2
96 // self.lerpfrac3 is the interpolation strength for self.frame3
97 // self.lerpfrac4 is the interpolation strength for self.frame4
98 // pitch angle on a player model where the animator set up 5 sets of
99 // animations and the csqc simply lerps between sets)
100 framegroupblend[0].frame = (int) PRVM_gameedictfloat(ed, frame );
101 framegroupblend[1].frame = (int) PRVM_gameedictfloat(ed, frame2 );
102 framegroupblend[2].frame = (int) PRVM_gameedictfloat(ed, frame3 );
103 framegroupblend[3].frame = (int) PRVM_gameedictfloat(ed, frame4 );
104 framegroupblend[0].start = PRVM_gameedictfloat(ed, frame1time);
105 framegroupblend[1].start = PRVM_gameedictfloat(ed, frame2time);
106 framegroupblend[2].start = PRVM_gameedictfloat(ed, frame3time);
107 framegroupblend[3].start = PRVM_gameedictfloat(ed, frame4time);
108 framegroupblend[1].lerp = PRVM_gameedictfloat(ed, lerpfrac );
109 framegroupblend[2].lerp = PRVM_gameedictfloat(ed, lerpfrac3 );
110 framegroupblend[3].lerp = PRVM_gameedictfloat(ed, lerpfrac4 );
111 // assume that the (missing) lerpfrac1 is whatever remains after lerpfrac2+lerpfrac3+lerpfrac4 are summed
112 framegroupblend[0].lerp = 1 - framegroupblend[1].lerp - framegroupblend[2].lerp - framegroupblend[3].lerp;
115 // LadyHavoc: quite tempting to break apart this function to reuse the
116 // duplicated code, but I suspect it is better for performance
118 void VM_FrameBlendFromFrameGroupBlend(frameblend_t *frameblend, const framegroupblend_t *framegroupblend, const model_t *model, double curtime)
120 int sub2, numframes, f, i, k;
121 int isfirstframegroup = true;
123 double sublerp, lerp, d;
124 const animscene_t *scene;
125 const framegroupblend_t *g;
126 frameblend_t *blend = frameblend;
128 memset(blend, 0, MAX_FRAMEBLENDS * sizeof(*blend));
130 // rpolzer: Not testing isanimated here - a model might have
131 // "animations" that move no vertices (but only bones), thus rendering
132 // may assume it's not animated while processing can't.
139 nolerp = ((model->type == mod_sprite) ? !r_lerpsprites.integer : !r_lerpmodels.integer) || (model->nolerp == true);
140 numframes = model->numframes;
141 for (k = 0, g = framegroupblend;k < MAX_FRAMEGROUPBLENDS;k++, g++)
144 if ((unsigned int)f >= (unsigned int)numframes)
146 if (developer_extra.integer)
147 Con_DPrintf("VM_FrameBlendFromFrameGroupBlend: no such frame %d in model %s\n", f, model->name);
155 if (isfirstframegroup)
158 isfirstframegroup = false;
163 if (model->animscenes)
165 scene = model->animscenes + f;
166 f = scene->firstframe;
167 if (scene->framecount > 1)
169 // this code path is only used on .zym models and torches
170 sublerp = scene->framerate * (curtime - g->start);
171 f = (int) floor(sublerp);
174 if (sublerp < (1.0 / 65536.0f))
176 if (sublerp > (65535.0f / 65536.0f))
182 f = (f % scene->framecount);
183 sub2 = (sub2 % scene->framecount);
185 f = bound(0, f, (scene->framecount - 1)) + scene->firstframe;
186 sub2 = bound(0, sub2, (scene->framecount - 1)) + scene->firstframe;
188 // two framelerps produced from one animation
191 for (i = 0;i < MAX_FRAMEBLENDS;i++)
193 if (blend[i].lerp <= 0 || blend[i].subframe == sub2)
195 blend[i].subframe = sub2;
201 d = (1 - sublerp) * lerp;
206 for (i = 0;i < MAX_FRAMEBLENDS;i++)
208 if (blend[i].lerp <= 0 || blend[i].subframe == f)
210 blend[i].subframe = f;
219 void VM_UpdateEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed, const model_t *edmodel, const frameblend_t *frameblend)
221 if (ed->priv.server->skeleton.model != edmodel)
223 VM_RemoveEdictSkeleton(prog, ed);
224 ed->priv.server->skeleton.model = edmodel;
226 if (!ed->priv.server->skeleton.model || !ed->priv.server->skeleton.model->num_bones)
228 if(ed->priv.server->skeleton.relativetransforms)
229 Mem_Free(ed->priv.server->skeleton.relativetransforms);
230 ed->priv.server->skeleton.relativetransforms = NULL;
235 int skeletonindex = -1;
236 skeleton_t *skeleton;
237 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
238 if (skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones)
240 // custom skeleton controlled by the game (FTE_CSQC_SKELETONOBJECTS)
241 if (!ed->priv.server->skeleton.relativetransforms)
242 ed->priv.server->skeleton.relativetransforms = (matrix4x4_t *)Mem_Alloc(prog->progs_mempool, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
243 memcpy(ed->priv.server->skeleton.relativetransforms, skeleton->relativetransforms, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
247 if(ed->priv.server->skeleton.relativetransforms)
248 Mem_Free(ed->priv.server->skeleton.relativetransforms);
249 ed->priv.server->skeleton.relativetransforms = NULL;
254 void VM_RemoveEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed)
256 if (ed->priv.server->skeleton.relativetransforms)
257 Mem_Free(ed->priv.server->skeleton.relativetransforms);
258 memset(&ed->priv.server->skeleton, 0, sizeof(ed->priv.server->skeleton));
264 //============================================================================
267 void VM_VarString(prvm_prog_t *prog, int first, char *out, int outlength)
273 outend = out + outlength - 1;
274 for (i = first;i < prog->argc && out < outend;i++)
276 s = PRVM_G_STRING((OFS_PARM0+i*3));
277 while (out < outend && *s)
287 returns true if the extension is supported by the server
289 checkextension(extensionname)
293 // kind of helper function
294 static qbool checkextension(prvm_prog_t *prog, const char *name)
298 for (e = prog->extensionstring;*e;e++)
300 if(!strcasecmp(*e, name))
303 // special sheck for ODE
304 if (!strncasecmp("DP_PHYSICS_ODE", name, 14))
306 #ifndef LINK_TO_LIBODE
307 return ode_dll ? true : false;
309 #ifdef LINK_TO_LIBODE
318 // special sheck for d0_blind_id
319 if (!strcasecmp("DP_CRYPTO", name))
320 return Crypto_Available();
321 if (!strcasecmp("DP_QC_DIGEST_SHA256", name))
322 return Crypto_Available();
330 void VM_checkextension(prvm_prog_t *prog)
332 VM_SAFEPARMCOUNT(1,VM_checkextension);
334 PRVM_G_FLOAT(OFS_RETURN) = checkextension(prog, PRVM_G_STRING(OFS_PARM0));
341 This is a TERMINAL error, which will kill off the entire prog.
347 void VM_error(prvm_prog_t *prog)
350 char string[VM_STRINGTEMP_LENGTH];
352 VM_VarString(prog, 0, string, sizeof(string));
353 Con_Printf(CON_ERROR "======%s ERROR in %s:\n%s\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
354 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
355 PRVM_ED_Print(prog, ed, NULL);
357 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);
364 Dumps out self, then an error message. The program is aborted and self is
365 removed, but the level can continue.
370 void VM_objerror(prvm_prog_t *prog)
373 char string[VM_STRINGTEMP_LENGTH];
375 VM_VarString(prog, 0, string, sizeof(string));
376 Con_Printf(CON_ERROR "======OBJECT ERROR======\n"); // , prog->name, PRVM_GetString(prog->xfunction->s_name), string); // or include them? FIXME
377 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
378 PRVM_ED_Print(prog, ed, NULL);
379 PRVM_ED_Free (prog, ed);
380 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);
392 void VM_print(prvm_prog_t *prog)
394 char string[VM_STRINGTEMP_LENGTH];
396 VM_VarString(prog, 0, string, sizeof(string));
404 broadcast print to everyone on server
409 void VM_bprint(prvm_prog_t *prog)
411 char string[VM_STRINGTEMP_LENGTH];
415 VM_Warning(prog, "VM_bprint: game is not server(%s) !\n", prog->name);
419 VM_VarString(prog, 0, string, sizeof(string));
420 SV_BroadcastPrint(string);
425 VM_sprint (menu & client but only if server.active == true)
427 single print to a specific client
429 sprint(float clientnum,...[string])
432 void VM_sprint(prvm_prog_t *prog)
436 char string[VM_STRINGTEMP_LENGTH];
438 VM_SAFEPARMCOUNTRANGE(1, 8, VM_sprint);
440 //find client for this entity
441 clientnum = (int)PRVM_G_FLOAT(OFS_PARM0);
442 if (!sv.active || clientnum < 0 || clientnum >= svs.maxclients || !svs.clients[clientnum].active)
444 VM_Warning(prog, "VM_sprint: %s: invalid client or server is not active !\n", prog->name);
448 client = svs.clients + clientnum;
449 if (!client->netconnection)
452 VM_VarString(prog, 1, string, sizeof(string));
453 MSG_WriteChar(&client->netconnection->message,svc_print);
454 MSG_WriteString(&client->netconnection->message, string);
461 single print to the screen
466 void VM_centerprint(prvm_prog_t *prog)
468 char string[VM_STRINGTEMP_LENGTH];
470 VM_SAFEPARMCOUNTRANGE(1, 8, VM_centerprint);
471 VM_VarString(prog, 0, string, sizeof(string));
472 SCR_CenterPrint(string);
479 vector normalize(vector)
482 void VM_normalize(prvm_prog_t *prog)
488 VM_SAFEPARMCOUNT(1,VM_normalize);
490 value1 = PRVM_G_VECTOR(OFS_PARM0);
492 f = VectorLength2(value1);
496 VectorScale(value1, f, newvalue);
499 VectorClear(newvalue);
501 VectorCopy (newvalue, PRVM_G_VECTOR(OFS_RETURN));
511 void VM_vlen(prvm_prog_t *prog)
513 VM_SAFEPARMCOUNT(1,VM_vlen);
514 PRVM_G_FLOAT(OFS_RETURN) = VectorLength(PRVM_G_VECTOR(OFS_PARM0));
521 float vectoyaw(vector)
524 void VM_vectoyaw(prvm_prog_t *prog)
529 VM_SAFEPARMCOUNT(1,VM_vectoyaw);
531 value1 = PRVM_G_VECTOR(OFS_PARM0);
533 if (value1[1] == 0 && value1[0] == 0)
537 yaw = (int) (atan2(value1[1], value1[0]) * 180 / M_PI);
542 PRVM_G_FLOAT(OFS_RETURN) = yaw;
550 vector vectoangles(vector[, vector])
553 void VM_vectoangles(prvm_prog_t *prog)
555 vec3_t result, forward, up;
556 VM_SAFEPARMCOUNTRANGE(1, 2,VM_vectoangles);
558 VectorCopy(PRVM_G_VECTOR(OFS_PARM0), forward);
561 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), up);
562 AnglesFromVectors(result, forward, up, true);
565 AnglesFromVectors(result, forward, NULL, true);
566 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
573 Returns a random number > 0 and < 1
578 void VM_random(prvm_prog_t *prog)
580 VM_SAFEPARMCOUNT(0,VM_random);
582 PRVM_G_FLOAT(OFS_RETURN) = lhrandom(0, 1);
589 localsound(string sample, float chan, float vol)
592 void VM_localsound(prvm_prog_t *prog)
597 VM_SAFEPARMCOUNTRANGE(1, 3,VM_localsound);
599 s = PRVM_G_STRING(OFS_PARM0);
602 chan = PRVM_G_FLOAT(OFS_PARM1);
603 vol = PRVM_G_FLOAT(OFS_PARM2) == 0 ? 1 : PRVM_G_FLOAT(OFS_PARM2);
604 if(!S_LocalSoundEx(s, chan, vol))
606 PRVM_G_FLOAT(OFS_RETURN) = -4;
607 VM_Warning(prog, "VM_localsound: Failed to play %s for %s !\n", s, prog->name);
611 else if(!S_LocalSound (s))
613 PRVM_G_FLOAT(OFS_RETURN) = -4;
614 VM_Warning(prog, "VM_localsound: Failed to play %s for %s !\n", s, prog->name);
618 PRVM_G_FLOAT(OFS_RETURN) = 1;
628 void VM_break(prvm_prog_t *prog)
630 prog->error_cmd("%s: break statement", prog->name);
633 //============================================================================
639 Sends text over to the client's execution buffer
641 [localcmd (string, ...) or]
645 void VM_localcmd_local(prvm_prog_t *prog)
647 char string[VM_STRINGTEMP_LENGTH];
648 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd_local);
649 VM_VarString(prog, 0, string, sizeof(string));
650 Cbuf_AddText(cmd_local, string);
657 Sends text over to the server's execution buffer
659 [localcmd (string, ...) or]
663 void VM_localcmd_server(prvm_prog_t *prog)
665 char string[VM_STRINGTEMP_LENGTH];
666 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd_server);
667 VM_VarString(prog, 0, string, sizeof(string));
668 Cbuf_AddText(cmd_local, string);
671 static qbool PRVM_Cvar_ReadOk(prvm_prog_t *prog, const char *string)
674 cvar = Cvar_FindVar(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask);
675 return ((cvar) && ((cvar->flags & CF_PRIVATE) == 0));
685 void VM_cvar(prvm_prog_t *prog)
687 char string[VM_STRINGTEMP_LENGTH];
688 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
689 VM_VarString(prog, 0, string, sizeof(string));
690 VM_CheckEmptyString(prog, string);
691 PRVM_G_FLOAT(OFS_RETURN) = PRVM_Cvar_ReadOk(prog, string) ? Cvar_VariableValue(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask) : 0;
698 float cvar_type (string)
699 float CVAR_TYPEFLAG_EXISTS = 1;
700 float CVAR_TYPEFLAG_SAVED = 2;
701 float CVAR_TYPEFLAG_PRIVATE = 4;
702 float CVAR_TYPEFLAG_ENGINE = 8;
703 float CVAR_TYPEFLAG_HASDESCRIPTION = 16;
704 float CVAR_TYPEFLAG_READONLY = 32;
707 void VM_cvar_type(prvm_prog_t *prog)
709 char string[VM_STRINGTEMP_LENGTH];
713 VM_SAFEPARMCOUNTRANGE(1, 8, VM_cvar_type);
714 VM_VarString(prog, 0, string, sizeof(string));
715 VM_CheckEmptyString(prog, string);
716 cvar = Cvar_FindVar(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask);
721 PRVM_G_FLOAT(OFS_RETURN) = 0;
722 return; // CVAR_TYPE_NONE
725 ret = 1; // CVAR_EXISTS
726 if(cvar->flags & CF_ARCHIVE)
727 ret |= 2; // CVAR_TYPE_SAVED
728 if(cvar->flags & CF_PRIVATE)
729 ret |= 4; // CVAR_TYPE_PRIVATE
730 if(!(cvar->flags & CF_ALLOCATED))
731 ret |= 8; // CVAR_TYPE_ENGINE
732 if(cvar->description != cvar_dummy_description)
733 ret |= 16; // CVAR_TYPE_HASDESCRIPTION
734 if(cvar->flags & CF_READONLY)
735 ret |= 32; // CVAR_TYPE_READONLY
737 PRVM_G_FLOAT(OFS_RETURN) = ret;
744 const string VM_cvar_string (string, ...)
747 void VM_cvar_string(prvm_prog_t *prog)
749 char string[VM_STRINGTEMP_LENGTH];
750 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_string);
751 VM_VarString(prog, 0, string, sizeof(string));
752 VM_CheckEmptyString(prog, string);
753 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) : "");
758 ========================
761 const string VM_cvar_defstring (string, ...)
762 ========================
764 void VM_cvar_defstring(prvm_prog_t *prog)
766 char string[VM_STRINGTEMP_LENGTH];
767 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_defstring);
768 VM_VarString(prog, 0, string, sizeof(string));
769 VM_CheckEmptyString(prog, string);
770 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDefString(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask));
774 ========================
777 const string VM_cvar_description (string, ...)
778 ========================
780 void VM_cvar_description(prvm_prog_t *prog)
782 char string[VM_STRINGTEMP_LENGTH];
783 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_description);
784 VM_VarString(prog, 0, string, sizeof(string));
785 VM_CheckEmptyString(prog, string);
786 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDescription(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask));
792 void cvar_set (string,string, ...)
795 void VM_cvar_set(prvm_prog_t *prog)
798 char string[VM_STRINGTEMP_LENGTH];
799 VM_SAFEPARMCOUNTRANGE(2,8,VM_cvar_set);
800 VM_VarString(prog, 1, string, sizeof(string));
801 name = PRVM_G_STRING(OFS_PARM0);
802 VM_CheckEmptyString(prog, name);
803 Cvar_Set(prog->console_cmd->cvars, name, string);
813 void VM_dprint(prvm_prog_t *prog)
815 char string[VM_STRINGTEMP_LENGTH];
816 VM_SAFEPARMCOUNTRANGE(1, 8, VM_dprint);
817 VM_VarString(prog, 0, string, sizeof(string));
819 Con_DPrintf("%s", string);
821 Con_DPrintf("%s: %s", prog->name, string);
833 void VM_ftos(prvm_prog_t *prog)
838 VM_SAFEPARMCOUNT(1, VM_ftos);
840 v = PRVM_G_FLOAT(OFS_PARM0);
842 if ((prvm_vec_t)((prvm_int_t)v) == v)
843 dpsnprintf(s, sizeof(s), "%.0f", v);
845 dpsnprintf(s, sizeof(s), "%f", v);
846 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
857 void VM_fabs(prvm_prog_t *prog)
861 VM_SAFEPARMCOUNT(1,VM_fabs);
863 v = PRVM_G_FLOAT(OFS_PARM0);
864 PRVM_G_FLOAT(OFS_RETURN) = fabs(v);
875 void VM_vtos(prvm_prog_t *prog)
879 VM_SAFEPARMCOUNT(1,VM_vtos);
881 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]);
882 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
893 void VM_etos(prvm_prog_t *prog)
897 VM_SAFEPARMCOUNT(1, VM_etos);
899 dpsnprintf (s, sizeof(s), "entity %i", PRVM_G_EDICTNUM(OFS_PARM0));
900 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
907 float stof(...[string])
910 void VM_stof(prvm_prog_t *prog)
912 char string[VM_STRINGTEMP_LENGTH];
913 VM_SAFEPARMCOUNTRANGE(1, 8, VM_stof);
914 VM_VarString(prog, 0, string, sizeof(string));
915 PRVM_G_FLOAT(OFS_RETURN) = atof(string);
919 ========================
923 ========================
925 void VM_itof(prvm_prog_t *prog)
927 VM_SAFEPARMCOUNT(1, VM_itof);
928 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
932 ========================
935 entity ftoe(float num)
936 ========================
938 void VM_ftoe(prvm_prog_t *prog)
941 VM_SAFEPARMCOUNT(1, VM_ftoe);
943 ent = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM0);
944 if (ent < 0 || ent >= prog->max_edicts || PRVM_PROG_TO_EDICT(ent)->free)
945 ent = 0; // return world instead of a free or invalid entity
947 PRVM_G_INT(OFS_RETURN) = ent;
951 ========================
954 float etof(entity ent)
955 ========================
957 void VM_etof(prvm_prog_t *prog)
959 VM_SAFEPARMCOUNT(1, VM_etof);
960 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICTNUM(OFS_PARM0);
967 string strftime(float uselocaltime, string[, string ...])
970 void VM_strftime(prvm_prog_t *prog)
979 char fmt[VM_STRINGTEMP_LENGTH];
980 char result[VM_STRINGTEMP_LENGTH];
981 VM_SAFEPARMCOUNTRANGE(2, 8, VM_strftime);
982 VM_VarString(prog, 1, fmt, sizeof(fmt));
985 if (PRVM_G_FLOAT(OFS_PARM0))
986 tmresult = localtime_s(&tm, &t);
988 tmresult = gmtime_s(&tm, &t);
991 if (PRVM_G_FLOAT(OFS_PARM0))
998 PRVM_G_INT(OFS_RETURN) = 0;
1001 #if _MSC_VER >= 1400
1002 strftime(result, sizeof(result), fmt, &tm);
1004 strftime(result, sizeof(result), fmt, tm);
1006 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, result);
1017 void VM_spawn(prvm_prog_t *prog)
1020 VM_SAFEPARMCOUNT(0, VM_spawn);
1021 prog->xfunction->builtinsprofile += 20;
1022 ed = PRVM_ED_Alloc(prog);
1023 VM_RETURN_EDICT(ed);
1034 void VM_remove(prvm_prog_t *prog)
1037 prog->xfunction->builtinsprofile += 20;
1039 VM_SAFEPARMCOUNT(1, VM_remove);
1041 ed = PRVM_G_EDICT(OFS_PARM0);
1042 if( PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
1044 if (developer.integer > 0)
1045 VM_Warning(prog, "VM_remove: tried to remove the null entity or a reserved entity!\n" );
1049 if (developer.integer > 0)
1050 VM_Warning(prog, "VM_remove: tried to remove an already freed entity!\n" );
1053 PRVM_ED_Free (prog, ed);
1060 entity find(entity start, .string field, string match)
1064 void VM_find(prvm_prog_t *prog)
1071 VM_SAFEPARMCOUNT(3,VM_find);
1073 e = PRVM_G_EDICTNUM(OFS_PARM0);
1074 f = PRVM_G_INT(OFS_PARM1);
1075 s = PRVM_G_STRING(OFS_PARM2);
1077 // LadyHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1078 // expects it to find all the monsters, so we must be careful to support
1081 for (e++ ; e < prog->num_edicts ; e++)
1083 prog->xfunction->builtinsprofile++;
1084 ed = PRVM_EDICT_NUM(e);
1087 t = PRVM_E_STRING(ed,f);
1092 VM_RETURN_EDICT(ed);
1097 VM_RETURN_EDICT(prog->edicts);
1104 entity findfloat(entity start, .float field, float match)
1105 entity findentity(entity start, .entity field, entity match)
1108 // LadyHavoc: added this for searching float, int, and entity reference fields
1109 void VM_findfloat(prvm_prog_t *prog)
1116 VM_SAFEPARMCOUNT(3,VM_findfloat);
1118 e = PRVM_G_EDICTNUM(OFS_PARM0);
1119 f = PRVM_G_INT(OFS_PARM1);
1120 s = PRVM_G_FLOAT(OFS_PARM2);
1122 for (e++ ; e < prog->num_edicts ; e++)
1124 prog->xfunction->builtinsprofile++;
1125 ed = PRVM_EDICT_NUM(e);
1128 if (PRVM_E_FLOAT(ed,f) == s)
1130 VM_RETURN_EDICT(ed);
1135 VM_RETURN_EDICT(prog->edicts);
1142 entity findchain(.string field, string match)
1145 // chained search for strings in entity fields
1146 // entity(.string field, string match) findchain = #402;
1147 void VM_findchain(prvm_prog_t *prog)
1152 prvm_edict_t *ent, *chain;
1155 VM_SAFEPARMCOUNTRANGE(2,3,VM_findchain);
1158 chainfield = PRVM_G_INT(OFS_PARM2);
1160 chainfield = prog->fieldoffsets.chain;
1162 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1164 chain = prog->edicts;
1166 f = PRVM_G_INT(OFS_PARM0);
1167 s = PRVM_G_STRING(OFS_PARM1);
1169 // LadyHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1170 // expects it to find all the monsters, so we must be careful to support
1173 ent = PRVM_NEXT_EDICT(prog->edicts);
1174 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1176 prog->xfunction->builtinsprofile++;
1179 t = PRVM_E_STRING(ent,f);
1185 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_NUM_FOR_EDICT(chain);
1189 VM_RETURN_EDICT(chain);
1196 entity findchainfloat(.string field, float match)
1197 entity findchainentity(.string field, entity match)
1200 // LadyHavoc: chained search for float, int, and entity reference fields
1201 // entity(.string field, float match) findchainfloat = #403;
1202 void VM_findchainfloat(prvm_prog_t *prog)
1207 prvm_edict_t *ent, *chain;
1210 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainfloat);
1213 chainfield = PRVM_G_INT(OFS_PARM2);
1215 chainfield = prog->fieldoffsets.chain;
1217 prog->error_cmd("VM_findchainfloat: %s doesnt have the specified chain field !", prog->name);
1219 chain = (prvm_edict_t *)prog->edicts;
1221 f = PRVM_G_INT(OFS_PARM0);
1222 s = PRVM_G_FLOAT(OFS_PARM1);
1224 ent = PRVM_NEXT_EDICT(prog->edicts);
1225 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1227 prog->xfunction->builtinsprofile++;
1230 if (PRVM_E_FLOAT(ent,f) != s)
1233 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1237 VM_RETURN_EDICT(chain);
1241 ========================
1244 entity findflags(entity start, .float field, float match)
1245 ========================
1247 // LadyHavoc: search for flags in float fields
1248 void VM_findflags(prvm_prog_t *prog)
1255 VM_SAFEPARMCOUNT(3, VM_findflags);
1258 e = PRVM_G_EDICTNUM(OFS_PARM0);
1259 f = PRVM_G_INT(OFS_PARM1);
1260 s = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM2);
1262 for (e++ ; e < prog->num_edicts ; e++)
1264 prog->xfunction->builtinsprofile++;
1265 ed = PRVM_EDICT_NUM(e);
1268 if (!PRVM_E_FLOAT(ed,f))
1270 if ((prvm_int_t)PRVM_E_FLOAT(ed,f) & s)
1272 VM_RETURN_EDICT(ed);
1277 VM_RETURN_EDICT(prog->edicts);
1281 ========================
1284 entity findchainflags(.float field, float match)
1285 ========================
1287 // LadyHavoc: chained search for flags in float fields
1288 void VM_findchainflags(prvm_prog_t *prog)
1293 prvm_edict_t *ent, *chain;
1296 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainflags);
1299 chainfield = PRVM_G_INT(OFS_PARM2);
1301 chainfield = prog->fieldoffsets.chain;
1303 prog->error_cmd("VM_findchainflags: %s doesnt have the specified chain field !", prog->name);
1305 chain = (prvm_edict_t *)prog->edicts;
1307 f = PRVM_G_INT(OFS_PARM0);
1308 s = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM1);
1310 ent = PRVM_NEXT_EDICT(prog->edicts);
1311 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1313 prog->xfunction->builtinsprofile++;
1316 if (!PRVM_E_FLOAT(ent,f))
1318 if (!((prvm_int_t)PRVM_E_FLOAT(ent,f) & s))
1321 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1325 VM_RETURN_EDICT(chain);
1332 string precache_sound (string sample)
1335 void VM_precache_sound(prvm_prog_t *prog)
1339 VM_SAFEPARMCOUNT(1, VM_precache_sound);
1341 s = PRVM_G_STRING(OFS_PARM0);
1342 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1343 //VM_CheckEmptyString(prog, s);
1345 if(snd_initialized.integer && !S_PrecacheSound(s, true, true))
1347 VM_Warning(prog, "VM_precache_sound: Failed to load %s for %s\n", s, prog->name);
1356 returns the same string as output
1358 does nothing, only used by qcc to build .pak archives
1361 void VM_precache_file(prvm_prog_t *prog)
1363 VM_SAFEPARMCOUNT(1,VM_precache_file);
1364 // precache_file is only used to copy files with qcc, it does nothing
1365 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1375 void VM_coredump(prvm_prog_t *prog)
1377 VM_SAFEPARMCOUNT(0,VM_coredump);
1379 Cbuf_AddText(cmd_local, "prvm_edicts ");
1380 Cbuf_AddText(cmd_local, prog->name);
1381 Cbuf_AddText(cmd_local, "\n");
1391 void VM_stackdump(prvm_prog_t *prog)
1393 VM_SAFEPARMCOUNT(0, VM_stackdump);
1395 PRVM_StackTrace(prog);
1406 void VM_crash(prvm_prog_t *prog)
1408 VM_SAFEPARMCOUNT(0, VM_crash);
1410 prog->error_cmd("Crash called by %s",prog->name);
1420 void VM_traceon(prvm_prog_t *prog)
1422 VM_SAFEPARMCOUNT(0,VM_traceon);
1434 void VM_traceoff(prvm_prog_t *prog)
1436 VM_SAFEPARMCOUNT(0,VM_traceoff);
1438 prog->trace = false;
1448 void VM_eprint(prvm_prog_t *prog)
1450 VM_SAFEPARMCOUNT(1,VM_eprint);
1452 PRVM_ED_PrintNum (prog, PRVM_G_EDICTNUM(OFS_PARM0), NULL);
1462 void VM_rint(prvm_prog_t *prog)
1465 VM_SAFEPARMCOUNT(1,VM_rint);
1467 f = PRVM_G_FLOAT(OFS_PARM0);
1469 PRVM_G_FLOAT(OFS_RETURN) = floor(f + 0.5);
1471 PRVM_G_FLOAT(OFS_RETURN) = ceil(f - 0.5);
1481 void VM_floor(prvm_prog_t *prog)
1483 VM_SAFEPARMCOUNT(1,VM_floor);
1485 PRVM_G_FLOAT(OFS_RETURN) = floor(PRVM_G_FLOAT(OFS_PARM0));
1495 void VM_ceil(prvm_prog_t *prog)
1497 VM_SAFEPARMCOUNT(1,VM_ceil);
1499 PRVM_G_FLOAT(OFS_RETURN) = ceil(PRVM_G_FLOAT(OFS_PARM0));
1507 entity nextent(entity)
1510 void VM_nextent(prvm_prog_t *prog)
1515 VM_SAFEPARMCOUNT(1, VM_nextent);
1517 i = PRVM_G_EDICTNUM(OFS_PARM0);
1520 prog->xfunction->builtinsprofile++;
1522 if (i == prog->num_edicts)
1524 VM_RETURN_EDICT(prog->edicts);
1527 ent = PRVM_EDICT_NUM(i);
1530 VM_RETURN_EDICT(ent);
1536 //=============================================================================
1543 changelevel(string map)
1546 void VM_changelevel(prvm_prog_t *prog)
1549 VM_SAFEPARMCOUNT(1, VM_changelevel);
1553 VM_Warning(prog, "VM_changelevel: game is not server (%s)\n", prog->name);
1557 // make sure we don't issue two changelevels
1558 if (svs.changelevel_issued)
1560 svs.changelevel_issued = true;
1562 Cbuf_AddText(cmd_local, va(vabuf, sizeof(vabuf), "changelevel %s\n", PRVM_G_STRING(OFS_PARM0)));
1572 void VM_sin(prvm_prog_t *prog)
1574 VM_SAFEPARMCOUNT(1,VM_sin);
1575 PRVM_G_FLOAT(OFS_RETURN) = sin(PRVM_G_FLOAT(OFS_PARM0));
1584 void VM_cos(prvm_prog_t *prog)
1586 VM_SAFEPARMCOUNT(1,VM_cos);
1587 PRVM_G_FLOAT(OFS_RETURN) = cos(PRVM_G_FLOAT(OFS_PARM0));
1597 void VM_sqrt(prvm_prog_t *prog)
1599 VM_SAFEPARMCOUNT(1,VM_sqrt);
1600 PRVM_G_FLOAT(OFS_RETURN) = sqrt(PRVM_G_FLOAT(OFS_PARM0));
1610 void VM_asin(prvm_prog_t *prog)
1612 VM_SAFEPARMCOUNT(1,VM_asin);
1613 PRVM_G_FLOAT(OFS_RETURN) = asin(PRVM_G_FLOAT(OFS_PARM0));
1622 void VM_acos(prvm_prog_t *prog)
1624 VM_SAFEPARMCOUNT(1,VM_acos);
1625 PRVM_G_FLOAT(OFS_RETURN) = acos(PRVM_G_FLOAT(OFS_PARM0));
1634 void VM_atan(prvm_prog_t *prog)
1636 VM_SAFEPARMCOUNT(1,VM_atan);
1637 PRVM_G_FLOAT(OFS_RETURN) = atan(PRVM_G_FLOAT(OFS_PARM0));
1643 float atan2(float,float)
1646 void VM_atan2(prvm_prog_t *prog)
1648 VM_SAFEPARMCOUNT(2,VM_atan2);
1649 PRVM_G_FLOAT(OFS_RETURN) = atan2(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1658 void VM_tan(prvm_prog_t *prog)
1660 VM_SAFEPARMCOUNT(1,VM_tan);
1661 PRVM_G_FLOAT(OFS_RETURN) = tan(PRVM_G_FLOAT(OFS_PARM0));
1668 Returns a vector of length < 1 and > 0
1673 void VM_randomvec(prvm_prog_t *prog)
1676 VM_SAFEPARMCOUNT(0, VM_randomvec);
1678 VectorCopy(temp, PRVM_G_VECTOR(OFS_RETURN));
1681 //=============================================================================
1687 float registercvar (string name, string value[, float flags])
1690 void VM_registercvar(prvm_prog_t *prog)
1692 const char *name, *value;
1695 VM_SAFEPARMCOUNTRANGE(2, 3, VM_registercvar);
1697 name = PRVM_G_STRING(OFS_PARM0);
1698 value = PRVM_G_STRING(OFS_PARM1);
1699 flags = prog->argc >= 3 ? (int)PRVM_G_FLOAT(OFS_PARM2) : 0;
1700 PRVM_G_FLOAT(OFS_RETURN) = 0;
1702 if(flags > CF_MAXFLAGSVAL)
1705 // first check to see if it has already been defined
1706 if (Cvar_FindVar (prog->console_cmd->cvars, name, prog->console_cmd->cvars_flagsmask))
1709 // check for overlap with a command
1710 if (Cmd_Exists(cmd_local, name))
1712 VM_Warning(prog, "VM_registercvar: %s is a command\n", name);
1716 Cvar_Get(prog->console_cmd->cvars, name, value, prog->console_cmd->cvars_flagsmask | flags, NULL);
1718 PRVM_G_FLOAT(OFS_RETURN) = 1; // success
1726 returns the minimum of two supplied floats
1728 float min(float a, float b, ...[float])
1731 void VM_min(prvm_prog_t *prog)
1733 VM_SAFEPARMCOUNTRANGE(2, 8, VM_min);
1734 // LadyHavoc: 3+ argument enhancement suggested by FrikaC
1735 if (prog->argc >= 3)
1738 float f = PRVM_G_FLOAT(OFS_PARM0);
1739 for (i = 1;i < prog->argc;i++)
1740 if (f > PRVM_G_FLOAT((OFS_PARM0+i*3)))
1741 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1742 PRVM_G_FLOAT(OFS_RETURN) = f;
1745 PRVM_G_FLOAT(OFS_RETURN) = min(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1752 returns the maximum of two supplied floats
1754 float max(float a, float b, ...[float])
1757 void VM_max(prvm_prog_t *prog)
1759 VM_SAFEPARMCOUNTRANGE(2, 8, VM_max);
1760 // LadyHavoc: 3+ argument enhancement suggested by FrikaC
1761 if (prog->argc >= 3)
1764 float f = PRVM_G_FLOAT(OFS_PARM0);
1765 for (i = 1;i < prog->argc;i++)
1766 if (f < PRVM_G_FLOAT((OFS_PARM0+i*3)))
1767 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1768 PRVM_G_FLOAT(OFS_RETURN) = f;
1771 PRVM_G_FLOAT(OFS_RETURN) = max(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1778 returns number bounded by supplied range
1780 float bound(float min, float value, float max)
1783 void VM_bound(prvm_prog_t *prog)
1785 VM_SAFEPARMCOUNT(3,VM_bound);
1786 PRVM_G_FLOAT(OFS_RETURN) = bound(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1), PRVM_G_FLOAT(OFS_PARM2));
1793 returns a raised to power b
1795 float pow(float a, float b)
1798 void VM_pow(prvm_prog_t *prog)
1800 VM_SAFEPARMCOUNT(2,VM_pow);
1801 PRVM_G_FLOAT(OFS_RETURN) = pow(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1804 void VM_log(prvm_prog_t *prog)
1806 VM_SAFEPARMCOUNT(1,VM_log);
1807 PRVM_G_FLOAT(OFS_RETURN) = log(PRVM_G_FLOAT(OFS_PARM0));
1810 void VM_Files_Init(prvm_prog_t *prog)
1813 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1814 prog->openfiles[i] = NULL;
1817 void VM_Files_CloseAll(prvm_prog_t *prog)
1820 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1822 if (prog->openfiles[i])
1823 FS_Close(prog->openfiles[i]);
1824 prog->openfiles[i] = NULL;
1828 static qfile_t *VM_GetFileHandle(prvm_prog_t *prog, int index)
1830 if (index < 0 || index >= PRVM_MAX_OPENFILES)
1832 Con_Printf("VM_GetFileHandle: invalid file handle %i used in %s\n", index, prog->name);
1835 if (prog->openfiles[index] == NULL)
1837 Con_Printf("VM_GetFileHandle: no such file handle %i (or file has been closed) in %s\n", index, prog->name);
1840 return prog->openfiles[index];
1847 float fopen(string filename, float mode)
1850 // float(string filename, float mode) fopen = #110;
1851 // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE),
1852 // returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason
1853 void VM_fopen(prvm_prog_t *prog)
1856 const char *modestring, *filename;
1859 VM_SAFEPARMCOUNT(2,VM_fopen);
1861 for (filenum = 0;filenum < PRVM_MAX_OPENFILES;filenum++)
1862 if (prog->openfiles[filenum] == NULL)
1864 if (filenum >= PRVM_MAX_OPENFILES)
1866 PRVM_G_FLOAT(OFS_RETURN) = -2;
1867 VM_Warning(prog, "VM_fopen: %s ran out of file handles (%i)\n", prog->name, PRVM_MAX_OPENFILES);
1870 filename = PRVM_G_STRING(OFS_PARM0);
1871 mode = (int)PRVM_G_FLOAT(OFS_PARM1);
1874 case 0: // FILE_READ
1876 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
1877 if (prog->openfiles[filenum] == NULL)
1878 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
1880 case 1: // FILE_APPEND
1882 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1884 case 2: // FILE_WRITE
1886 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1889 PRVM_G_FLOAT(OFS_RETURN) = -3;
1890 VM_Warning(prog, "VM_fopen: %s: no such mode %i (valid: 0 = read, 1 = append, 2 = write)\n", prog->name, mode);
1894 if (prog->openfiles[filenum] == NULL)
1896 PRVM_G_FLOAT(OFS_RETURN) = -1;
1897 if (developer_extra.integer)
1898 VM_Warning(prog, "VM_fopen: %s: %s mode %s failed\n", prog->name, filename, modestring);
1902 PRVM_G_FLOAT(OFS_RETURN) = filenum;
1903 if (developer_extra.integer)
1904 Con_DPrintf("VM_fopen: %s: %s mode %s opened as #%i\n", prog->name, filename, modestring, filenum);
1905 prog->openfiles_origin[filenum] = PRVM_AllocationOrigin(prog);
1913 fclose(float fhandle)
1916 //void(float fhandle) fclose = #111; // closes a file
1917 void VM_fclose(prvm_prog_t *prog)
1921 VM_SAFEPARMCOUNT(1,VM_fclose);
1923 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1924 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1926 VM_Warning(prog, "VM_fclose: invalid file handle %i used in %s\n", filenum, prog->name);
1929 if (prog->openfiles[filenum] == NULL)
1931 VM_Warning(prog, "VM_fclose: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1934 FS_Close(prog->openfiles[filenum]);
1935 prog->openfiles[filenum] = NULL;
1936 if(prog->openfiles_origin[filenum])
1937 PRVM_Free((char *)prog->openfiles_origin[filenum]);
1938 if (developer_extra.integer)
1939 Con_DPrintf("VM_fclose: %s: #%i closed\n", prog->name, filenum);
1946 string fgets(float fhandle)
1949 //string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring
1950 void VM_fgets(prvm_prog_t *prog)
1953 char string[VM_STRINGTEMP_LENGTH];
1956 VM_SAFEPARMCOUNT(1,VM_fgets);
1958 // set the return value regardless of any possible errors
1959 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
1961 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1962 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1964 VM_Warning(prog, "VM_fgets: invalid file handle %i used in %s\n", filenum, prog->name);
1967 if (prog->openfiles[filenum] == NULL)
1969 VM_Warning(prog, "VM_fgets: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1975 c = FS_Getc(prog->openfiles[filenum]);
1976 if (c == '\r' || c == '\n' || c < 0)
1978 if (end < VM_STRINGTEMP_LENGTH - 1)
1982 // remove \n following \r
1985 c = FS_Getc(prog->openfiles[filenum]);
1987 FS_UnGetc(prog->openfiles[filenum], (unsigned char)c);
1989 if (developer_extra.integer)
1990 Con_DPrintf("fgets: %s: %s\n", prog->name, string);
1992 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
1999 fputs(float fhandle, string s)
2002 //void(float fhandle, string s) fputs = #113; // writes a line of text to the end of the file
2003 void VM_fputs(prvm_prog_t *prog)
2006 char string[VM_STRINGTEMP_LENGTH];
2009 VM_SAFEPARMCOUNT(2,VM_fputs);
2011 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
2012 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
2014 VM_Warning(prog, "VM_fputs: invalid file handle %i used in %s\n", filenum, prog->name);
2017 if (prog->openfiles[filenum] == NULL)
2019 VM_Warning(prog, "VM_fputs: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
2022 VM_VarString(prog, 1, string, sizeof(string));
2023 if ((stringlength = (int)strlen(string)))
2024 FS_Write(prog->openfiles[filenum], string, stringlength);
2025 if (developer_extra.integer)
2026 Con_DPrintf("fputs: %s: %s\n", prog->name, string);
2033 writetofile(float fhandle, entity ent)
2036 void VM_writetofile(prvm_prog_t *prog)
2041 VM_SAFEPARMCOUNT(2, VM_writetofile);
2043 file = VM_GetFileHandle(prog, (int)PRVM_G_FLOAT(OFS_PARM0));
2046 VM_Warning(prog, "VM_writetofile: invalid or closed file handle\n");
2050 ent = PRVM_G_EDICT(OFS_PARM1);
2053 VM_Warning(prog, "VM_writetofile: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2057 PRVM_ED_Write (prog, file, ent);
2060 // KrimZon - DP_QC_ENTITYDATA
2065 float() numentityfields
2066 Return the number of entity fields - NOT offsets
2069 void VM_numentityfields(prvm_prog_t *prog)
2071 PRVM_G_FLOAT(OFS_RETURN) = prog->numfielddefs;
2074 // KrimZon - DP_QC_ENTITYDATA
2079 string(float fieldnum) entityfieldname
2080 Return name of the specified field as a string, or empty if the field is invalid (warning)
2083 void VM_entityfieldname(prvm_prog_t *prog)
2086 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2088 if (i < 0 || i >= prog->numfielddefs)
2090 VM_Warning(prog, "VM_entityfieldname: %s: field index out of bounds\n", prog->name);
2091 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2095 d = &prog->fielddefs[i];
2096 PRVM_G_INT(OFS_RETURN) = d->s_name; // presuming that s_name points to a string already
2099 // KrimZon - DP_QC_ENTITYDATA
2104 float(float fieldnum) entityfieldtype
2107 void VM_entityfieldtype(prvm_prog_t *prog)
2110 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2112 if (i < 0 || i >= prog->numfielddefs)
2114 VM_Warning(prog, "VM_entityfieldtype: %s: field index out of bounds\n", prog->name);
2115 PRVM_G_FLOAT(OFS_RETURN) = -1.0;
2119 d = &prog->fielddefs[i];
2120 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t)d->type;
2123 // KrimZon - DP_QC_ENTITYDATA
2126 VM_getentityfieldstring
2128 string(float fieldnum, entity ent) getentityfieldstring
2131 void VM_getentityfieldstring(prvm_prog_t *prog)
2133 // put the data into a string
2138 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2139 char valuebuf[MAX_INPUTLINE];
2141 if (i < 0 || i >= prog->numfielddefs)
2143 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2144 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2148 d = &prog->fielddefs[i];
2151 ent = PRVM_G_EDICT(OFS_PARM1);
2154 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2155 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2158 val = (prvm_eval_t *)(ent->fields.fp + d->ofs);
2160 // if it's 0 or blank, return an empty string
2161 type = d->type & ~DEF_SAVEGLOBAL;
2162 for (j=0 ; j<prvm_type_size[type] ; j++)
2163 if (val->ivector[j])
2165 if (j == prvm_type_size[type])
2167 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2171 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_UglyValueString(prog, (etype_t)d->type, val, valuebuf, sizeof(valuebuf)));
2174 // KrimZon - DP_QC_ENTITYDATA
2177 VM_putentityfieldstring
2179 float(float fieldnum, entity ent, string s) putentityfieldstring
2182 void VM_putentityfieldstring(prvm_prog_t *prog)
2186 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2188 if (i < 0 || i >= prog->numfielddefs)
2190 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2191 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2195 d = &prog->fielddefs[i];
2198 ent = PRVM_G_EDICT(OFS_PARM1);
2201 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2202 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2206 // parse the string into the value
2207 PRVM_G_FLOAT(OFS_RETURN) = ( PRVM_ED_ParseEpair(prog, ent, d, PRVM_G_STRING(OFS_PARM2), false) ) ? 1.0f : 0.0f;
2214 float strlen(string s)
2217 //float(string s) strlen = #114; // returns how many characters are in a string
2218 void VM_strlen(prvm_prog_t *prog)
2220 VM_SAFEPARMCOUNT(1,VM_strlen);
2222 //PRVM_G_FLOAT(OFS_RETURN) = strlen(PRVM_G_STRING(OFS_PARM0));
2223 PRVM_G_FLOAT(OFS_RETURN) = u8_strlen(PRVM_G_STRING(OFS_PARM0));
2226 // DRESK - Decolorized String
2231 string strdecolorize(string s)
2234 // string (string s) strdecolorize = #472; // returns the passed in string with color codes stripped
2235 void VM_strdecolorize(prvm_prog_t *prog)
2237 char szNewString[VM_STRINGTEMP_LENGTH];
2238 const char *szString;
2241 VM_SAFEPARMCOUNT(1,VM_strdecolorize);
2242 szString = PRVM_G_STRING(OFS_PARM0);
2243 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), true);
2244 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2247 // DRESK - String Length (not counting color codes)
2252 float strlennocol(string s)
2255 // float(string s) strlennocol = #471; // returns how many characters are in a string not including color codes
2256 // For example, ^2Dresk returns a length of 5
2257 void VM_strlennocol(prvm_prog_t *prog)
2259 const char *szString;
2262 VM_SAFEPARMCOUNT(1,VM_strlennocol);
2264 szString = PRVM_G_STRING(OFS_PARM0);
2266 //nCnt = (int)COM_StringLengthNoColors(szString, 0, NULL);
2267 nCnt = (int)u8_COM_StringLengthNoColors(szString, 0, NULL);
2269 PRVM_G_FLOAT(OFS_RETURN) = nCnt;
2272 // DRESK - String to Uppercase and Lowercase
2277 string strtolower(string s)
2280 // string (string s) strtolower = #480; // returns passed in string in lowercase form
2281 void VM_strtolower(prvm_prog_t *prog)
2283 char szNewString[VM_STRINGTEMP_LENGTH];
2284 const char *szString;
2287 VM_SAFEPARMCOUNT(1,VM_strtolower);
2288 szString = PRVM_G_STRING(OFS_PARM0);
2290 COM_ToLowerString(szString, szNewString, sizeof(szNewString) );
2292 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2299 string strtoupper(string s)
2302 // string (string s) strtoupper = #481; // returns passed in string in uppercase form
2303 void VM_strtoupper(prvm_prog_t *prog)
2305 char szNewString[VM_STRINGTEMP_LENGTH];
2306 const char *szString;
2309 VM_SAFEPARMCOUNT(1,VM_strtoupper);
2310 szString = PRVM_G_STRING(OFS_PARM0);
2312 COM_ToUpperString(szString, szNewString, sizeof(szNewString) );
2314 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2321 string strcat(string,string,...[string])
2324 //string(string s1, string s2) strcat = #115;
2325 // concatenates two strings (for example "abc", "def" would return "abcdef")
2326 // and returns as a tempstring
2327 void VM_strcat(prvm_prog_t *prog)
2329 char s[VM_STRINGTEMP_LENGTH];
2330 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strcat);
2332 VM_VarString(prog, 0, s, sizeof(s));
2333 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
2340 string substring(string s, float start, float length)
2343 // string(string s, float start, float length) substring = #116;
2344 // returns a section of a string as a tempstring
2345 void VM_substring(prvm_prog_t *prog)
2348 int u_slength = 0, u_start;
2351 char string[VM_STRINGTEMP_LENGTH];
2353 VM_SAFEPARMCOUNT(3,VM_substring);
2356 s = PRVM_G_STRING(OFS_PARM0);
2357 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2358 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2359 slength = strlen(s);
2361 if (start < 0) // FTE_STRINGS feature
2363 start = bound(0, start, slength);
2365 if (length < 0) // FTE_STRINGS feature
2366 length += slength - start + 1;
2367 maxlen = min((int)sizeof(string) - 1, slength - start);
2368 length = bound(0, length, maxlen);
2370 memcpy(string, s + start, length);
2372 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2375 s = PRVM_G_STRING(OFS_PARM0);
2376 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2377 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2379 if (start < 0) // FTE_STRINGS feature
2381 u_slength = (int)u8_strlen(s);
2383 start = bound(0, start, u_slength);
2386 if (length < 0) // FTE_STRINGS feature
2388 if (!u_slength) // it's not calculated when it's not needed above
2389 u_slength = (int)u8_strlen(s);
2390 length += u_slength - start + 1;
2393 // positive start, positive length
2394 u_start = u8_byteofs(s, start, NULL);
2397 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2400 u_length = u8_bytelen(s + u_start, length);
2401 if (u_length >= sizeof(string)-1)
2402 u_length = sizeof(string)-1;
2404 memcpy(string, s + u_start, u_length);
2405 string[u_length] = 0;
2406 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2413 string(string search, string replace, string subject) strreplace = #484;
2416 // replaces all occurrences of search with replace in the string subject, and returns the result
2417 void VM_strreplace(prvm_prog_t *prog)
2420 const char *search, *replace, *subject;
2421 char string[VM_STRINGTEMP_LENGTH];
2422 int search_len, replace_len, subject_len;
2424 VM_SAFEPARMCOUNT(3,VM_strreplace);
2426 search = PRVM_G_STRING(OFS_PARM0);
2427 replace = PRVM_G_STRING(OFS_PARM1);
2428 subject = PRVM_G_STRING(OFS_PARM2);
2430 search_len = (int)strlen(search);
2431 replace_len = (int)strlen(replace);
2432 subject_len = (int)strlen(subject);
2435 for (i = 0; i <= subject_len - search_len; i++)
2437 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2438 if (subject[i+j] != search[j])
2440 if (j == search_len)
2442 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2443 // found it at offset 'i'
2444 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2445 string[si++] = replace[j];
2448 i += search_len - 1;
2452 // the above would subtract 1 from i... so we
2453 // don't do that, but instead output the next
2455 if (si < (int)sizeof(string) - 1)
2456 string[si++] = subject[i];
2461 // in THIS case, we know search_len > 0, thus i < subject_len
2463 if (si < (int)sizeof(string) - 1)
2464 string[si++] = subject[i];
2467 // remaining chars (these cannot match)
2468 for (; i < subject_len; i++)
2469 if (si < (int)sizeof(string) - 1)
2470 string[si++] = subject[i];
2473 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2480 string(string search, string replace, string subject) strireplace = #485;
2483 // case-insensitive version of strreplace
2484 void VM_strireplace(prvm_prog_t *prog)
2487 const char *search, *replace, *subject;
2488 char string[VM_STRINGTEMP_LENGTH];
2489 int search_len, replace_len, subject_len;
2491 VM_SAFEPARMCOUNT(3, VM_strireplace);
2493 search = PRVM_G_STRING(OFS_PARM0);
2494 replace = PRVM_G_STRING(OFS_PARM1);
2495 subject = PRVM_G_STRING(OFS_PARM2);
2497 search_len = (int)strlen(search);
2498 replace_len = (int)strlen(replace);
2499 subject_len = (int)strlen(subject);
2502 for (i = 0; i <= subject_len - search_len; i++)
2504 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2505 if (tolower(subject[i+j]) != tolower(search[j]))
2507 if (j == search_len)
2509 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2510 // found it at offset 'i'
2511 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2512 string[si++] = replace[j];
2515 i += search_len - 1;
2519 // the above would subtract 1 from i... so we
2520 // don't do that, but instead output the next
2522 if (si < (int)sizeof(string) - 1)
2523 string[si++] = subject[i];
2528 // in THIS case, we know search_len > 0, thus i < subject_len
2530 if (si < (int)sizeof(string) - 1)
2531 string[si++] = subject[i];
2534 // remaining chars (these cannot match)
2535 for (; i < subject_len; i++)
2536 if (si < (int)sizeof(string) - 1)
2537 string[si++] = subject[i];
2540 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2547 vector stov(string s)
2550 //vector(string s) stov = #117; // returns vector value from a string
2551 void VM_stov(prvm_prog_t *prog)
2553 char string[VM_STRINGTEMP_LENGTH];
2555 VM_SAFEPARMCOUNT(1,VM_stov);
2557 VM_VarString(prog, 0, string, sizeof(string));
2558 Math_atov(string, PRVM_G_VECTOR(OFS_RETURN));
2565 string strzone(string s)
2568 //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)
2569 void VM_strzone(prvm_prog_t *prog)
2572 char string[VM_STRINGTEMP_LENGTH];
2575 VM_SAFEPARMCOUNT(1,VM_strzone);
2577 VM_VarString(prog, 0, string, sizeof(string));
2578 alloclen = strlen(string) + 1;
2579 PRVM_G_INT(OFS_RETURN) = PRVM_AllocString(prog, alloclen, &out);
2580 memcpy(out, string, alloclen);
2590 //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!!!)
2591 void VM_strunzone(prvm_prog_t *prog)
2593 VM_SAFEPARMCOUNT(1,VM_strunzone);
2594 PRVM_FreeString(prog, PRVM_G_INT(OFS_PARM0));
2601 float tokenize(string s)
2604 //float(string s) tokenize = #441; // takes apart a string into individal words (access them with argv), returns how many
2605 //this function originally written by KrimZon, made shorter by LadyHavoc
2606 //20040203: rewritten by LadyHavoc (no longer uses allocations)
2607 static int num_tokens = 0;
2608 static int tokens[VM_STRINGTEMP_LENGTH / 2];
2609 static int tokens_startpos[VM_STRINGTEMP_LENGTH / 2];
2610 static int tokens_endpos[VM_STRINGTEMP_LENGTH / 2];
2611 static char tokenize_string[VM_STRINGTEMP_LENGTH];
2612 void VM_tokenize (prvm_prog_t *prog)
2616 VM_SAFEPARMCOUNT(1,VM_tokenize);
2618 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2619 p = tokenize_string;
2624 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2627 // skip whitespace here to find token start pos
2628 while(*p && ISWHITESPACE(*p))
2631 tokens_startpos[num_tokens] = p - tokenize_string;
2632 if(!COM_ParseToken_VM_Tokenize(&p, false))
2634 tokens_endpos[num_tokens] = p - tokenize_string;
2635 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2639 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2642 //float(string s) tokenize = #514; // takes apart a string into individal words (access them with argv), returns how many
2643 void VM_tokenize_console (prvm_prog_t *prog)
2647 VM_SAFEPARMCOUNT(1, VM_tokenize_console);
2649 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2650 p = tokenize_string;
2655 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2658 // skip whitespace here to find token start pos
2659 while(*p && ISWHITESPACE(*p))
2662 tokens_startpos[num_tokens] = p - tokenize_string;
2663 if(!COM_ParseToken_Console(&p))
2665 tokens_endpos[num_tokens] = p - tokenize_string;
2666 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2670 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2675 VM_tokenizebyseparator
2677 float tokenizebyseparator(string s, string separator1, ...)
2680 //float(string s, string separator1, ...) tokenizebyseparator = #479; // takes apart a string into individal words (access them with argv), returns how many
2681 //this function returns the token preceding each instance of a separator (of
2682 //which there can be multiple), and the text following the last separator
2683 //useful for parsing certain kinds of data like IP addresses
2685 //numnumbers = tokenizebyseparator("10.1.2.3", ".");
2686 //returns 4 and the tokens "10" "1" "2" "3".
2687 void VM_tokenizebyseparator (prvm_prog_t *prog)
2691 int separatorlen[7];
2692 const char *separators[7];
2695 char tokentext[MAX_INPUTLINE];
2697 VM_SAFEPARMCOUNTRANGE(2, 8,VM_tokenizebyseparator);
2699 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2700 p = tokenize_string;
2703 for (j = 1;j < prog->argc;j++)
2705 // skip any blank separator strings
2706 const char *s = PRVM_G_STRING(OFS_PARM0+j*3);
2709 separators[numseparators] = s;
2710 separatorlen[numseparators] = (int)strlen(s);
2717 while (num_tokens < (int)(sizeof(tokens)/sizeof(tokens[0])))
2719 token = tokentext + j;
2720 tokens_startpos[num_tokens] = p - tokenize_string;
2724 for (k = 0;k < numseparators;k++)
2726 if (!strncmp(p, separators[k], separatorlen[k]))
2728 p += separatorlen[k];
2732 if (k < numseparators)
2734 if (j < (int)sizeof(tokentext)-1)
2735 tokentext[j++] = *p;
2739 tokens_endpos[num_tokens] = p0 - tokenize_string;
2740 if (j >= (int)sizeof(tokentext))
2743 tokens[num_tokens++] = PRVM_SetTempString(prog, token);
2748 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2751 //string(float n) argv = #442; // returns a word from the tokenized string (returns nothing for an invalid index)
2752 //this function originally written by KrimZon, made shorter by LadyHavoc
2753 void VM_argv (prvm_prog_t *prog)
2757 VM_SAFEPARMCOUNT(1,VM_argv);
2759 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2762 token_num += num_tokens;
2764 if (token_num >= 0 && token_num < num_tokens)
2765 PRVM_G_INT(OFS_RETURN) = tokens[token_num];
2767 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2770 //float(float n) argv_start_index = #515; // returns the start index of a token
2771 void VM_argv_start_index (prvm_prog_t *prog)
2775 VM_SAFEPARMCOUNT(1,VM_argv);
2777 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2780 token_num += num_tokens;
2782 if (token_num >= 0 && token_num < num_tokens)
2783 PRVM_G_FLOAT(OFS_RETURN) = tokens_startpos[token_num];
2785 PRVM_G_FLOAT(OFS_RETURN) = -1;
2788 //float(float n) argv_end_index = #516; // returns the end index of a token
2789 void VM_argv_end_index (prvm_prog_t *prog)
2793 VM_SAFEPARMCOUNT(1,VM_argv);
2795 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2798 token_num += num_tokens;
2800 if (token_num >= 0 && token_num < num_tokens)
2801 PRVM_G_FLOAT(OFS_RETURN) = tokens_endpos[token_num];
2803 PRVM_G_FLOAT(OFS_RETURN) = -1;
2813 void VM_isserver(prvm_prog_t *prog)
2815 VM_SAFEPARMCOUNT(0, VM_isserver);
2817 PRVM_G_FLOAT(OFS_RETURN) = sv.active;
2827 void VM_clientcount(prvm_prog_t *prog)
2829 VM_SAFEPARMCOUNT(0,VM_clientcount);
2831 PRVM_G_FLOAT(OFS_RETURN) = svs.maxclients;
2841 void VM_clientstate(prvm_prog_t *prog)
2843 VM_SAFEPARMCOUNT(0,VM_clientstate);
2846 switch( cls.state ) {
2847 case ca_uninitialized:
2849 PRVM_G_FLOAT(OFS_RETURN) = 0;
2851 case ca_disconnected:
2852 PRVM_G_FLOAT(OFS_RETURN) = 1;
2855 PRVM_G_FLOAT(OFS_RETURN) = 2;
2858 // should never be reached!
2867 float getostype(prvm_prog_t *prog)
2869 */ // not used at the moment -> not included in the common list
2870 void VM_getostype(prvm_prog_t *prog)
2872 VM_SAFEPARMCOUNT(0,VM_getostype);
2877 OS_MAC - not supported
2881 PRVM_G_FLOAT(OFS_RETURN) = 0;
2882 #elif defined(MACOSX)
2883 PRVM_G_FLOAT(OFS_RETURN) = 2;
2885 PRVM_G_FLOAT(OFS_RETURN) = 1;
2893 float gettime(prvm_prog_t *prog)
2896 float CDAudio_GetPosition(void);
2897 void VM_gettime(prvm_prog_t *prog)
2901 VM_SAFEPARMCOUNTRANGE(0,1,VM_gettime);
2905 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t) host.realtime;
2909 timer_index = (int) PRVM_G_FLOAT(OFS_PARM0);
2912 case 0: // GETTIME_FRAMESTART
2913 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2915 case 1: // GETTIME_REALTIME
2916 PRVM_G_FLOAT(OFS_RETURN) = Sys_DirtyTime();
2918 case 2: // GETTIME_HIRES
2919 PRVM_G_FLOAT(OFS_RETURN) = (Sys_DirtyTime() - host.dirtytime);
2921 case 3: // GETTIME_UPTIME
2922 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2924 case 4: // GETTIME_CDTRACK
2925 PRVM_G_FLOAT(OFS_RETURN) = CDAudio_GetPosition();
2928 VM_Warning(prog, "VM_gettime: %s: unsupported timer specified, returning realtime\n", prog->name);
2929 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2939 float getsoundtime(prvm_prog_t *prog)
2943 void VM_getsoundtime (prvm_prog_t *prog)
2945 int entnum, entchannel;
2946 VM_SAFEPARMCOUNT(2,VM_getsoundtime);
2948 if (prog == SVVM_prog)
2949 entnum = PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2950 else if (prog == CLVM_prog)
2951 entnum = MAX_EDICTS + PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2954 VM_Warning(prog, "VM_getsoundtime: %s: not supported on this progs\n", prog->name);
2955 PRVM_G_FLOAT(OFS_RETURN) = -1;
2958 entchannel = (int)PRVM_G_FLOAT(OFS_PARM1);
2959 entchannel = CHAN_USER2ENGINE(entchannel);
2960 if (!IS_CHAN(entchannel))
2961 VM_Warning(prog, "VM_getsoundtime: %s: bad channel %i\n", prog->name, entchannel);
2962 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t)S_GetEntChannelPosition(entnum, entchannel);
2969 string soundlength (string sample)
2972 void VM_soundlength (prvm_prog_t *prog)
2976 VM_SAFEPARMCOUNT(1, VM_soundlength);
2978 s = PRVM_G_STRING(OFS_PARM0);
2979 PRVM_G_FLOAT(OFS_RETURN) = S_SoundLength(s);
2986 loadfromdata(string data)
2989 void VM_loadfromdata(prvm_prog_t *prog)
2991 VM_SAFEPARMCOUNT(1, VM_loadfromdata);
2993 PRVM_ED_LoadFromFile(prog, PRVM_G_STRING(OFS_PARM0));
2997 ========================
3000 parseentitydata(entity ent, string data)
3001 ========================
3003 void VM_parseentitydata(prvm_prog_t *prog)
3008 VM_SAFEPARMCOUNT(2, VM_parseentitydata);
3010 // get edict and test it
3011 ent = PRVM_G_EDICT(OFS_PARM0);
3013 prog->error_cmd("VM_parseentitydata: %s: Can only set already spawned entities (entity %i is free)!", prog->name, PRVM_NUM_FOR_EDICT(ent));
3015 data = PRVM_G_STRING(OFS_PARM1);
3017 // parse the opening brace
3018 if (!COM_ParseToken_Simple(&data, false, false, true) || com_token[0] != '{' )
3019 prog->error_cmd("VM_parseentitydata: %s: Couldn't parse entity data:\n%s", prog->name, data );
3021 PRVM_ED_ParseEdict (prog, data, ent);
3028 loadfromfile(string file)
3031 void VM_loadfromfile(prvm_prog_t *prog)
3033 const char *filename;
3036 VM_SAFEPARMCOUNT(1,VM_loadfromfile);
3038 filename = PRVM_G_STRING(OFS_PARM0);
3039 if (FS_CheckNastyPath(filename, false))
3041 PRVM_G_FLOAT(OFS_RETURN) = -4;
3042 VM_Warning(prog, "VM_loadfromfile: %s dangerous or non-portable filename \"%s\" not allowed. (contains : or \\ or begins with .. or /)\n", prog->name, filename);
3046 // not conform with VM_fopen
3047 data = (char *)FS_LoadFile(filename, tempmempool, false, NULL);
3049 PRVM_G_FLOAT(OFS_RETURN) = -1;
3051 PRVM_ED_LoadFromFile(prog, data);
3062 float mod(float val, float m)
3065 void VM_modulo(prvm_prog_t *prog)
3069 VM_SAFEPARMCOUNT(2, VM_modulo);
3071 val = PRVM_G_FLOAT(OFS_PARM0);
3072 m = PRVM_G_FLOAT(OFS_PARM1);
3074 // matches how gmqcc implements % when mod() builtin isn't defined, and FTEQW mod()
3076 PRVM_G_FLOAT(OFS_RETURN) = val - m * (prvm_int_t)(val / m);
3079 VM_Warning(prog, "Attempted modulo of %f by zero\n", val);
3080 PRVM_G_FLOAT(OFS_RETURN) = 0;
3084 static void VM_Search_Init(prvm_prog_t *prog)
3087 for (i = 0;i < PRVM_MAX_OPENSEARCHES;i++)
3088 prog->opensearches[i] = NULL;
3091 static void VM_Search_Reset(prvm_prog_t *prog)
3094 // reset the fssearch list
3095 for(i = 0; i < PRVM_MAX_OPENSEARCHES; i++)
3097 if(prog->opensearches[i])
3098 FS_FreeSearch(prog->opensearches[i]);
3099 prog->opensearches[i] = NULL;
3107 float search_begin(string pattern, float caseinsensitive, float quiet[, string packfile])
3110 void VM_search_begin(prvm_prog_t *prog)
3113 const char *packfile = NULL, *pattern;
3114 int caseinsens, quiet;
3116 VM_SAFEPARMCOUNTRANGE(3, 4, VM_search_begin);
3118 pattern = PRVM_G_STRING(OFS_PARM0);
3120 VM_CheckEmptyString(prog, pattern);
3122 caseinsens = (int)PRVM_G_FLOAT(OFS_PARM1);
3123 quiet = (int)PRVM_G_FLOAT(OFS_PARM2);
3125 // optional packfile parameter (DP_QC_FS_SEARCH_PACKFILE)
3127 packfile = PRVM_G_STRING(OFS_PARM3);
3129 for(handle = 0; handle < PRVM_MAX_OPENSEARCHES; handle++)
3130 if(!prog->opensearches[handle])
3133 if(handle >= PRVM_MAX_OPENSEARCHES)
3135 PRVM_G_FLOAT(OFS_RETURN) = -2;
3136 VM_Warning(prog, "VM_search_begin: %s ran out of search handles (%i)\n", prog->name, PRVM_MAX_OPENSEARCHES);
3140 if(!(prog->opensearches[handle] = FS_Search(pattern,caseinsens, quiet, packfile)))
3141 PRVM_G_FLOAT(OFS_RETURN) = -1;
3144 prog->opensearches_origin[handle] = PRVM_AllocationOrigin(prog);
3145 PRVM_G_FLOAT(OFS_RETURN) = handle;
3153 void search_end(float handle)
3156 void VM_search_end(prvm_prog_t *prog)
3159 VM_SAFEPARMCOUNT(1, VM_search_end);
3161 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3163 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3165 VM_Warning(prog, "VM_search_end: invalid handle %i used in %s\n", handle, prog->name);
3168 if(prog->opensearches[handle] == NULL)
3170 VM_Warning(prog, "VM_search_end: no such handle %i in %s\n", handle, prog->name);
3174 FS_FreeSearch(prog->opensearches[handle]);
3175 prog->opensearches[handle] = NULL;
3176 if(prog->opensearches_origin[handle])
3177 PRVM_Free((char *)prog->opensearches_origin[handle]);
3184 float search_getsize(float handle)
3187 void VM_search_getsize(prvm_prog_t *prog)
3190 VM_SAFEPARMCOUNT(1, VM_search_getsize);
3192 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3194 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3196 VM_Warning(prog, "VM_search_getsize: invalid handle %i used in %s\n", handle, prog->name);
3199 if(prog->opensearches[handle] == NULL)
3201 VM_Warning(prog, "VM_search_getsize: no such handle %i in %s\n", handle, prog->name);
3205 PRVM_G_FLOAT(OFS_RETURN) = prog->opensearches[handle]->numfilenames;
3210 VM_search_getfilename
3212 string search_getfilename(float handle, float num)
3215 void VM_search_getfilename(prvm_prog_t *prog)
3217 int handle, filenum;
3218 VM_SAFEPARMCOUNT(2, VM_search_getfilename);
3220 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3221 filenum = (int)PRVM_G_FLOAT(OFS_PARM1);
3223 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3225 VM_Warning(prog, "VM_search_getfilename: invalid handle %i used in %s\n", handle, prog->name);
3228 if(prog->opensearches[handle] == NULL)
3230 VM_Warning(prog, "VM_search_getfilename: no such handle %i in %s\n", handle, prog->name);
3233 if(filenum < 0 || filenum >= prog->opensearches[handle]->numfilenames)
3235 VM_Warning(prog, "VM_search_getfilename: invalid filenum %i in %s\n", filenum, prog->name);
3239 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, prog->opensearches[handle]->filenames[filenum]);
3246 string chr(float ascii)
3249 void VM_chr(prvm_prog_t *prog)
3253 VM_SAFEPARMCOUNT(1, VM_chr);
3255 tmp[0] = (unsigned char) PRVM_G_FLOAT(OFS_PARM0);
3258 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3263 VM_SAFEPARMCOUNT(1, VM_chr);
3265 len = u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0), tmp, sizeof(tmp));
3267 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3274 string keynumtostring(float keynum)
3277 void VM_keynumtostring (prvm_prog_t *prog)
3279 char tinystr[TINYSTR_LEN];
3280 VM_SAFEPARMCOUNT(1, VM_keynumtostring);
3282 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_KeynumToString((int)PRVM_G_FLOAT(OFS_PARM0), tinystr, TINYSTR_LEN));
3287 VM_findkeysforcommand
3289 string findkeysforcommand(string command, float bindmap)
3291 the returned string is an altstring
3294 #define FKFC_NUMKEYS 5
3295 void M_FindKeysForCommand(const char *command, int *keys);
3296 void VM_findkeysforcommand(prvm_prog_t *prog)
3299 char ret[VM_STRINGTEMP_LENGTH];
3300 int keys[FKFC_NUMKEYS];
3305 VM_SAFEPARMCOUNTRANGE(1, 2, VM_findkeysforcommand);
3307 cmd = PRVM_G_STRING(OFS_PARM0);
3309 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
3311 bindmap = 0; // consistent to "bind"
3313 VM_CheckEmptyString(prog, cmd);
3315 Key_FindKeysForCommand(cmd, keys, FKFC_NUMKEYS, bindmap);
3318 for(i = 0; i < FKFC_NUMKEYS; i++)
3319 strlcat(ret, va(vabuf, sizeof(vabuf), " \'%i\'", keys[i]), sizeof(ret));
3321 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, ret);
3328 float stringtokeynum(string key)
3331 void VM_stringtokeynum (prvm_prog_t *prog)
3333 VM_SAFEPARMCOUNT( 1, VM_stringtokeynum );
3335 PRVM_G_FLOAT(OFS_RETURN) = Key_StringToKeynum(PRVM_G_STRING(OFS_PARM0));
3342 string getkeybind(float key, float bindmap)
3345 void VM_getkeybind (prvm_prog_t *prog)
3348 VM_SAFEPARMCOUNTRANGE(1, 2, VM_getkeybind);
3350 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
3352 bindmap = 0; // consistent to "bind"
3354 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_GetBind((int)PRVM_G_FLOAT(OFS_PARM0), bindmap));
3361 float setkeybind(float key, string cmd, float bindmap)
3364 void VM_setkeybind (prvm_prog_t *prog)
3367 VM_SAFEPARMCOUNTRANGE(2, 3, VM_setkeybind);
3369 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM2), MAX_BINDMAPS-1);
3371 bindmap = 0; // consistent to "bind"
3373 PRVM_G_FLOAT(OFS_RETURN) = 0;
3374 if(Key_SetBinding((int)PRVM_G_FLOAT(OFS_PARM0), bindmap, PRVM_G_STRING(OFS_PARM1)))
3375 PRVM_G_FLOAT(OFS_RETURN) = 1;
3382 vector getbindmaps()
3385 void VM_getbindmaps (prvm_prog_t *prog)
3388 VM_SAFEPARMCOUNT(0, VM_getbindmaps);
3389 Key_GetBindMap(&fg, &bg);
3390 PRVM_G_VECTOR(OFS_RETURN)[0] = fg;
3391 PRVM_G_VECTOR(OFS_RETURN)[1] = bg;
3392 PRVM_G_VECTOR(OFS_RETURN)[2] = 0;
3399 float setbindmaps(vector bindmap)
3402 void VM_setbindmaps (prvm_prog_t *prog)
3404 VM_SAFEPARMCOUNT(1, VM_setbindmaps);
3405 PRVM_G_FLOAT(OFS_RETURN) = 0;
3406 if(PRVM_G_VECTOR(OFS_PARM0)[2] == 0)
3407 if(Key_SetBindMap((int)PRVM_G_VECTOR(OFS_PARM0)[0], (int)PRVM_G_VECTOR(OFS_PARM0)[1]))
3408 PRVM_G_FLOAT(OFS_RETURN) = 1;
3412 ========================
3415 float[bool] gecko_create( string name )
3416 ========================
3418 void VM_gecko_create(prvm_prog_t *prog) {
3420 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3424 ========================
3427 void gecko_destroy( string name )
3428 ========================
3430 void VM_gecko_destroy(prvm_prog_t *prog) {
3435 ========================
3438 void gecko_navigate( string name, string URI )
3439 ========================
3441 void VM_gecko_navigate(prvm_prog_t *prog) {
3446 ========================
3449 float[bool] gecko_keyevent( string name, float key, float eventtype )
3450 ========================
3452 void VM_gecko_keyevent(prvm_prog_t *prog) {
3454 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3458 ========================
3461 void gecko_mousemove( string name, float x, float y )
3462 ========================
3464 void VM_gecko_movemouse(prvm_prog_t *prog) {
3470 ========================
3473 void gecko_resize( string name, float w, float h )
3474 ========================
3476 void VM_gecko_resize(prvm_prog_t *prog) {
3482 ========================
3483 VM_gecko_get_texture_extent
3485 vector gecko_get_texture_extent( string name )
3486 ========================
3488 void VM_gecko_get_texture_extent(prvm_prog_t *prog) {
3490 PRVM_G_VECTOR(OFS_RETURN)[0] = 0;
3491 PRVM_G_VECTOR(OFS_RETURN)[1] = 0;
3500 Writes new values for v_forward, v_up, and v_right based on angles
3501 void makevectors(vector angle)
3504 void VM_makevectors (prvm_prog_t *prog)
3506 vec3_t angles, forward, right, up;
3507 VM_SAFEPARMCOUNT(1, VM_makevectors);
3508 VectorCopy(PRVM_G_VECTOR(OFS_PARM0), angles);
3509 AngleVectors(angles, forward, right, up);
3510 VectorCopy(forward, PRVM_gameglobalvector(v_forward));
3511 VectorCopy(right, PRVM_gameglobalvector(v_right));
3512 VectorCopy(up, PRVM_gameglobalvector(v_up));
3519 Writes new values for v_forward, v_up, and v_right based on the given forward vector
3520 vectorvectors(vector)
3523 void VM_vectorvectors (prvm_prog_t *prog)
3525 vec3_t forward, right, up;
3526 VM_SAFEPARMCOUNT(1, VM_vectorvectors);
3527 VectorNormalize2(PRVM_G_VECTOR(OFS_PARM0), forward);
3528 VectorVectors(forward, right, up);
3529 VectorCopy(forward, PRVM_gameglobalvector(v_forward));
3530 VectorCopy(right, PRVM_gameglobalvector(v_right));
3531 VectorCopy(up, PRVM_gameglobalvector(v_up));
3534 // float(float number, float quantity) bitshift (EXT_BITSHIFT)
3535 void VM_bitshift (prvm_prog_t *prog)
3538 VM_SAFEPARMCOUNT(2, VM_bitshift);
3540 n1 = (prvm_int_t)fabs((prvm_vec_t)((prvm_int_t)PRVM_G_FLOAT(OFS_PARM0)));
3541 n2 = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM1);
3543 PRVM_G_FLOAT(OFS_RETURN) = n1;
3546 PRVM_G_FLOAT(OFS_RETURN) = (n1 >> -n2);
3548 PRVM_G_FLOAT(OFS_RETURN) = (n1 << n2);
3551 ////////////////////////////////////////
3552 // AltString functions
3553 ////////////////////////////////////////
3556 ========================
3559 float altstr_count(string)
3560 ========================
3562 void VM_altstr_count(prvm_prog_t *prog)
3564 const char *altstr, *pos;
3567 VM_SAFEPARMCOUNT( 1, VM_altstr_count );
3569 altstr = PRVM_G_STRING( OFS_PARM0 );
3570 //VM_CheckEmptyString(prog, altstr );
3572 for( count = 0, pos = altstr ; *pos ; pos++ ) {
3573 if( *pos == '\\' ) {
3577 } else if( *pos == '\'' ) {
3582 PRVM_G_FLOAT( OFS_RETURN ) = (prvm_vec_t) (count / 2);
3586 ========================
3589 string altstr_prepare(string)
3590 ========================
3592 void VM_altstr_prepare(prvm_prog_t *prog)
3594 const char *instr, *in;
3595 char outstr[VM_STRINGTEMP_LENGTH];
3598 VM_SAFEPARMCOUNT( 1, VM_altstr_prepare );
3600 instr = PRVM_G_STRING( OFS_PARM0 );
3602 for (in = instr, outpos = 0; *in && outpos < sizeof(outstr) - 1; ++in)
3604 if (*in == '\'' && outpos < sizeof(outstr) - 2)
3606 outstr[outpos++] = '\\';
3607 outstr[outpos++] = '\'';
3610 outstr[outpos++] = *in;
3614 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3618 ========================
3621 string altstr_get(string, float)
3622 ========================
3624 void VM_altstr_get(prvm_prog_t *prog)
3626 const char *altstr, *pos;
3629 char outstr[VM_STRINGTEMP_LENGTH];
3631 VM_SAFEPARMCOUNT( 2, VM_altstr_get );
3633 altstr = PRVM_G_STRING( OFS_PARM0 );
3635 count = (int)PRVM_G_FLOAT( OFS_PARM1 );
3636 count = count * 2 + 1;
3638 for( pos = altstr ; *pos && count ; pos++ )
3639 if( *pos == '\\' ) {
3642 } else if( *pos == '\'' )
3646 PRVM_G_INT( OFS_RETURN ) = 0;
3650 for( out = outstr, size = sizeof(outstr) - 1 ; size && *pos ; size--, pos++, out++ )
3651 if( *pos == '\\' ) {
3656 } else if( *pos == '\'' )
3662 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3666 ========================
3669 string altstr_set(string altstr, float num, string set)
3670 ========================
3672 void VM_altstr_set(prvm_prog_t *prog)
3675 const char *altstr, *str;
3678 char outstr[VM_STRINGTEMP_LENGTH];
3680 VM_SAFEPARMCOUNT( 3, VM_altstr_set );
3682 altstr = PRVM_G_STRING( OFS_PARM0 );
3684 num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3686 str = PRVM_G_STRING( OFS_PARM2 );
3689 for( num = num * 2 + 1, in = altstr; *in && num; *out++ = *in++ )
3694 } else if( *in == '\'' ) {
3699 for( ; *str; *out++ = *str++ );
3700 // now jump over the old content
3702 if( *in == '\'' || (*in == '\\' && !*++in) )
3705 strlcpy(out, in, outstr + sizeof(outstr) - out);
3706 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3710 ========================
3713 string altstr_ins(string altstr, float num, string set)
3714 ========================
3716 void VM_altstr_ins(prvm_prog_t *prog)
3722 char outstr[VM_STRINGTEMP_LENGTH];
3724 VM_SAFEPARMCOUNT(3, VM_altstr_ins);
3726 in = PRVM_G_STRING( OFS_PARM0 );
3727 num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3728 set = PRVM_G_STRING( OFS_PARM2 );
3731 for( num = num * 2 + 2 ; *in && num > 0 ; *out++ = *in++ )
3736 } else if( *in == '\'' ) {
3741 for( ; *set ; *out++ = *set++ );
3744 strlcpy(out, in, outstr + sizeof(outstr) - out);
3745 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3749 ////////////////////////////////////////
3750 // BufString functions
3751 ////////////////////////////////////////
3752 //[515]: string buffers support
3754 static size_t stringbuffers_sortlength;
3756 static void BufStr_Expand(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer, int strindex)
3758 if (stringbuffer->max_strings <= strindex)
3760 char **oldstrings = stringbuffer->strings;
3761 stringbuffer->max_strings = max(stringbuffer->max_strings * 2, 128);
3762 while (stringbuffer->max_strings <= strindex)
3763 stringbuffer->max_strings *= 2;
3764 stringbuffer->strings = (char **) Mem_Alloc(prog->progs_mempool, stringbuffer->max_strings * sizeof(stringbuffer->strings[0]));
3765 if (stringbuffer->num_strings > 0)
3766 memcpy(stringbuffer->strings, oldstrings, stringbuffer->num_strings * sizeof(stringbuffer->strings[0]));
3768 Mem_Free(oldstrings);
3772 static void BufStr_Shrink(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer)
3774 // reduce num_strings if there are empty string slots at the end
3775 while (stringbuffer->num_strings > 0 && stringbuffer->strings[stringbuffer->num_strings - 1] == NULL)
3776 stringbuffer->num_strings--;
3778 // if empty, free the string pointer array
3779 if (stringbuffer->num_strings == 0)
3781 stringbuffer->max_strings = 0;
3782 if (stringbuffer->strings)
3783 Mem_Free(stringbuffer->strings);
3784 stringbuffer->strings = NULL;
3788 static int BufStr_SortStringsUP (const void *in1, const void *in2)
3791 a = *((const char **) in1);
3792 b = *((const char **) in2);
3793 if(!a || !a[0]) return 1;
3794 if(!b || !b[0]) return -1;
3795 return strncmp(a, b, stringbuffers_sortlength);
3798 static int BufStr_SortStringsDOWN (const void *in1, const void *in2)
3801 a = *((const char **) in1);
3802 b = *((const char **) in2);
3803 if(!a || !a[0]) return 1;
3804 if(!b || !b[0]) return -1;
3805 return strncmp(b, a, stringbuffers_sortlength);
3808 prvm_stringbuffer_t *BufStr_FindCreateReplace (prvm_prog_t *prog, int bufindex, int flags, const char *format)
3810 prvm_stringbuffer_t *stringbuffer;
3816 // find buffer with wanted index
3817 if (bufindex < (int)Mem_ExpandableArray_IndexRange(&prog->stringbuffersarray))
3819 if ( (stringbuffer = (prvm_stringbuffer_t*) Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, bufindex)) )
3821 if (stringbuffer->flags & STRINGBUFFER_TEMP)
3822 stringbuffer->flags = flags; // created but has not been used yet
3823 return stringbuffer;
3828 // allocate new buffer with wanted index
3831 stringbuffer = (prvm_stringbuffer_t *) Mem_ExpandableArray_AllocRecord(&prog->stringbuffersarray);
3832 stringbuffer->flags = STRINGBUFFER_TEMP;
3833 for (i = 0;stringbuffer != Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i);i++);
3836 stringbuffer->flags = flags; // mark as used
3840 return stringbuffer;
3843 void BufStr_Set(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer, int strindex, const char *str)
3847 if (!stringbuffer || strindex < 0)
3850 BufStr_Expand(prog, stringbuffer, strindex);
3851 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
3852 if (stringbuffer->strings[strindex])
3853 Mem_Free(stringbuffer->strings[strindex]);
3854 stringbuffer->strings[strindex] = NULL;
3858 // not the NULL string!
3859 alloclen = strlen(str) + 1;
3860 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
3861 memcpy(stringbuffer->strings[strindex], str, alloclen);
3864 BufStr_Shrink(prog, stringbuffer);
3867 void BufStr_Del(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer)
3874 for (i = 0;i < stringbuffer->num_strings;i++)
3875 if (stringbuffer->strings[i])
3876 Mem_Free(stringbuffer->strings[i]);
3877 if (stringbuffer->strings)
3878 Mem_Free(stringbuffer->strings);
3879 if(stringbuffer->origin)
3880 PRVM_Free((char *)stringbuffer->origin);
3881 Mem_ExpandableArray_FreeRecord(&prog->stringbuffersarray, stringbuffer);
3884 void BufStr_Flush(prvm_prog_t *prog)
3886 prvm_stringbuffer_t *stringbuffer;
3889 numbuffers = (int)Mem_ExpandableArray_IndexRange(&prog->stringbuffersarray);
3890 for (i = 0; i < numbuffers; i++)
3891 if ( (stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i)) )
3892 BufStr_Del(prog, stringbuffer);
3893 Mem_ExpandableArray_NewArray(&prog->stringbuffersarray, prog->progs_mempool, sizeof(prvm_stringbuffer_t), 64);
3897 ========================
3899 creates new buffer, and returns it's index, returns -1 if failed
3900 float buf_create(prvm_prog_t *prog) = #460;
3901 float newbuf(string format, float flags) = #460;
3902 ========================
3905 void VM_buf_create (prvm_prog_t *prog)
3907 prvm_stringbuffer_t *stringbuffer;
3910 VM_SAFEPARMCOUNTRANGE(0, 2, VM_buf_create);
3912 // VorteX: optional parm1 (buffer format) is unfinished, to keep intact with future databuffers extension must be set to "string"
3913 if(prog->argc >= 1 && strcmp(PRVM_G_STRING(OFS_PARM0), "string"))
3915 PRVM_G_FLOAT(OFS_RETURN) = -1;
3918 stringbuffer = (prvm_stringbuffer_t *) Mem_ExpandableArray_AllocRecord(&prog->stringbuffersarray);
3919 for (i = 0;stringbuffer != Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i);i++);
3920 stringbuffer->origin = PRVM_AllocationOrigin(prog);
3921 // optional flags parm
3922 if (prog->argc >= 2)
3923 stringbuffer->flags = (int)PRVM_G_FLOAT(OFS_PARM1) & STRINGBUFFER_QCFLAGS;
3924 PRVM_G_FLOAT(OFS_RETURN) = i;
3930 ========================
3932 deletes buffer and all strings in it
3933 void buf_del(float bufhandle) = #461;
3934 ========================
3936 void VM_buf_del (prvm_prog_t *prog)
3938 prvm_stringbuffer_t *stringbuffer;
3939 VM_SAFEPARMCOUNT(1, VM_buf_del);
3940 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3942 BufStr_Del(prog, stringbuffer);
3945 VM_Warning(prog, "VM_buf_del: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3951 ========================
3953 how many strings are stored in buffer
3954 float buf_getsize(float bufhandle) = #462;
3955 ========================
3957 void VM_buf_getsize (prvm_prog_t *prog)
3959 prvm_stringbuffer_t *stringbuffer;
3960 VM_SAFEPARMCOUNT(1, VM_buf_getsize);
3962 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3965 PRVM_G_FLOAT(OFS_RETURN) = -1;
3966 VM_Warning(prog, "VM_buf_getsize: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3970 PRVM_G_FLOAT(OFS_RETURN) = stringbuffer->num_strings;
3974 ========================
3976 copy all content from one buffer to another, make sure it exists
3977 void buf_copy(float bufhandle_from, float bufhandle_to) = #463;
3978 ========================
3980 void VM_buf_copy (prvm_prog_t *prog)
3982 prvm_stringbuffer_t *srcstringbuffer, *dststringbuffer;
3984 VM_SAFEPARMCOUNT(2, VM_buf_copy);
3986 srcstringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3987 if(!srcstringbuffer)
3989 VM_Warning(prog, "VM_buf_copy: invalid source buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3992 i = (int)PRVM_G_FLOAT(OFS_PARM1);
3993 if(i == (int)PRVM_G_FLOAT(OFS_PARM0))
3995 VM_Warning(prog, "VM_buf_copy: source == destination (%i) in %s\n", i, prog->name);
3998 dststringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3999 if(!dststringbuffer)
4001 VM_Warning(prog, "VM_buf_copy: invalid destination buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4005 for (i = 0;i < dststringbuffer->num_strings;i++)
4006 if (dststringbuffer->strings[i])
4007 Mem_Free(dststringbuffer->strings[i]);
4008 if (dststringbuffer->strings)
4009 Mem_Free(dststringbuffer->strings);
4010 *dststringbuffer = *srcstringbuffer;
4011 if (dststringbuffer->max_strings)
4012 dststringbuffer->strings = (char **)Mem_Alloc(prog->progs_mempool, sizeof(dststringbuffer->strings[0]) * dststringbuffer->max_strings);
4014 for (i = 0;i < dststringbuffer->num_strings;i++)
4016 if (srcstringbuffer->strings[i])
4019 stringlen = strlen(srcstringbuffer->strings[i]) + 1;
4020 dststringbuffer->strings[i] = (char *)Mem_Alloc(prog->progs_mempool, stringlen);
4021 memcpy(dststringbuffer->strings[i], srcstringbuffer->strings[i], stringlen);
4027 ========================
4029 sort buffer by beginnings of strings (cmplength defaults it's length)
4030 "backward == true" means that sorting goes upside-down
4031 void buf_sort(float bufhandle, float cmplength, float backward) = #464;
4032 ========================
4034 void VM_buf_sort (prvm_prog_t *prog)
4036 prvm_stringbuffer_t *stringbuffer;
4037 VM_SAFEPARMCOUNT(3, VM_buf_sort);
4039 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4042 VM_Warning(prog, "VM_buf_sort: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4045 if(stringbuffer->num_strings <= 0)
4047 VM_Warning(prog, "VM_buf_sort: tried to sort empty buffer %i in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4050 stringbuffers_sortlength = (int)PRVM_G_FLOAT(OFS_PARM1);
4051 if(stringbuffers_sortlength <= 0)
4052 stringbuffers_sortlength = 0x7FFFFFFF;
4054 if(!PRVM_G_FLOAT(OFS_PARM2))
4055 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsUP);
4057 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsDOWN);
4059 BufStr_Shrink(prog, stringbuffer);
4063 ========================
4065 concantenates all buffer string into one with "glue" separator and returns it as tempstring
4066 string buf_implode(float bufhandle, string glue) = #465;
4067 ========================
4069 void VM_buf_implode (prvm_prog_t *prog)
4071 prvm_stringbuffer_t *stringbuffer;
4072 char k[VM_STRINGTEMP_LENGTH];
4076 VM_SAFEPARMCOUNT(2, VM_buf_implode);
4078 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4079 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4082 VM_Warning(prog, "VM_buf_implode: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4085 if(!stringbuffer->num_strings)
4087 sep = PRVM_G_STRING(OFS_PARM1);
4089 for(l = i = 0;i < stringbuffer->num_strings;i++)
4091 if(stringbuffer->strings[i])
4093 l += (i > 0 ? strlen(sep) : 0) + strlen(stringbuffer->strings[i]);
4094 if (l >= sizeof(k) - 1)
4096 strlcat(k, sep, sizeof(k));
4097 strlcat(k, stringbuffer->strings[i], sizeof(k));
4100 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, k);
4104 ========================
4106 get a string from buffer, returns tempstring, dont str_unzone it!
4107 string bufstr_get(float bufhandle, float string_index) = #465;
4108 ========================
4110 void VM_bufstr_get (prvm_prog_t *prog)
4112 prvm_stringbuffer_t *stringbuffer;
4114 VM_SAFEPARMCOUNT(2, VM_bufstr_get);
4116 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4117 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4120 VM_Warning(prog, "VM_bufstr_get: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4123 strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4126 // VM_Warning(prog, "VM_bufstr_get: invalid string index %i used in %s\n", strindex, prog->name);
4129 if (strindex < stringbuffer->num_strings && stringbuffer->strings[strindex])
4130 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, stringbuffer->strings[strindex]);
4134 ========================
4136 copies a string into selected slot of buffer
4137 void bufstr_set(float bufhandle, float string_index, string str) = #466;
4138 ========================
4140 void VM_bufstr_set (prvm_prog_t *prog)
4143 prvm_stringbuffer_t *stringbuffer;
4146 VM_SAFEPARMCOUNT(3, VM_bufstr_set);
4148 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4151 VM_Warning(prog, "VM_bufstr_set: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4154 strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4155 if(strindex < 0 || strindex >= 1000000) // huge number of strings
4157 VM_Warning(prog, "VM_bufstr_set: invalid string index %i used in %s\n", strindex, prog->name);
4161 news = PRVM_G_STRING(OFS_PARM2);
4162 BufStr_Set(prog, stringbuffer, strindex, news);
4166 ========================
4168 adds string to buffer in first free slot and returns its index
4169 "order == true" means that string will be added after last "full" slot
4170 float bufstr_add(float bufhandle, string str, float order) = #467;
4171 ========================
4173 void VM_bufstr_add (prvm_prog_t *prog)
4175 int order, strindex;
4176 prvm_stringbuffer_t *stringbuffer;
4180 VM_SAFEPARMCOUNT(3, VM_bufstr_add);
4182 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4183 PRVM_G_FLOAT(OFS_RETURN) = -1;
4186 VM_Warning(prog, "VM_bufstr_add: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4189 if(!PRVM_G_INT(OFS_PARM1)) // NULL string
4191 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);
4194 string = PRVM_G_STRING(OFS_PARM1);
4195 order = (int)PRVM_G_FLOAT(OFS_PARM2);
4197 strindex = stringbuffer->num_strings;
4199 for (strindex = 0;strindex < stringbuffer->num_strings;strindex++)
4200 if (stringbuffer->strings[strindex] == NULL)
4203 BufStr_Expand(prog, stringbuffer, strindex);
4205 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4206 alloclen = strlen(string) + 1;
4207 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4208 memcpy(stringbuffer->strings[strindex], string, alloclen);
4210 PRVM_G_FLOAT(OFS_RETURN) = strindex;
4214 ========================
4216 delete string from buffer
4217 void bufstr_free(float bufhandle, float string_index) = #468;
4218 ========================
4220 void VM_bufstr_free (prvm_prog_t *prog)
4223 prvm_stringbuffer_t *stringbuffer;
4224 VM_SAFEPARMCOUNT(2, VM_bufstr_free);
4226 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4229 VM_Warning(prog, "VM_bufstr_free: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4232 i = (int)PRVM_G_FLOAT(OFS_PARM1);
4235 VM_Warning(prog, "VM_bufstr_free: invalid string index %i used in %s\n", i, prog->name);
4239 if (i < stringbuffer->num_strings)
4241 if(stringbuffer->strings[i])
4242 Mem_Free(stringbuffer->strings[i]);
4243 stringbuffer->strings[i] = NULL;
4246 BufStr_Shrink(prog, stringbuffer);
4250 ========================
4252 load a file into string buffer, return 0 or 1
4253 float buf_loadfile(string filename, float bufhandle) = #535;
4254 ========================
4256 void VM_buf_loadfile(prvm_prog_t *prog)
4259 prvm_stringbuffer_t *stringbuffer;
4260 char string[VM_STRINGTEMP_LENGTH];
4261 int strindex, c, end;
4262 const char *filename;
4266 VM_SAFEPARMCOUNT(2, VM_buf_loadfile);
4269 filename = PRVM_G_STRING(OFS_PARM0);
4270 file = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
4272 file = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
4275 if (developer_extra.integer)
4276 VM_Warning(prog, "VM_buf_loadfile: failed to open file %s in %s\n", filename, prog->name);
4277 PRVM_G_FLOAT(OFS_RETURN) = 0;
4281 // get string buffer
4282 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM1));
4285 VM_Warning(prog, "VM_buf_loadfile: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4286 PRVM_G_FLOAT(OFS_RETURN) = 0;
4290 // read file (append to the end of buffer)
4291 strindex = stringbuffer->num_strings;
4299 if (c == '\r' || c == '\n' || c < 0)
4301 if (end < VM_STRINGTEMP_LENGTH - 1)
4305 // remove \n following \r
4310 FS_UnGetc(file, (unsigned char)c);
4315 BufStr_Expand(prog, stringbuffer, strindex);
4316 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4317 alloclen = strlen(string) + 1;
4318 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4319 memcpy(stringbuffer->strings[strindex], string, alloclen);
4320 strindex = stringbuffer->num_strings;
4328 PRVM_G_FLOAT(OFS_RETURN) = 1;
4332 ========================
4334 writes stringbuffer to a file, returns 0 or 1
4335 float buf_writefile(float filehandle, float bufhandle, [, float startpos, float numstrings]) = #468;
4336 ========================
4339 void VM_buf_writefile(prvm_prog_t *prog)
4341 int filenum, strindex, strnum, strlength;
4342 prvm_stringbuffer_t *stringbuffer;
4344 VM_SAFEPARMCOUNTRANGE(2, 4, VM_buf_writefile);
4347 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
4348 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
4350 VM_Warning(prog, "VM_buf_writefile: invalid file handle %i used in %s\n", filenum, prog->name);
4353 if (prog->openfiles[filenum] == NULL)
4355 VM_Warning(prog, "VM_buf_writefile: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
4359 // get string buffer
4360 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM1));
4363 VM_Warning(prog, "VM_buf_writefile: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4364 PRVM_G_FLOAT(OFS_RETURN) = 0;
4368 // get start and end parms
4371 strindex = (int)PRVM_G_FLOAT(OFS_PARM2);
4372 strnum = (int)PRVM_G_FLOAT(OFS_PARM3);
4374 else if (prog->argc > 2)
4376 strindex = (int)PRVM_G_FLOAT(OFS_PARM2);
4377 strnum = stringbuffer->num_strings - strindex;
4382 strnum = stringbuffer->num_strings;
4384 if (strindex < 0 || strindex >= stringbuffer->num_strings)
4386 VM_Warning(prog, "VM_buf_writefile: wrong start string index %i used in %s\n", strindex, prog->name);
4387 PRVM_G_FLOAT(OFS_RETURN) = 0;
4392 VM_Warning(prog, "VM_buf_writefile: wrong strings count %i used in %s\n", strnum, prog->name);
4393 PRVM_G_FLOAT(OFS_RETURN) = 0;
4398 while(strindex < stringbuffer->num_strings && strnum)
4400 if (stringbuffer->strings[strindex])
4402 if ((strlength = (int)strlen(stringbuffer->strings[strindex])))
4403 FS_Write(prog->openfiles[filenum], stringbuffer->strings[strindex], strlength);
4404 FS_Write(prog->openfiles[filenum], "\n", 1);
4410 PRVM_G_FLOAT(OFS_RETURN) = 1;
4413 #define MATCH_AUTO 0
4414 #define MATCH_WHOLE 1
4415 #define MATCH_LEFT 2
4416 #define MATCH_RIGHT 3
4417 #define MATCH_MIDDLE 4
4418 #define MATCH_PATTERN 5
4420 static const char *detect_match_rule(char *pattern, int *matchrule)
4425 patternlength = (int)strlen(pattern);
4426 ppos = strchr(pattern, '*');
4427 qpos = strchr(pattern, '?');
4431 *matchrule = MATCH_PATTERN;
4434 // has * - left, mid, right or pattern
4437 // starts with * - may be right/mid or pattern
4438 if ((ppos - pattern) == 0)
4440 ppos = strchr(pattern+1, '*');
4444 *matchrule = MATCH_RIGHT;
4448 if ((ppos - pattern) == patternlength)
4450 *matchrule = MATCH_MIDDLE;
4455 *matchrule = MATCH_PATTERN;
4458 // end with * - left
4459 if ((ppos - pattern) == patternlength)
4461 *matchrule = MATCH_LEFT;
4466 *matchrule = MATCH_PATTERN;
4469 // have no wildcards - whole string
4470 *matchrule = MATCH_WHOLE;
4474 // todo: support UTF8
4475 static qbool match_rule(const char *string, int max_string, const char *pattern, int patternlength, int rule)
4480 return !strncmp(string, pattern, max_string) ? true : false;
4482 return !strncmp(string, pattern, patternlength) ? true : false;
4485 mid = strstr(string, pattern);
4486 return mid && !*(mid+patternlength);
4489 return strstr(string, pattern) ? true : false;
4491 return matchpattern_with_separator(string, pattern, false, "", false) ? true : false;
4495 ========================
4497 find an index of bufstring matching rule
4498 float bufstr_find(float bufhandle, string match, float matchrule, float startpos, float step) = #468;
4499 ========================
4502 void VM_bufstr_find(prvm_prog_t *prog)
4504 prvm_stringbuffer_t *stringbuffer;
4505 char string[VM_STRINGTEMP_LENGTH];
4506 int matchrule, matchlen, i, step;
4509 VM_SAFEPARMCOUNTRANGE(3, 5, VM_bufstr_find);
4511 PRVM_G_FLOAT(OFS_RETURN) = -1;
4513 // get string buffer
4514 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4517 VM_Warning(prog, "VM_bufstr_find: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4522 matchrule = (int)PRVM_G_FLOAT(OFS_PARM2);
4523 if (matchrule < 0 || matchrule > 5)
4525 VM_Warning(prog, "VM_bufstr_find: invalid match rule %i in %s\n", matchrule, prog->name);
4529 match = PRVM_G_STRING(OFS_PARM1);
4532 strlcpy(string, PRVM_G_STRING(OFS_PARM1), sizeof(string));
4533 match = detect_match_rule(string, &matchrule);
4535 matchlen = (int)strlen(match);
4538 i = (prog->argc > 3) ? (int)PRVM_G_FLOAT(OFS_PARM3) : 0;
4539 step = (prog->argc > 4) ? (int)PRVM_G_FLOAT(OFS_PARM4) : 1;
4540 while(i < stringbuffer->num_strings)
4542 if (stringbuffer->strings[i] && match_rule(stringbuffer->strings[i], VM_STRINGTEMP_LENGTH, match, matchlen, matchrule))
4544 PRVM_G_FLOAT(OFS_RETURN) = i;
4552 ========================
4554 float matchpattern(string s, string pattern, float matchrule, float startpos) = #468;
4555 ========================
4557 void VM_matchpattern(prvm_prog_t *prog)
4559 const char *s, *match;
4560 char string[VM_STRINGTEMP_LENGTH];
4563 VM_SAFEPARMCOUNTRANGE(2, 4, VM_matchpattern);
4565 s = PRVM_G_STRING(OFS_PARM0);
4568 matchrule = (int)PRVM_G_FLOAT(OFS_PARM2);
4569 if (matchrule < 0 || matchrule > 5)
4571 VM_Warning(prog, "VM_matchpattern: invalid match rule %i in %s\n", matchrule, prog->name);
4575 match = PRVM_G_STRING(OFS_PARM1);
4578 strlcpy(string, PRVM_G_STRING(OFS_PARM1), sizeof(string));
4579 match = detect_match_rule(string, &matchrule);
4583 l = (int)strlen(match);
4585 s += max(0, min((unsigned int)PRVM_G_FLOAT(OFS_PARM3), strlen(s)-1));
4588 PRVM_G_FLOAT(OFS_RETURN) = match_rule(s, VM_STRINGTEMP_LENGTH, match, l, matchrule);
4592 ========================
4594 ========================
4597 void VM_buf_cvarlist(prvm_prog_t *prog)
4600 const char *partial, *antipartial;
4601 size_t len, antilen;
4603 qbool ispattern, antiispattern;
4605 prvm_stringbuffer_t *stringbuffer;
4606 VM_SAFEPARMCOUNTRANGE(2, 3, VM_buf_cvarlist);
4608 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4611 VM_Warning(prog, "VM_bufstr_free: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4615 partial = PRVM_G_STRING(OFS_PARM1);
4619 len = strlen(partial);
4622 antipartial = PRVM_G_STRING(OFS_PARM2);
4628 antilen = strlen(antipartial);
4630 for (n = 0;n < stringbuffer->num_strings;n++)
4631 if (stringbuffer->strings[n])
4632 Mem_Free(stringbuffer->strings[n]);
4633 if (stringbuffer->strings)
4634 Mem_Free(stringbuffer->strings);
4635 stringbuffer->strings = NULL;
4637 ispattern = partial && (strchr(partial, '*') || strchr(partial, '?'));
4638 antiispattern = antipartial && (strchr(antipartial, '*') || strchr(antipartial, '?'));
4641 for(cvar = prog->console_cmd->cvars->vars; cvar; cvar = cvar->next)
4643 if(len && (ispattern ? !matchpattern_with_separator(cvar->name, partial, false, "", false) : strncmp(partial, cvar->name, len)))
4646 if(antilen && (antiispattern ? matchpattern_with_separator(cvar->name, antipartial, false, "", false) : !strncmp(antipartial, cvar->name, antilen)))
4652 stringbuffer->max_strings = stringbuffer->num_strings = n;
4653 if (stringbuffer->max_strings)
4654 stringbuffer->strings = (char **)Mem_Alloc(prog->progs_mempool, sizeof(stringbuffer->strings[0]) * stringbuffer->max_strings);
4657 for(cvar = prog->console_cmd->cvars->vars; cvar; cvar = cvar->next)
4659 if(len && (ispattern ? !matchpattern_with_separator(cvar->name, partial, false, "", false) : strncmp(partial, cvar->name, len)))
4662 if(antilen && (antiispattern ? matchpattern_with_separator(cvar->name, antipartial, false, "", false) : !strncmp(antipartial, cvar->name, antilen)))
4665 alloclen = strlen(cvar->name) + 1;
4666 stringbuffer->strings[n] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4667 memcpy(stringbuffer->strings[n], cvar->name, alloclen);
4682 This was a major timewaster in progs, so it was converted to C
4685 void VM_changeyaw (prvm_prog_t *prog)
4688 float ideal, current, move, speed;
4690 // this is called (VERY HACKISHLY) by VM_SV_MoveToGoal, so it can not use any
4691 // parameters because they are the parameters to VM_SV_MoveToGoal, not this
4692 //VM_SAFEPARMCOUNT(0, VM_changeyaw);
4694 ent = PRVM_PROG_TO_EDICT(PRVM_gameglobaledict(self));
4695 if (ent == prog->edicts)
4697 VM_Warning(prog, "changeyaw: can not modify world entity\n");
4702 VM_Warning(prog, "changeyaw: can not modify free entity\n");
4705 current = PRVM_gameedictvector(ent, angles)[1];
4706 current = ANGLEMOD(current);
4707 ideal = PRVM_gameedictfloat(ent, ideal_yaw);
4708 speed = PRVM_gameedictfloat(ent, yaw_speed);
4710 if (current == ideal)
4712 move = ideal - current;
4713 if (ideal > current)
4735 PRVM_gameedictvector(ent, angles)[1] = ANGLEMOD(current);
4743 void VM_changepitch (prvm_prog_t *prog)
4746 float ideal, current, move, speed;
4748 VM_SAFEPARMCOUNT(1, VM_changepitch);
4750 ent = PRVM_G_EDICT(OFS_PARM0);
4751 if (ent == prog->edicts)
4753 VM_Warning(prog, "changepitch: can not modify world entity\n");
4758 VM_Warning(prog, "changepitch: can not modify free entity\n");
4761 current = PRVM_gameedictvector(ent, angles)[0];
4762 current = ANGLEMOD(current);
4763 ideal = PRVM_gameedictfloat(ent, idealpitch);
4764 speed = PRVM_gameedictfloat(ent, pitch_speed);
4766 if (current == ideal)
4768 move = ideal - current;
4769 if (ideal > current)
4791 PRVM_gameedictvector(ent, angles)[0] = ANGLEMOD(current);
4795 void VM_uncolorstring (prvm_prog_t *prog)
4797 char szNewString[VM_STRINGTEMP_LENGTH];
4798 const char *szString;
4801 VM_SAFEPARMCOUNT(1, VM_uncolorstring);
4802 szString = PRVM_G_STRING(OFS_PARM0);
4803 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), true);
4804 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
4808 // #221 float(string str, string sub[, float startpos]) strstrofs (FTE_STRINGS)
4809 //strstr, without generating a new string. Use in conjunction with FRIK_FILE's substring for more similar strstr.
4810 void VM_strstrofs (prvm_prog_t *prog)
4812 const char *instr, *match;
4814 VM_SAFEPARMCOUNTRANGE(2, 3, VM_strstrofs);
4815 instr = PRVM_G_STRING(OFS_PARM0);
4816 match = PRVM_G_STRING(OFS_PARM1);
4817 firstofs = (prog->argc > 2)?(int)PRVM_G_FLOAT(OFS_PARM2):0;
4818 firstofs = (int)u8_bytelen(instr, firstofs);
4820 if (firstofs && (firstofs < 0 || firstofs > (int)strlen(instr)))
4822 PRVM_G_FLOAT(OFS_RETURN) = -1;
4826 match = strstr(instr+firstofs, match);
4828 PRVM_G_FLOAT(OFS_RETURN) = -1;
4830 PRVM_G_FLOAT(OFS_RETURN) = u8_strnlen(instr, match-instr);
4833 //#222 string(string s, float index) str2chr (FTE_STRINGS)
4834 void VM_str2chr (prvm_prog_t *prog)
4839 VM_SAFEPARMCOUNT(2, VM_str2chr);
4840 s = PRVM_G_STRING(OFS_PARM0);
4841 index = (int)u8_bytelen(s, (int)PRVM_G_FLOAT(OFS_PARM1));
4843 if((unsigned)index < strlen(s))
4845 if (utf8_enable.integer)
4846 ch = u8_getchar_noendptr(s + index);
4848 ch = (unsigned char)s[index];
4849 PRVM_G_FLOAT(OFS_RETURN) = ch;
4852 PRVM_G_FLOAT(OFS_RETURN) = 0;
4855 //#223 string(float c, ...) chr2str (FTE_STRINGS)
4856 void VM_chr2str (prvm_prog_t *prog)
4861 VM_SAFEPARMCOUNTRANGE(0, 8, VM_chr2str);
4862 for(i = 0;i < prog->argc && i < (int)sizeof(t) - 1;i++)
4863 t[i] = (unsigned char)PRVM_G_FLOAT(OFS_PARM0+i*3);
4865 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, t);
4870 VM_SAFEPARMCOUNTRANGE(0, 8, VM_chr2str);
4871 for(i = 0; i < prog->argc && len < sizeof(t)-1; ++i)
4872 len += u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0+i*3), t + len, sizeof(t)-1);
4874 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, t);
4877 static int chrconv_number(int i, int base, int conv)
4902 static int chrconv_punct(int i, int base, int conv)
4920 static int chrchar_alpha(int i, int basec, int baset, int convc, int convt, int charnum)
4922 //convert case and colour seperatly...
4939 baset = 128*((charnum&1) == (convt-5));
4955 return i + basec + baset;
4957 // #224 string(float ccase, float calpha, float cnum, string s, ...) strconv (FTE_STRINGS)
4958 //bulk convert a string. change case or colouring.
4959 void VM_strconv (prvm_prog_t *prog)
4961 int ccase, redalpha, rednum, len, i;
4962 unsigned char resbuf[VM_STRINGTEMP_LENGTH];
4963 unsigned char *result = resbuf;
4965 VM_SAFEPARMCOUNTRANGE(3, 8, VM_strconv);
4967 ccase = (int) PRVM_G_FLOAT(OFS_PARM0); //0 same, 1 lower, 2 upper
4968 redalpha = (int) PRVM_G_FLOAT(OFS_PARM1); //0 same, 1 white, 2 red, 5 alternate, 6 alternate-alternate
4969 rednum = (int) PRVM_G_FLOAT(OFS_PARM2); //0 same, 1 white, 2 red, 3 redspecial, 4 whitespecial, 5 alternate, 6 alternate-alternate
4970 VM_VarString(prog, 3, (char *) resbuf, sizeof(resbuf));
4971 len = (int)strlen((char *) resbuf);
4973 for (i = 0; i < len; i++, result++) //should this be done backwards?
4975 if (*result >= '0' && *result <= '9') //normal numbers...
4976 *result = chrconv_number(*result, '0', rednum);
4977 else if (*result >= '0'+128 && *result <= '9'+128)
4978 *result = chrconv_number(*result, '0'+128, rednum);
4979 else if (*result >= '0'+128-30 && *result <= '9'+128-30)
4980 *result = chrconv_number(*result, '0'+128-30, rednum);
4981 else if (*result >= '0'-30 && *result <= '9'-30)
4982 *result = chrconv_number(*result, '0'-30, rednum);
4984 else if (*result >= 'a' && *result <= 'z') //normal numbers...
4985 *result = chrchar_alpha(*result, 'a', 0, ccase, redalpha, i);
4986 else if (*result >= 'A' && *result <= 'Z') //normal numbers...
4987 *result = chrchar_alpha(*result, 'A', 0, ccase, redalpha, i);
4988 else if (*result >= 'a'+128 && *result <= 'z'+128) //normal numbers...
4989 *result = chrchar_alpha(*result, 'a', 128, ccase, redalpha, i);
4990 else if (*result >= 'A'+128 && *result <= 'Z'+128) //normal numbers...
4991 *result = chrchar_alpha(*result, 'A', 128, ccase, redalpha, i);
4993 else if ((*result & 127) < 16 || !redalpha) //special chars..
4995 else if (*result < 128)
4996 *result = chrconv_punct(*result, 0, redalpha);
4998 *result = chrconv_punct(*result, 128, redalpha);
5002 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, (char *) resbuf);
5005 // #225 string(float chars, string s, ...) strpad (FTE_STRINGS)
5006 void VM_strpad (prvm_prog_t *prog)
5008 char src[VM_STRINGTEMP_LENGTH];
5009 char destbuf[VM_STRINGTEMP_LENGTH];
5011 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strpad);
5012 pad = (int) PRVM_G_FLOAT(OFS_PARM0);
5013 VM_VarString(prog, 1, src, sizeof(src));
5015 // note: < 0 = left padding, > 0 = right padding,
5016 // this is reverse logic of printf!
5017 dpsnprintf(destbuf, sizeof(destbuf), "%*s", -pad, src);
5019 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, destbuf);
5022 // #226 string(string info, string key, string value, ...) infoadd (FTE_STRINGS)
5023 //uses qw style \key\value strings
5024 void VM_infoadd (prvm_prog_t *prog)
5026 const char *info, *key;
5027 char value[VM_STRINGTEMP_LENGTH];
5028 char temp[VM_STRINGTEMP_LENGTH];
5030 VM_SAFEPARMCOUNTRANGE(2, 8, VM_infoadd);
5031 info = PRVM_G_STRING(OFS_PARM0);
5032 key = PRVM_G_STRING(OFS_PARM1);
5033 VM_VarString(prog, 2, value, sizeof(value));
5035 strlcpy(temp, info, VM_STRINGTEMP_LENGTH);
5037 InfoString_SetValue(temp, VM_STRINGTEMP_LENGTH, key, value);
5039 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, temp);
5042 // #227 string(string info, string key) infoget (FTE_STRINGS)
5043 //uses qw style \key\value strings
5044 void VM_infoget (prvm_prog_t *prog)
5048 char value[VM_STRINGTEMP_LENGTH];
5050 VM_SAFEPARMCOUNT(2, VM_infoget);
5051 info = PRVM_G_STRING(OFS_PARM0);
5052 key = PRVM_G_STRING(OFS_PARM1);
5054 InfoString_GetValue(info, key, value, VM_STRINGTEMP_LENGTH);
5056 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, value);
5059 //#228 float(string s1, string s2, float len) strncmp (FTE_STRINGS)
5060 // also float(string s1, string s2) strcmp (FRIK_FILE)
5061 void VM_strncmp (prvm_prog_t *prog)
5063 const char *s1, *s2;
5064 VM_SAFEPARMCOUNTRANGE(2, 3, VM_strncmp);
5065 s1 = PRVM_G_STRING(OFS_PARM0);
5066 s2 = PRVM_G_STRING(OFS_PARM1);
5069 PRVM_G_FLOAT(OFS_RETURN) = strncmp(s1, s2, (size_t)PRVM_G_FLOAT(OFS_PARM2));
5073 PRVM_G_FLOAT(OFS_RETURN) = strcmp(s1, s2);
5077 // #229 float(string s1, string s2) strcasecmp (FTE_STRINGS)
5078 // #230 float(string s1, string s2, float len) strncasecmp (FTE_STRINGS)
5079 void VM_strncasecmp (prvm_prog_t *prog)
5081 const char *s1, *s2;
5082 VM_SAFEPARMCOUNTRANGE(2, 3, VM_strncasecmp);
5083 s1 = PRVM_G_STRING(OFS_PARM0);
5084 s2 = PRVM_G_STRING(OFS_PARM1);
5087 PRVM_G_FLOAT(OFS_RETURN) = strncasecmp(s1, s2, (size_t)PRVM_G_FLOAT(OFS_PARM2));
5091 PRVM_G_FLOAT(OFS_RETURN) = strcasecmp(s1, s2);
5095 // #494 float(float caseinsensitive, string s, ...) crc16
5096 void VM_crc16(prvm_prog_t *prog)
5099 char s[VM_STRINGTEMP_LENGTH];
5100 VM_SAFEPARMCOUNTRANGE(2, 8, VM_crc16);
5101 insensitive = PRVM_G_FLOAT(OFS_PARM0);
5102 VM_VarString(prog, 1, s, sizeof(s));
5103 PRVM_G_FLOAT(OFS_RETURN) = (unsigned short) ((insensitive ? CRC_Block_CaseInsensitive : CRC_Block) ((unsigned char *) s, strlen(s)));
5106 // #639 float(string digest, string data, ...) digest_hex
5107 void VM_digest_hex(prvm_prog_t *prog)
5115 char s[VM_STRINGTEMP_LENGTH];
5118 VM_SAFEPARMCOUNTRANGE(2, 8, VM_digest_hex);
5119 digest = PRVM_G_STRING(OFS_PARM0);
5122 VM_VarString(prog, 1, s, sizeof(s));
5123 len = (int)strlen(s);
5127 if(!strcmp(digest, "MD4"))
5130 mdfour((unsigned char *) out, (unsigned char *) s, len);
5132 else if(!strcmp(digest, "SHA256") && Crypto_Available())
5135 sha256((unsigned char *) out, (unsigned char *) s, len);
5137 // no warning needed on mismatch - we return string_null to QC
5142 static const char *hexmap = "0123456789abcdef";
5143 for(i = 0; i < outlen; ++i)
5145 outhex[2*i] = hexmap[(out[i] >> 4) & 15];
5146 outhex[2*i+1] = hexmap[(out[i] >> 0) & 15];
5149 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, outhex);
5152 PRVM_G_INT(OFS_RETURN) = 0;
5155 void VM_wasfreed (prvm_prog_t *prog)
5157 VM_SAFEPARMCOUNT(1, VM_wasfreed);
5158 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICT(OFS_PARM0)->free;
5161 void VM_SetTraceGlobals(prvm_prog_t *prog, const trace_t *trace)
5163 PRVM_gameglobalfloat(trace_allsolid) = trace->allsolid;
5164 PRVM_gameglobalfloat(trace_startsolid) = trace->startsolid;
5165 PRVM_gameglobalfloat(trace_fraction) = trace->fraction;
5166 PRVM_gameglobalfloat(trace_inwater) = trace->inwater;
5167 PRVM_gameglobalfloat(trace_inopen) = trace->inopen;
5168 VectorCopy(trace->endpos, PRVM_gameglobalvector(trace_endpos));
5169 VectorCopy(trace->plane.normal, PRVM_gameglobalvector(trace_plane_normal));
5170 PRVM_gameglobalfloat(trace_plane_dist) = trace->plane.dist;
5171 PRVM_gameglobaledict(trace_ent) = PRVM_EDICT_TO_PROG(trace->ent ? trace->ent : prog->edicts);
5172 PRVM_gameglobalfloat(trace_dpstartcontents) = trace->startsupercontents;
5173 PRVM_gameglobalfloat(trace_dphitcontents) = trace->hitsupercontents;
5174 PRVM_gameglobalfloat(trace_dphitq3surfaceflags) = trace->hitq3surfaceflags;
5175 PRVM_gameglobalstring(trace_dphittexturename) = trace->hittexture ? PRVM_SetTempString(prog, trace->hittexture->name) : 0;
5178 void VM_ClearTraceGlobals(prvm_prog_t *prog)
5180 // clean up all trace globals when leaving the VM (anti-triggerbot safeguard)
5181 PRVM_gameglobalfloat(trace_allsolid) = 0;
5182 PRVM_gameglobalfloat(trace_startsolid) = 0;
5183 PRVM_gameglobalfloat(trace_fraction) = 0;
5184 PRVM_gameglobalfloat(trace_inwater) = 0;
5185 PRVM_gameglobalfloat(trace_inopen) = 0;
5186 VectorClear(PRVM_gameglobalvector(trace_endpos));
5187 VectorClear(PRVM_gameglobalvector(trace_plane_normal));
5188 PRVM_gameglobalfloat(trace_plane_dist) = 0;
5189 PRVM_gameglobaledict(trace_ent) = PRVM_EDICT_TO_PROG(prog->edicts);
5190 PRVM_gameglobalfloat(trace_dpstartcontents) = 0;
5191 PRVM_gameglobalfloat(trace_dphitcontents) = 0;
5192 PRVM_gameglobalfloat(trace_dphitq3surfaceflags) = 0;
5193 PRVM_gameglobalstring(trace_dphittexturename) = 0;
5198 void VM_Cmd_Init(prvm_prog_t *prog)
5200 // only init the stuff for the current prog
5201 VM_Files_Init(prog);
5202 VM_Search_Init(prog);
5205 static void animatemodel_reset(prvm_prog_t *prog);
5207 void VM_Cmd_Reset(prvm_prog_t *prog)
5209 CL_PurgeOwner( MENUOWNER );
5210 VM_Search_Reset(prog);
5211 VM_Files_CloseAll(prog);
5212 animatemodel_reset(prog);
5215 // #510 string(string input, ...) uri_escape (DP_QC_URI_ESCAPE)
5216 // does URI escaping on a string (replace evil stuff by %AB escapes)
5217 void VM_uri_escape (prvm_prog_t *prog)
5219 char src[VM_STRINGTEMP_LENGTH];
5220 char dest[VM_STRINGTEMP_LENGTH];
5222 static const char *hex = "0123456789ABCDEF";
5224 VM_SAFEPARMCOUNTRANGE(1, 8, VM_uri_escape);
5225 VM_VarString(prog, 0, src, sizeof(src));
5227 for(p = src, q = dest; *p && q < dest + sizeof(dest) - 3; ++p)
5229 if((*p >= 'A' && *p <= 'Z')
5230 || (*p >= 'a' && *p <= 'z')
5231 || (*p >= '0' && *p <= '9')
5232 || (*p == '-') || (*p == '_') || (*p == '.')
5233 || (*p == '!') || (*p == '~')
5234 || (*p == '\'') || (*p == '(') || (*p == ')'))
5239 *q++ = hex[(*(unsigned char *)p >> 4) & 0xF];
5240 *q++ = hex[ *(unsigned char *)p & 0xF];
5245 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, dest);
5248 // #510 string(string input, ...) uri_unescape (DP_QC_URI_ESCAPE)
5249 // does URI unescaping on a string (get back the evil stuff)
5250 void VM_uri_unescape (prvm_prog_t *prog)
5252 char src[VM_STRINGTEMP_LENGTH];
5253 char dest[VM_STRINGTEMP_LENGTH];
5257 VM_SAFEPARMCOUNTRANGE(1, 8, VM_uri_unescape);
5258 VM_VarString(prog, 0, src, sizeof(src));
5260 for(p = src, q = dest; *p; ) // no need to check size, because unescape can't expand
5264 if(p[1] >= '0' && p[1] <= '9')
5266 else if(p[1] >= 'a' && p[1] <= 'f')
5267 hi = p[1] - 'a' + 10;
5268 else if(p[1] >= 'A' && p[1] <= 'F')
5269 hi = p[1] - 'A' + 10;
5272 if(p[2] >= '0' && p[2] <= '9')
5274 else if(p[2] >= 'a' && p[2] <= 'f')
5275 lo = p[2] - 'a' + 10;
5276 else if(p[2] >= 'A' && p[2] <= 'F')
5277 lo = p[2] - 'A' + 10;
5280 if(hi != 0 || lo != 0) // don't unescape NUL bytes
5281 *q++ = (char) (hi * 0x10 + lo);
5292 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, dest);
5295 // #502 string(string filename) whichpack (DP_QC_WHICHPACK)
5296 // returns the name of the pack containing a file, or "" if it is not in any pack (but local or non-existant)
5297 void VM_whichpack (prvm_prog_t *prog)
5299 const char *fn, *pack;
5301 VM_SAFEPARMCOUNT(1, VM_whichpack);
5302 fn = PRVM_G_STRING(OFS_PARM0);
5303 pack = FS_WhichPack(fn);
5305 PRVM_G_INT(OFS_RETURN) = pack ? PRVM_SetTempString(prog, pack) : 0;
5313 char buffer[MAX_INPUTLINE];
5315 unsigned char *postdata; // free when uri_to_prog_t is freed
5317 char *sigdata; // free when uri_to_prog_t is freed
5322 static void uri_to_string_callback(int status, size_t length_received, unsigned char *buffer, void *cbdata)
5325 uri_to_prog_t *handle = (uri_to_prog_t *) cbdata;
5327 prog = handle->prog;
5330 // curl reply came too late... so just drop it
5331 if(handle->postdata)
5332 Z_Free(handle->postdata);
5334 Z_Free(handle->sigdata);
5339 if((prog->starttime == handle->starttime) && (PRVM_allfunction(URI_Get_Callback)))
5341 if(length_received >= sizeof(handle->buffer))
5342 length_received = sizeof(handle->buffer) - 1;
5343 handle->buffer[length_received] = 0;
5345 PRVM_G_FLOAT(OFS_PARM0) = handle->id;
5346 PRVM_G_FLOAT(OFS_PARM1) = status;
5347 PRVM_G_INT(OFS_PARM2) = PRVM_SetTempString(prog, handle->buffer);
5348 prog->ExecuteProgram(prog, PRVM_allfunction(URI_Get_Callback), "QC function URI_Get_Callback is missing");
5351 if(handle->postdata)
5352 Z_Free(handle->postdata);
5354 Z_Free(handle->sigdata);
5358 // 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
5359 // 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
5360 void VM_uri_get (prvm_prog_t *prog)
5365 uri_to_prog_t *handle;
5366 const char *posttype = NULL;
5367 const char *postseparator = NULL;
5368 int poststringbuffer = -1;
5370 const char *query_string = NULL;
5373 if(!PRVM_allfunction(URI_Get_Callback))
5374 prog->error_cmd("uri_get called by %s without URI_Get_Callback defined", prog->name);
5376 VM_SAFEPARMCOUNTRANGE(2, 6, VM_uri_get);
5378 url = PRVM_G_STRING(OFS_PARM0);
5379 id = PRVM_G_FLOAT(OFS_PARM1);
5381 posttype = PRVM_G_STRING(OFS_PARM2);
5383 postseparator = PRVM_G_STRING(OFS_PARM3);
5385 poststringbuffer = PRVM_G_FLOAT(OFS_PARM4);
5387 postkeyid = PRVM_G_FLOAT(OFS_PARM5);
5388 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!
5390 query_string = strchr(url, '?');
5393 lq = query_string ? strlen(query_string) : 0;
5395 handle->prog = prog;
5396 handle->starttime = prog->starttime;
5398 if(postseparator && posttype && *posttype)
5400 size_t l = strlen(postseparator);
5401 if(poststringbuffer >= 0)
5406 prvm_stringbuffer_t *stringbuffer;
5407 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, poststringbuffer);
5410 VM_Warning(prog, "uri_get: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
5414 for(i = 0;i < stringbuffer->num_strings;i++)
5418 if(stringbuffer->strings[i])
5419 ltotal += strlen(stringbuffer->strings[i]);
5421 handle->postdata = (unsigned char *)Z_Malloc(ltotal + 1 + lq);
5422 handle->postlen = ltotal;
5424 for(i = 0;i < stringbuffer->num_strings;i++)
5428 memcpy(handle->postdata + ltotal, postseparator, l);
5431 if(stringbuffer->strings[i])
5433 memcpy(handle->postdata + ltotal, stringbuffer->strings[i], strlen(stringbuffer->strings[i]));
5434 ltotal += strlen(stringbuffer->strings[i]);
5437 if(ltotal != handle->postlen)
5438 prog->error_cmd("%s: string buffer content size mismatch, possible overrun", prog->name);
5442 handle->postdata = (unsigned char *)Z_Malloc(l + 1 + lq);
5443 handle->postlen = l;
5444 memcpy(handle->postdata, postseparator, l);
5446 handle->postdata[handle->postlen] = 0;
5448 memcpy(handle->postdata + handle->postlen + 1, query_string, lq);
5451 // POST: we sign postdata \0 query string
5453 handle->sigdata = (char *)Z_Malloc(8192);
5454 strlcpy(handle->sigdata, "X-D0-Blind-ID-Detached-Signature: ", 8192);
5455 l = strlen(handle->sigdata);
5456 handle->siglen = Crypto_SignDataDetached(handle->postdata, handle->postlen + 1 + lq, postkeyid, handle->sigdata + l, 8192 - l);
5459 Z_Free(handle->sigdata);
5460 handle->sigdata = NULL;
5463 ll = base64_encode((unsigned char *) (handle->sigdata + l), handle->siglen, 8192 - l - 1);
5466 Z_Free(handle->sigdata);
5467 handle->sigdata = NULL;
5470 handle->siglen = l + ll;
5471 handle->sigdata[handle->siglen] = 0;
5474 strlcpy(handle->posttype, posttype, sizeof(handle->posttype));
5475 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);
5479 if(postkeyid >= 0 && query_string)
5481 // GET: we sign JUST the query string
5483 handle->sigdata = (char *)Z_Malloc(8192);
5484 strlcpy(handle->sigdata, "X-D0-Blind-ID-Detached-Signature: ", 8192);
5485 l = strlen(handle->sigdata);
5486 handle->siglen = Crypto_SignDataDetached(query_string, lq, postkeyid, handle->sigdata + l, 8192 - l);
5489 Z_Free(handle->sigdata);
5490 handle->sigdata = NULL;
5493 ll = base64_encode((unsigned char *) (handle->sigdata + l), handle->siglen, 8192 - l - 1);
5496 Z_Free(handle->sigdata);
5497 handle->sigdata = NULL;
5500 handle->siglen = l + ll;
5501 handle->sigdata[handle->siglen] = 0;
5504 handle->postdata = NULL;
5505 handle->postlen = 0;
5506 ret = Curl_Begin_ToMemory_POST(url, handle->sigdata, 0, NULL, NULL, 0, (unsigned char *) handle->buffer, sizeof(handle->buffer), uri_to_string_callback, handle);
5510 PRVM_G_INT(OFS_RETURN) = 1;
5514 if(handle->postdata)
5515 Z_Free(handle->postdata);
5517 Z_Free(handle->sigdata);
5519 PRVM_G_INT(OFS_RETURN) = 0;
5523 void VM_netaddress_resolve (prvm_prog_t *prog)
5526 char normalized[128];
5528 lhnetaddress_t addr;
5530 VM_SAFEPARMCOUNTRANGE(1, 2, VM_netaddress_resolve);
5532 ip = PRVM_G_STRING(OFS_PARM0);
5535 port = (int) PRVM_G_FLOAT(OFS_PARM1);
5537 if(LHNETADDRESS_FromString(&addr, ip, port) && LHNETADDRESS_ToString(&addr, normalized, sizeof(normalized), prog->argc > 1))
5538 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, normalized);
5540 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
5543 //string(prvm_prog_t *prog) getextresponse = #624; // returns the next extResponse packet that was sent to this client
5544 void VM_CL_getextresponse (prvm_prog_t *prog)
5546 VM_SAFEPARMCOUNT(0,VM_argv);
5548 if (cl_net_extresponse_count <= 0)
5549 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
5553 --cl_net_extresponse_count;
5554 first = (cl_net_extresponse_last + NET_EXTRESPONSE_MAX - cl_net_extresponse_count) % NET_EXTRESPONSE_MAX;
5555 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, cl_net_extresponse[first]);
5559 void VM_SV_getextresponse (prvm_prog_t *prog)
5561 VM_SAFEPARMCOUNT(0,VM_argv);
5563 if (sv_net_extresponse_count <= 0)
5564 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
5568 --sv_net_extresponse_count;
5569 first = (sv_net_extresponse_last + NET_EXTRESPONSE_MAX - sv_net_extresponse_count) % NET_EXTRESPONSE_MAX;
5570 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, sv_net_extresponse[first]);
5574 // DP_QC_NUDGEOUTOFSOLID
5575 // float(entity ent) nudgeoutofsolid = #567;
5576 void VM_nudgeoutofsolid(prvm_prog_t *prog)
5580 VM_SAFEPARMCOUNTRANGE(1, 1, VM_nudgeoutofsolid);
5582 ent = PRVM_G_EDICT(OFS_PARM0);
5583 if (ent == prog->edicts)
5585 VM_Warning(prog, "nudgeoutofsolid: can not modify world entity\n");
5586 PRVM_G_FLOAT(OFS_RETURN) = 0;
5591 VM_Warning(prog, "nudgeoutofsolid: can not modify free entity\n");
5592 PRVM_G_FLOAT(OFS_RETURN) = 0;
5596 PRVM_G_FLOAT(OFS_RETURN) = PHYS_NudgeOutOfSolid(prog, ent);
5598 if (PRVM_G_FLOAT(OFS_RETURN) > 0)
5600 if (prog == SVVM_prog)
5602 else if (prog == CLVM_prog)
5605 Sys_Error("PHYS_NudgeOutOfSolid: cannot be called from %s VM\n", prog->name);
5611 Common functions between menu.dat and clsprogs
5615 //#349 float() isdemo
5616 void VM_CL_isdemo (prvm_prog_t *prog)
5618 VM_SAFEPARMCOUNT(0, VM_CL_isdemo);
5619 PRVM_G_FLOAT(OFS_RETURN) = cls.demoplayback;
5622 //#355 float() videoplaying
5623 void VM_CL_videoplaying (prvm_prog_t *prog)
5625 VM_SAFEPARMCOUNT(0, VM_CL_videoplaying);
5626 PRVM_G_FLOAT(OFS_RETURN) = cl_videoplaying;
5633 callfunction(...,string function_name)
5637 void VM_callfunction(prvm_prog_t *prog)
5642 VM_SAFEPARMCOUNTRANGE(1, 8, VM_callfunction);
5644 s = PRVM_G_STRING(OFS_PARM0+(prog->argc - 1)*3);
5646 VM_CheckEmptyString(prog, s);
5648 func = PRVM_ED_FindFunction(prog, s);
5651 prog->error_cmd("VM_callfunction: function %s not found !", s);
5652 else if (func->first_statement < 0)
5654 // negative statements are built in functions
5655 int builtinnumber = -func->first_statement;
5656 prog->xfunction->builtinsprofile++;
5657 if (builtinnumber < prog->numbuiltins && prog->builtins[builtinnumber])
5658 prog->builtins[builtinnumber](prog);
5660 prog->error_cmd("No such builtin #%i in %s; most likely cause: outdated engine build. Try updating!", builtinnumber, prog->name);
5662 else if(func - prog->functions > 0)
5665 prog->ExecuteProgram(prog, func - prog->functions,"");
5674 float isfunction(string function_name)
5677 void VM_isfunction(prvm_prog_t *prog)
5682 VM_SAFEPARMCOUNT(1, VM_isfunction);
5684 s = PRVM_G_STRING(OFS_PARM0);
5686 VM_CheckEmptyString(prog, s);
5688 func = PRVM_ED_FindFunction(prog, s);
5691 PRVM_G_FLOAT(OFS_RETURN) = false;
5693 PRVM_G_FLOAT(OFS_RETURN) = true;
5700 string sprintf(string format, ...)
5704 void VM_sprintf(prvm_prog_t *prog)
5707 char outbuf[MAX_INPUTLINE];
5708 char *o = outbuf, *end = outbuf + sizeof(outbuf), *err;
5711 int width, precision, thisarg, flags;
5715 static prvm_int_t dummyivec[3] = {0, 0, 0};
5716 static prvm_vec_t dummyvec[3] = {0, 0, 0};
5719 #define PRINTF_ALTERNATE 1
5720 #define PRINTF_ZEROPAD 2
5721 #define PRINTF_LEFT 4
5722 #define PRINTF_SPACEPOSITIVE 8
5723 #define PRINTF_SIGNPOSITIVE 16
5727 s = PRVM_G_STRING(OFS_PARM0);
5729 #define GETARG_FLOAT(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_FLOAT(OFS_PARM0 + 3 * (a))) : 0)
5730 #define GETARG_VECTOR(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_VECTOR(OFS_PARM0 + 3 * (a))) : dummyvec)
5731 #define GETARG_INT(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_INT(OFS_PARM0 + 3 * (a))) : 0)
5732 #define GETARG_INTVECTOR(a) (((a)>=1 && (a)<prog->argc) ? ((prvm_int_t*) PRVM_G_VECTOR(OFS_PARM0 + 3 * (a))) : dummyivec)
5733 #define GETARG_STRING(a) (((a)>=1 && (a)<prog->argc) ? (PRVM_G_STRING(OFS_PARM0 + 3 * (a))) : "")
5748 // complete directive format:
5757 // is number following?
5758 if(*s >= '0' && *s <= '9')
5760 width = strtol(s, &err, 10);
5763 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5776 flags |= PRINTF_ZEROPAD;
5778 width = -1; // it was just a flag
5790 case '#': flags |= PRINTF_ALTERNATE; break;
5791 case '0': flags |= PRINTF_ZEROPAD; break;
5792 case '-': flags |= PRINTF_LEFT; break;
5793 case ' ': flags |= PRINTF_SPACEPOSITIVE; break;
5794 case '+': flags |= PRINTF_SIGNPOSITIVE; break;
5804 if(*s >= '0' && *s <= '9')
5806 width = strtol(s, &err, 10);
5807 if(!err || *err != '$')
5809 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5816 width = GETARG_FLOAT(width);
5819 flags |= PRINTF_LEFT;
5823 else if(*s >= '0' && *s <= '9')
5825 width = strtol(s, &err, 10);
5828 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5834 flags |= PRINTF_LEFT;
5838 // otherwise width stays -1
5847 if(*s >= '0' && *s <= '9')
5849 precision = strtol(s, &err, 10);
5850 if(!err || *err != '$')
5852 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5858 precision = argpos++;
5859 precision = GETARG_FLOAT(precision);
5861 else if(*s >= '0' && *s <= '9')
5863 precision = strtol(s, &err, 10);
5866 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5873 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
5882 case 'h': isfloat = 1; break;
5883 case 'l': isfloat = 0; break;
5884 case 'L': isfloat = 0; break;
5895 // now s points to the final directive char and is no longer changed
5910 if(*s != 's' && *s != 'c')
5911 if(flags & PRINTF_ALTERNATE) *f++ = '#';
5912 if(flags & PRINTF_ZEROPAD) *f++ = '0';
5913 if(flags & PRINTF_LEFT) *f++ = '-';
5914 if(flags & PRINTF_SPACEPOSITIVE) *f++ = ' ';
5915 if(flags & PRINTF_SIGNPOSITIVE) *f++ = '+';
5922 if(*s == 'd' || *s == 'i' || *s == 'o' || *s == 'u' || *s == 'x' || *s == 'X')
5924 // make it use a good integer type
5925 for(p = INT_LOSSLESS_FORMAT_SIZE; *p; )
5931 if(width < 0) // not set
5937 if(precision < 0) // not set
5938 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? INT_LOSSLESS_FORMAT_CONVERT_S(GETARG_FLOAT(thisarg)) : INT_LOSSLESS_FORMAT_CONVERT_S(GETARG_INT(thisarg))));
5940 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))));
5942 case 'o': case 'u': case 'x': case 'X':
5943 if(precision < 0) // not set
5944 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? INT_LOSSLESS_FORMAT_CONVERT_U(GETARG_FLOAT(thisarg)) : INT_LOSSLESS_FORMAT_CONVERT_U(GETARG_INT(thisarg))));
5946 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))));
5948 case 'e': case 'E': case 'f': case 'F': case 'g': case 'G':
5949 if(precision < 0) // not set
5950 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? (double) GETARG_FLOAT(thisarg) : (double) GETARG_INT(thisarg)));
5952 o += dpsnprintf(o, end - o, formatbuf, width, precision, (isfloat ? (double) GETARG_FLOAT(thisarg) : (double) GETARG_INT(thisarg)));
5956 if(precision < 0) // not set
5957 o += dpsnprintf(o, end - o, va(vabuf, sizeof(vabuf), "%s %s %s", /* NESTED SPRINTF IS NESTED */ formatbuf, formatbuf, formatbuf),
5958 width, (isfloat ? (double) GETARG_VECTOR(thisarg)[0] : (double) GETARG_INTVECTOR(thisarg)[0]),
5959 width, (isfloat ? (double) GETARG_VECTOR(thisarg)[1] : (double) GETARG_INTVECTOR(thisarg)[1]),
5960 width, (isfloat ? (double) GETARG_VECTOR(thisarg)[2] : (double) GETARG_INTVECTOR(thisarg)[2])
5963 o += dpsnprintf(o, end - o, va(vabuf, sizeof(vabuf), "%s %s %s", /* NESTED SPRINTF IS NESTED */ formatbuf, formatbuf, formatbuf),
5964 width, precision, (isfloat ? (double) GETARG_VECTOR(thisarg)[0] : (double) GETARG_INTVECTOR(thisarg)[0]),
5965 width, precision, (isfloat ? (double) GETARG_VECTOR(thisarg)[1] : (double) GETARG_INTVECTOR(thisarg)[1]),
5966 width, precision, (isfloat ? (double) GETARG_VECTOR(thisarg)[2] : (double) GETARG_INTVECTOR(thisarg)[2])
5970 if(flags & PRINTF_ALTERNATE)
5972 if(precision < 0) // not set
5973 o += dpsnprintf(o, end - o, formatbuf, width, (isfloat ? (unsigned int) GETARG_FLOAT(thisarg) : (unsigned int) GETARG_INT(thisarg)));
5975 o += dpsnprintf(o, end - o, formatbuf, width, precision, (isfloat ? (unsigned int) GETARG_FLOAT(thisarg) : (unsigned int) GETARG_INT(thisarg)));
5979 unsigned int c = (isfloat ? (unsigned int) GETARG_FLOAT(thisarg) : (unsigned int) GETARG_INT(thisarg));
5981 const char *buf = u8_encodech(c, NULL, charbuf16);
5984 if(precision < 0) // not set
5985 precision = end - o - 1;
5986 o += u8_strpad(o, end - o, buf, (flags & PRINTF_LEFT) != 0, width, precision);
5989 //spike FIXME -- 'S' for quoted tokenize-safe-or-print escaping of strings so stuff can safely survive console commands.
5991 if(flags & PRINTF_ALTERNATE)
5993 if(precision < 0) // not set
5994 o += dpsnprintf(o, end - o, formatbuf, width, GETARG_STRING(thisarg));
5996 o += dpsnprintf(o, end - o, formatbuf, width, precision, GETARG_STRING(thisarg));
6000 if(precision < 0) // not set
6001 precision = end - o - 1;
6002 if(flags & PRINTF_SIGNPOSITIVE)
6003 o += u8_strpad(o, end - o, GETARG_STRING(thisarg), (flags & PRINTF_LEFT) != 0, width, precision);
6005 o += u8_strpad_colorcodes(o, end - o, GETARG_STRING(thisarg), (flags & PRINTF_LEFT) != 0, width, precision);
6009 VM_Warning(prog, "VM_sprintf: invalid directive in %s: %s\n", prog->name, s0);
6025 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, outbuf);
6031 static model_t *getmodel(prvm_prog_t *prog, prvm_edict_t *ed)
6033 if (prog == SVVM_prog)
6034 return SV_GetModelFromEdict(ed);
6035 else if (prog == CLVM_prog)
6036 return CL_GetModelFromEdict(ed);
6041 struct animatemodel_cache
6044 frameblend_t frameblend[MAX_FRAMEBLENDS];
6045 skeleton_t *skeleton_p;
6046 skeleton_t skeleton;
6047 float *data_vertex3f;
6048 float *data_svector3f;
6049 float *data_tvector3f;
6050 float *data_normal3f;
6052 float *buf_vertex3f;
6053 float *buf_svector3f;
6054 float *buf_tvector3f;
6055 float *buf_normal3f;
6058 static void animatemodel_reset(prvm_prog_t *prog)
6060 if (!prog->animatemodel_cache)
6062 if(prog->animatemodel_cache->buf_vertex3f) Mem_Free(prog->animatemodel_cache->buf_vertex3f);
6063 if(prog->animatemodel_cache->buf_svector3f) Mem_Free(prog->animatemodel_cache->buf_svector3f);
6064 if(prog->animatemodel_cache->buf_tvector3f) Mem_Free(prog->animatemodel_cache->buf_tvector3f);
6065 if(prog->animatemodel_cache->buf_normal3f) Mem_Free(prog->animatemodel_cache->buf_normal3f);
6066 Mem_Free(prog->animatemodel_cache);
6069 static void animatemodel(prvm_prog_t *prog, model_t *model, prvm_edict_t *ed)
6071 skeleton_t *skeleton;
6072 int skeletonindex = -1;
6074 struct animatemodel_cache *animatemodel_cache;
6075 if (!prog->animatemodel_cache)
6077 prog->animatemodel_cache = (struct animatemodel_cache *)Mem_Alloc(prog->progs_mempool, sizeof(struct animatemodel_cache));
6078 memset(prog->animatemodel_cache, 0, sizeof(struct animatemodel_cache));
6080 animatemodel_cache = prog->animatemodel_cache;
6081 if(!(model->surfmesh.isanimated && model->AnimateVertices))
6083 animatemodel_cache->data_vertex3f = model->surfmesh.data_vertex3f;
6084 animatemodel_cache->data_svector3f = model->surfmesh.data_svector3f;
6085 animatemodel_cache->data_tvector3f = model->surfmesh.data_tvector3f;
6086 animatemodel_cache->data_normal3f = model->surfmesh.data_normal3f;
6089 need |= (animatemodel_cache->model != model);
6090 VM_GenerateFrameGroupBlend(prog, ed->priv.server->framegroupblend, ed);
6091 VM_FrameBlendFromFrameGroupBlend(ed->priv.server->frameblend, ed->priv.server->framegroupblend, model, PRVM_serverglobalfloat(time));
6092 need |= (memcmp(&animatemodel_cache->frameblend, &ed->priv.server->frameblend, sizeof(ed->priv.server->frameblend))) != 0;
6093 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
6094 if (!(skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones))
6096 need |= (animatemodel_cache->skeleton_p != skeleton);
6098 need |= (memcmp(&animatemodel_cache->skeleton, skeleton, sizeof(ed->priv.server->skeleton))) != 0;
6101 if(model->surfmesh.num_vertices > animatemodel_cache->max_vertices)
6103 animatemodel_cache->max_vertices = model->surfmesh.num_vertices * 2;
6104 if(animatemodel_cache->buf_vertex3f) Mem_Free(animatemodel_cache->buf_vertex3f);
6105 if(animatemodel_cache->buf_svector3f) Mem_Free(animatemodel_cache->buf_svector3f);
6106 if(animatemodel_cache->buf_tvector3f) Mem_Free(animatemodel_cache->buf_tvector3f);
6107 if(animatemodel_cache->buf_normal3f) Mem_Free(animatemodel_cache->buf_normal3f);
6108 animatemodel_cache->buf_vertex3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6109 animatemodel_cache->buf_svector3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6110 animatemodel_cache->buf_tvector3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6111 animatemodel_cache->buf_normal3f = (float *)Mem_Alloc(prog->progs_mempool, sizeof(float[3]) * animatemodel_cache->max_vertices);
6113 animatemodel_cache->data_vertex3f = animatemodel_cache->buf_vertex3f;
6114 animatemodel_cache->data_svector3f = animatemodel_cache->buf_svector3f;
6115 animatemodel_cache->data_tvector3f = animatemodel_cache->buf_tvector3f;
6116 animatemodel_cache->data_normal3f = animatemodel_cache->buf_normal3f;
6117 VM_UpdateEdictSkeleton(prog, ed, model, ed->priv.server->frameblend);
6118 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);
6119 animatemodel_cache->model = model;
6120 memcpy(&animatemodel_cache->frameblend, &ed->priv.server->frameblend, sizeof(ed->priv.server->frameblend));
6121 animatemodel_cache->skeleton_p = skeleton;
6123 memcpy(&animatemodel_cache->skeleton, skeleton, sizeof(ed->priv.server->skeleton));
6126 static void getmatrix(prvm_prog_t *prog, prvm_edict_t *ed, matrix4x4_t *out)
6128 if (prog == SVVM_prog)
6129 SV_GetEntityMatrix(prog, ed, out, false);
6130 else if (prog == CLVM_prog)
6131 CL_GetEntityMatrix(prog, ed, out, false);
6133 *out = identitymatrix;
6136 static void applytransform_forward(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6139 getmatrix(prog, ed, &m);
6140 Matrix4x4_Transform(&m, in, out);
6143 static void applytransform_forward_direction(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6146 getmatrix(prog, ed, &m);
6147 Matrix4x4_Transform3x3(&m, in, out);
6150 static void applytransform_inverted(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6153 getmatrix(prog, ed, &m);
6154 Matrix4x4_Invert_Full(&n, &m);
6155 Matrix4x4_Transform3x3(&n, in, out);
6158 static void applytransform_forward_normal(prvm_prog_t *prog, const vec3_t in, prvm_edict_t *ed, vec3_t out)
6162 getmatrix(prog, ed, &m);
6163 Matrix4x4_TransformPositivePlane(&m, in[0], in[1], in[2], 0, p);
6167 static void clippointtosurface(prvm_prog_t *prog, prvm_edict_t *ed, model_t *model, msurface_t *surface, vec3_t p, vec3_t out)
6170 float *v[3], facenormal[3], edgenormal[3], sidenormal[3], temp[3], offsetdist, dist, bestdist;
6172 animatemodel(prog, model, ed);
6173 bestdist = 1000000000;
6175 for (i = 0, e = (model->surfmesh.data_element3i + 3 * surface->num_firsttriangle);i < surface->num_triangles;i++, e += 3)
6177 // clip original point to each triangle of the surface and find the
6178 // triangle that is closest
6179 v[0] = prog->animatemodel_cache->data_vertex3f + e[0] * 3;
6180 v[1] = prog->animatemodel_cache->data_vertex3f + e[1] * 3;
6181 v[2] = prog->animatemodel_cache->data_vertex3f + e[2] * 3;
6182 TriangleNormal(v[0], v[1], v[2], facenormal);
6183 VectorNormalize(facenormal);
6184 offsetdist = DotProduct(v[0], facenormal) - DotProduct(p, facenormal);
6185 VectorMA(p, offsetdist, facenormal, temp);
6186 for (j = 0, k = 2;j < 3;k = j, j++)
6188 VectorSubtract(v[k], v[j], edgenormal);
6189 CrossProduct(edgenormal, facenormal, sidenormal);
6190 VectorNormalize(sidenormal);
6191 offsetdist = DotProduct(v[k], sidenormal) - DotProduct(temp, sidenormal);
6193 VectorMA(temp, offsetdist, sidenormal, temp);
6195 dist = VectorDistance2(temp, p);
6196 if (bestdist > dist)
6199 VectorCopy(temp, out);
6204 static msurface_t *getsurface(model_t *model, int surfacenum)
6206 if (surfacenum < 0 || surfacenum >= model->submodelsurfaces_end - model->submodelsurfaces_start)
6208 return model->data_surfaces + surfacenum + model->submodelsurfaces_start;
6212 //PF_getsurfacenumpoints, // #434 float(entity e, float s) getsurfacenumpoints = #434;
6213 void VM_getsurfacenumpoints(prvm_prog_t *prog)
6216 msurface_t *surface;
6217 VM_SAFEPARMCOUNT(2, VM_getsurfacenumpoints);
6218 // return 0 if no such surface
6219 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6221 PRVM_G_FLOAT(OFS_RETURN) = 0;
6225 // note: this (incorrectly) assumes it is a simple polygon
6226 PRVM_G_FLOAT(OFS_RETURN) = surface->num_vertices;
6228 //PF_getsurfacepoint, // #435 vector(entity e, float s, float n) getsurfacepoint = #435;
6229 void VM_getsurfacepoint(prvm_prog_t *prog)
6233 msurface_t *surface;
6236 VM_SAFEPARMCOUNT(3, VM_getsurfacepoint);
6237 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6238 ed = PRVM_G_EDICT(OFS_PARM0);
6239 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6241 // note: this (incorrectly) assumes it is a simple polygon
6242 pointnum = (int)PRVM_G_FLOAT(OFS_PARM2);
6243 if (pointnum < 0 || pointnum >= surface->num_vertices)
6245 animatemodel(prog, model, ed);
6246 applytransform_forward(prog, &(prog->animatemodel_cache->data_vertex3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6247 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6249 //PF_getsurfacepointattribute, // #486 vector(entity e, float s, float n, float a) getsurfacepointattribute = #486;
6250 // float SPA_POSITION = 0;
6251 // float SPA_S_AXIS = 1;
6252 // float SPA_T_AXIS = 2;
6253 // float SPA_R_AXIS = 3; // same as SPA_NORMAL
6254 // float SPA_TEXCOORDS0 = 4;
6255 // float SPA_LIGHTMAP0_TEXCOORDS = 5;
6256 // float SPA_LIGHTMAP0_COLOR = 6;
6257 void VM_getsurfacepointattribute(prvm_prog_t *prog)
6261 msurface_t *surface;
6266 VM_SAFEPARMCOUNT(4, VM_getsurfacepointattribute);
6267 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6268 ed = PRVM_G_EDICT(OFS_PARM0);
6269 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6271 pointnum = (int)PRVM_G_FLOAT(OFS_PARM2);
6272 if (pointnum < 0 || pointnum >= surface->num_vertices)
6274 attributetype = (int) PRVM_G_FLOAT(OFS_PARM3);
6276 animatemodel(prog, model, ed);
6278 switch( attributetype ) {
6279 // float SPA_POSITION = 0;
6281 applytransform_forward(prog, &(prog->animatemodel_cache->data_vertex3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6282 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6284 // float SPA_S_AXIS = 1;
6286 applytransform_forward_direction(prog, &(prog->animatemodel_cache->data_svector3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6287 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6289 // float SPA_T_AXIS = 2;
6291 applytransform_forward_direction(prog, &(prog->animatemodel_cache->data_tvector3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6292 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6294 // float SPA_R_AXIS = 3; // same as SPA_NORMAL
6296 applytransform_forward_direction(prog, &(prog->animatemodel_cache->data_normal3f + 3 * surface->num_firstvertex)[pointnum * 3], ed, result);
6297 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6299 // float SPA_TEXCOORDS0 = 4;
6301 float *texcoord = &(model->surfmesh.data_texcoordtexture2f + 2 * surface->num_firstvertex)[pointnum * 2];
6302 result[0] = texcoord[0];
6303 result[1] = texcoord[1];
6305 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6308 // float SPA_LIGHTMAP0_TEXCOORDS = 5;
6310 float *texcoord = &(model->surfmesh.data_texcoordlightmap2f + 2 * surface->num_firstvertex)[pointnum * 2];
6311 result[0] = texcoord[0];
6312 result[1] = texcoord[1];
6314 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6317 // float SPA_LIGHTMAP0_COLOR = 6;
6319 // ignore alpha for now..
6320 VectorCopy( &(model->surfmesh.data_lightmapcolor4f + 4 * surface->num_firstvertex)[pointnum * 4], PRVM_G_VECTOR(OFS_RETURN));
6323 VectorSet( PRVM_G_VECTOR(OFS_RETURN), 0.0f, 0.0f, 0.0f );
6327 //PF_getsurfacenormal, // #436 vector(entity e, float s) getsurfacenormal = #436;
6328 void VM_getsurfacenormal(prvm_prog_t *prog)
6331 msurface_t *surface;
6334 VM_SAFEPARMCOUNT(2, VM_getsurfacenormal);
6335 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6336 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6338 // note: this only returns the first triangle, so it doesn't work very
6339 // well for curved surfaces or arbitrary meshes
6340 animatemodel(prog, model, PRVM_G_EDICT(OFS_PARM0));
6341 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);
6342 applytransform_forward_normal(prog, normal, PRVM_G_EDICT(OFS_PARM0), result);
6343 VectorNormalize(result);
6344 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
6346 //PF_getsurfacetexture, // #437 string(entity e, float s) getsurfacetexture = #437;
6347 void VM_getsurfacetexture(prvm_prog_t *prog)
6350 msurface_t *surface;
6351 VM_SAFEPARMCOUNT(2, VM_getsurfacetexture);
6352 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
6353 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6355 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, surface->texture->name);
6357 //PF_getsurfacenearpoint, // #438 float(entity e, vector p) getsurfacenearpoint = #438;
6358 void VM_getsurfacenearpoint(prvm_prog_t *prog)
6360 int surfacenum, best;
6362 vec_t dist, bestdist;
6365 msurface_t *surface;
6367 VM_SAFEPARMCOUNT(2, VM_getsurfacenearpoint);
6368 PRVM_G_FLOAT(OFS_RETURN) = -1;
6369 ed = PRVM_G_EDICT(OFS_PARM0);
6370 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), point);
6372 if (!ed || ed->free)
6374 model = getmodel(prog, ed);
6375 if (!model || !model->num_surfaces)
6378 animatemodel(prog, model, ed);
6380 applytransform_inverted(prog, point, ed, p);
6382 bestdist = 1000000000;
6383 for (surfacenum = model->submodelsurfaces_start;surfacenum < model->submodelsurfaces_end;surfacenum++)
6385 surface = model->data_surfaces + surfacenum;
6386 // first see if the nearest point on the surface's box is closer than the previous match
6387 clipped[0] = bound(surface->mins[0], p[0], surface->maxs[0]) - p[0];
6388 clipped[1] = bound(surface->mins[1], p[1], surface->maxs[1]) - p[1];
6389 clipped[2] = bound(surface->mins[2], p[2], surface->maxs[2]) - p[2];
6390 dist = VectorLength2(clipped);
6391 if (dist < bestdist)
6393 // it is, check the nearest point on the actual geometry
6394 clippointtosurface(prog, ed, model, surface, p, clipped);
6395 VectorSubtract(clipped, p, clipped);
6396 dist += VectorLength2(clipped);
6397 if (dist < bestdist)
6399 // that's closer too, store it as the best match
6400 best = surfacenum - model->submodelsurfaces_start;
6405 PRVM_G_FLOAT(OFS_RETURN) = best;
6407 //PF_getsurfaceclippedpoint, // #439 vector(entity e, float s, vector p) getsurfaceclippedpoint = #439;
6408 void VM_getsurfaceclippedpoint(prvm_prog_t *prog)
6412 msurface_t *surface;
6414 VM_SAFEPARMCOUNT(3, VM_getsurfaceclippedpoint);
6415 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6416 ed = PRVM_G_EDICT(OFS_PARM0);
6417 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6419 animatemodel(prog, model, ed);
6420 VectorCopy(PRVM_G_VECTOR(OFS_PARM2), inp);
6421 applytransform_inverted(prog, inp, ed, p);
6422 clippointtosurface(prog, ed, model, surface, p, out);
6423 VectorAdd(out, PRVM_serveredictvector(ed, origin), PRVM_G_VECTOR(OFS_RETURN));
6426 //PF_getsurfacenumtriangles, // #??? float(entity e, float s) getsurfacenumtriangles = #???;
6427 void VM_getsurfacenumtriangles(prvm_prog_t *prog)
6430 msurface_t *surface;
6431 VM_SAFEPARMCOUNT(2, VM_getsurfacenumtriangles);
6432 // return 0 if no such surface
6433 if (!(model = getmodel(prog, PRVM_G_EDICT(OFS_PARM0))) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6435 PRVM_G_FLOAT(OFS_RETURN) = 0;
6439 PRVM_G_FLOAT(OFS_RETURN) = surface->num_triangles;
6441 //PF_getsurfacetriangle, // #??? vector(entity e, float s, float n) getsurfacetriangle = #???;
6442 void VM_getsurfacetriangle(prvm_prog_t *prog)
6444 const vec3_t d = {-1, -1, -1};
6447 msurface_t *surface;
6449 VM_SAFEPARMCOUNT(3, VM_getsurfacetriangle);
6450 VectorClear(PRVM_G_VECTOR(OFS_RETURN));
6451 ed = PRVM_G_EDICT(OFS_PARM0);
6452 if (!(model = getmodel(prog, ed)) || !(surface = getsurface(model, (int)PRVM_G_FLOAT(OFS_PARM1))))
6454 trinum = (int)PRVM_G_FLOAT(OFS_PARM2);
6455 if (trinum < 0 || trinum >= surface->num_triangles)
6457 // FIXME: implement rotation/scaling
6458 VectorMA(&(model->surfmesh.data_element3i + 3 * surface->num_firsttriangle)[trinum * 3], surface->num_firstvertex, d, PRVM_G_VECTOR(OFS_RETURN));
6466 #define VM_physics_ApplyCmd(ed,f) if (!ed->priv.server->ode_body) VM_physics_newstackfunction(prog, ed, f); else World_Physics_ApplyCmd(ed, f)
6468 static edict_odefunc_t *VM_physics_newstackfunction(prvm_prog_t *prog, prvm_edict_t *ed, edict_odefunc_t *f)
6470 edict_odefunc_t *newfunc, *func;
6472 newfunc = (edict_odefunc_t *)Mem_Alloc(prog->progs_mempool, sizeof(edict_odefunc_t));
6473 memcpy(newfunc, f, sizeof(edict_odefunc_t));
6474 newfunc->next = NULL;
6475 if (!ed->priv.server->ode_func)
6476 ed->priv.server->ode_func = newfunc;
6479 for (func = ed->priv.server->ode_func; func->next; func = func->next);
6480 func->next = newfunc;
6486 // void(entity e, float physics_enabled) physics_enable = #;
6487 void VM_physics_enable(prvm_prog_t *prog)
6493 VM_SAFEPARMCOUNT(2, VM_physics_enable);
6495 ed = PRVM_G_EDICT(OFS_PARM0);
6498 if (developer.integer > 0)
6499 VM_Warning(prog, "VM_physics_enable: null entity!\n");
6502 // entity should have MOVETYPE_PHYSICS already set, this can damage memory (making leaked allocation) so warn about this even if non-developer
6503 if (PRVM_serveredictfloat(ed, movetype) != MOVETYPE_PHYSICS)
6505 VM_Warning(prog, "VM_physics_enable: entity is not MOVETYPE_PHYSICS!\n");
6508 f.type = PRVM_G_FLOAT(OFS_PARM1) == 0 ? ODEFUNC_DISABLE : ODEFUNC_ENABLE;
6509 VM_physics_ApplyCmd(ed, &f);
6513 // void(entity e, vector force, vector relative_ofs) physics_addforce = #;
6514 void VM_physics_addforce(prvm_prog_t *prog)
6520 VM_SAFEPARMCOUNT(3, VM_physics_addforce);
6522 ed = PRVM_G_EDICT(OFS_PARM0);
6525 if (developer.integer > 0)
6526 VM_Warning(prog, "VM_physics_addforce: null entity!\n");
6529 // entity should have MOVETYPE_PHYSICS already set, this can damage memory (making leaked allocation) so warn about this even if non-developer
6530 if (PRVM_serveredictfloat(ed, movetype) != MOVETYPE_PHYSICS)
6532 VM_Warning(prog, "VM_physics_addforce: entity is not MOVETYPE_PHYSICS!\n");
6535 f.type = ODEFUNC_FORCE;
6536 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), f.v1);
6537 VectorCopy(PRVM_G_VECTOR(OFS_PARM2), f.v2);
6538 VM_physics_ApplyCmd(ed, &f);
6542 // void(entity e, vector torque) physics_addtorque = #;
6543 void VM_physics_addtorque(prvm_prog_t *prog)
6549 VM_SAFEPARMCOUNT(2, VM_physics_addtorque);
6551 ed = PRVM_G_EDICT(OFS_PARM0);
6554 if (developer.integer > 0)
6555 VM_Warning(prog, "VM_physics_addtorque: null entity!\n");
6558 // entity should have MOVETYPE_PHYSICS already set, this can damage memory (making leaked allocation) so warn about this even if non-developer
6559 if (PRVM_serveredictfloat(ed, movetype) != MOVETYPE_PHYSICS)
6561 VM_Warning(prog, "VM_physics_addtorque: entity is not MOVETYPE_PHYSICS!\n");
6564 f.type = ODEFUNC_TORQUE;
6565 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), f.v1);
6566 VM_physics_ApplyCmd(ed, &f);
6570 extern cvar_t prvm_coverage;
6571 void VM_coverage(prvm_prog_t *prog)
6573 VM_SAFEPARMCOUNT(0, VM_coverage);
6574 if (prog->explicit_profile[prog->xstatement]++ == 0 && (prvm_coverage.integer & 2))
6575 PRVM_ExplicitCoverageEvent(prog, prog->xfunction, prog->xstatement);