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 // LordHavoc: changed this to NOT use a return statement, so that it can be used in functions that must return a value
22 void VM_Warning(prvm_prog_t *prog, const char *fmt, ...)
25 char msg[MAX_INPUTLINE];
26 static double recursive = -1;
29 dpvsnprintf(msg,sizeof(msg),fmt,argptr);
34 // TODO: either add a cvar/cmd to control the state dumping or replace some of the calls with Con_Printf [9/13/2006 Black]
35 if(prvm_backtraceforwarnings.integer && recursive != realtime) // NOTE: this compares to the time, just in case if PRVM_PrintState causes a Host_Error and keeps recursive set
38 PRVM_PrintState(prog);
44 //============================================================================
47 // TODO DONE: move vm_files and vm_fssearchlist to prvm_prog_t struct
48 // TODO: move vm_files and vm_fssearchlist back [9/13/2006 Black]
49 // TODO: (move vm_files and vm_fssearchlist to prvm_prog_t struct again) [2007-01-23 LordHavoc]
50 // TODO: will this war ever end? [2007-01-23 LordHavoc]
52 void VM_CheckEmptyString(prvm_prog_t *prog, const char *s)
54 if (ISWHITESPACE(s[0]))
55 prog->error_cmd("%s: Bad string", prog->name);
58 void VM_GenerateFrameGroupBlend(prvm_prog_t *prog, framegroupblend_t *framegroupblend, const prvm_edict_t *ed)
60 // self.frame is the interpolation target (new frame)
61 // self.frame1time is the animation base time for the interpolation target
62 // self.frame2 is the interpolation start (previous frame)
63 // self.frame2time is the animation base time for the interpolation start
64 // self.lerpfrac is the interpolation strength for self.frame2
65 // self.lerpfrac3 is the interpolation strength for self.frame3
66 // self.lerpfrac4 is the interpolation strength for self.frame4
67 // pitch angle on a player model where the animator set up 5 sets of
68 // animations and the csqc simply lerps between sets)
69 framegroupblend[0].frame = (int) PRVM_gameedictfloat(ed, frame );
70 framegroupblend[1].frame = (int) PRVM_gameedictfloat(ed, frame2 );
71 framegroupblend[2].frame = (int) PRVM_gameedictfloat(ed, frame3 );
72 framegroupblend[3].frame = (int) PRVM_gameedictfloat(ed, frame4 );
73 framegroupblend[0].start = PRVM_gameedictfloat(ed, frame1time);
74 framegroupblend[1].start = PRVM_gameedictfloat(ed, frame2time);
75 framegroupblend[2].start = PRVM_gameedictfloat(ed, frame3time);
76 framegroupblend[3].start = PRVM_gameedictfloat(ed, frame4time);
77 framegroupblend[1].lerp = PRVM_gameedictfloat(ed, lerpfrac );
78 framegroupblend[2].lerp = PRVM_gameedictfloat(ed, lerpfrac3 );
79 framegroupblend[3].lerp = PRVM_gameedictfloat(ed, lerpfrac4 );
80 // assume that the (missing) lerpfrac1 is whatever remains after lerpfrac2+lerpfrac3+lerpfrac4 are summed
81 framegroupblend[0].lerp = 1 - framegroupblend[1].lerp - framegroupblend[2].lerp - framegroupblend[3].lerp;
84 // LordHavoc: quite tempting to break apart this function to reuse the
85 // duplicated code, but I suspect it is better for performance
87 void VM_FrameBlendFromFrameGroupBlend(frameblend_t *frameblend, const framegroupblend_t *framegroupblend, const dp_model_t *model)
89 int sub2, numframes, f, i, k;
90 int isfirstframegroup = true;
92 double sublerp, lerp, d;
93 const animscene_t *scene;
94 const framegroupblend_t *g;
95 frameblend_t *blend = frameblend;
97 memset(blend, 0, MAX_FRAMEBLENDS * sizeof(*blend));
99 if (!model || !model->surfmesh.isanimated)
105 nolerp = (model->type == mod_sprite) ? !r_lerpsprites.integer : !r_lerpmodels.integer;
106 numframes = model->numframes;
107 for (k = 0, g = framegroupblend;k < MAX_FRAMEGROUPBLENDS;k++, g++)
110 if ((unsigned int)f >= (unsigned int)numframes)
112 Con_DPrintf("VM_FrameBlendFromFrameGroupBlend: no such frame %d in model %s\n", f, model->name);
120 if (isfirstframegroup)
123 isfirstframegroup = false;
128 if (model->animscenes)
130 scene = model->animscenes + f;
131 f = scene->firstframe;
132 if (scene->framecount > 1)
134 // this code path is only used on .zym models and torches
135 sublerp = scene->framerate * (cl.time - g->start);
136 f = (int) floor(sublerp);
139 if (sublerp < (1.0 / 65536.0f))
141 if (sublerp > (65535.0f / 65536.0f))
147 f = (f % scene->framecount);
148 sub2 = (sub2 % scene->framecount);
150 f = bound(0, f, (scene->framecount - 1)) + scene->firstframe;
151 sub2 = bound(0, sub2, (scene->framecount - 1)) + scene->firstframe;
153 // two framelerps produced from one animation
156 for (i = 0;i < MAX_FRAMEBLENDS;i++)
158 if (blend[i].lerp <= 0 || blend[i].subframe == sub2)
160 blend[i].subframe = sub2;
166 d = (1 - sublerp) * lerp;
171 for (i = 0;i < MAX_FRAMEBLENDS;i++)
173 if (blend[i].lerp <= 0 || blend[i].subframe == f)
175 blend[i].subframe = f;
184 void VM_UpdateEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed, const dp_model_t *edmodel, const frameblend_t *frameblend)
186 if (ed->priv.server->skeleton.model != edmodel)
188 VM_RemoveEdictSkeleton(prog, ed);
189 ed->priv.server->skeleton.model = edmodel;
191 if (!ed->priv.server->skeleton.model || !ed->priv.server->skeleton.model->num_bones)
193 if(ed->priv.server->skeleton.relativetransforms)
194 Mem_Free(ed->priv.server->skeleton.relativetransforms);
195 ed->priv.server->skeleton.relativetransforms = NULL;
200 int skeletonindex = -1;
201 skeleton_t *skeleton;
202 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
203 if (skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones)
205 // custom skeleton controlled by the game (FTE_CSQC_SKELETONOBJECTS)
206 if (!ed->priv.server->skeleton.relativetransforms)
207 ed->priv.server->skeleton.relativetransforms = (matrix4x4_t *)Mem_Alloc(prog->progs_mempool, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
208 memcpy(ed->priv.server->skeleton.relativetransforms, skeleton->relativetransforms, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
212 if(ed->priv.server->skeleton.relativetransforms)
213 Mem_Free(ed->priv.server->skeleton.relativetransforms);
214 ed->priv.server->skeleton.relativetransforms = NULL;
219 void VM_RemoveEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed)
221 if (ed->priv.server->skeleton.relativetransforms)
222 Mem_Free(ed->priv.server->skeleton.relativetransforms);
223 memset(&ed->priv.server->skeleton, 0, sizeof(ed->priv.server->skeleton));
229 //============================================================================
232 void VM_VarString(prvm_prog_t *prog, int first, char *out, int outlength)
238 outend = out + outlength - 1;
239 for (i = first;i < prog->argc && out < outend;i++)
241 s = PRVM_G_STRING((OFS_PARM0+i*3));
242 while (out < outend && *s)
252 returns true if the extension is supported by the server
254 checkextension(extensionname)
258 // kind of helper function
259 static qboolean checkextension(prvm_prog_t *prog, const char *name)
262 const char *e, *start;
263 len = (int)strlen(name);
265 for (e = prog->extensionstring;*e;e++)
272 while (*e && *e != ' ')
274 if ((e - start) == len && !strncasecmp(start, name, len))
276 // special sheck for ODE
277 if (!strncasecmp("DP_PHYSICS_ODE", name, 14))
280 return ode_dll ? true : false;
286 // special sheck for d0_blind_id
287 if (!strcasecmp("DP_CRYPTO", name))
288 return Crypto_Available();
289 if (!strcasecmp("DP_QC_DIGEST_SHA256", name))
290 return Crypto_Available();
298 void VM_checkextension(prvm_prog_t *prog)
300 VM_SAFEPARMCOUNT(1,VM_checkextension);
302 PRVM_G_FLOAT(OFS_RETURN) = checkextension(prog, PRVM_G_STRING(OFS_PARM0));
309 This is a TERMINAL error, which will kill off the entire prog.
315 void VM_error(prvm_prog_t *prog)
318 char string[VM_STRINGTEMP_LENGTH];
320 VM_VarString(prog, 0, string, sizeof(string));
321 Con_Printf("======%s ERROR in %s:\n%s\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
322 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
323 PRVM_ED_Print(prog, ed, NULL);
325 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);
332 Dumps out self, then an error message. The program is aborted and self is
333 removed, but the level can continue.
338 void VM_objerror(prvm_prog_t *prog)
341 char string[VM_STRINGTEMP_LENGTH];
343 VM_VarString(prog, 0, string, sizeof(string));
344 Con_Printf("======OBJECT ERROR======\n"); // , prog->name, PRVM_GetString(prog->xfunction->s_name), string); // or include them? FIXME
345 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
346 PRVM_ED_Print(prog, ed, NULL);
347 PRVM_ED_Free (prog, ed);
348 Con_Printf("%s OBJECT ERROR in %s:\n%s\nTip: read above for entity information\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
360 void VM_print(prvm_prog_t *prog)
362 char string[VM_STRINGTEMP_LENGTH];
364 VM_VarString(prog, 0, string, sizeof(string));
372 broadcast print to everyone on server
377 void VM_bprint(prvm_prog_t *prog)
379 char string[VM_STRINGTEMP_LENGTH];
383 VM_Warning(prog, "VM_bprint: game is not server(%s) !\n", prog->name);
387 VM_VarString(prog, 0, string, sizeof(string));
388 SV_BroadcastPrint(string);
393 VM_sprint (menu & client but only if server.active == true)
395 single print to a specific client
397 sprint(float clientnum,...[string])
400 void VM_sprint(prvm_prog_t *prog)
404 char string[VM_STRINGTEMP_LENGTH];
406 VM_SAFEPARMCOUNTRANGE(1, 8, VM_sprint);
408 //find client for this entity
409 clientnum = (int)PRVM_G_FLOAT(OFS_PARM0);
410 if (!sv.active || clientnum < 0 || clientnum >= svs.maxclients || !svs.clients[clientnum].active)
412 VM_Warning(prog, "VM_sprint: %s: invalid client or server is not active !\n", prog->name);
416 client = svs.clients + clientnum;
417 if (!client->netconnection)
420 VM_VarString(prog, 1, string, sizeof(string));
421 MSG_WriteChar(&client->netconnection->message,svc_print);
422 MSG_WriteString(&client->netconnection->message, string);
429 single print to the screen
434 void VM_centerprint(prvm_prog_t *prog)
436 char string[VM_STRINGTEMP_LENGTH];
438 VM_SAFEPARMCOUNTRANGE(1, 8, VM_centerprint);
439 VM_VarString(prog, 0, string, sizeof(string));
440 SCR_CenterPrint(string);
447 vector normalize(vector)
450 void VM_normalize(prvm_prog_t *prog)
456 VM_SAFEPARMCOUNT(1,VM_normalize);
458 value1 = PRVM_G_VECTOR(OFS_PARM0);
460 f = VectorLength2(value1);
464 VectorScale(value1, f, newvalue);
467 VectorClear(newvalue);
469 VectorCopy (newvalue, PRVM_G_VECTOR(OFS_RETURN));
479 void VM_vlen(prvm_prog_t *prog)
481 VM_SAFEPARMCOUNT(1,VM_vlen);
482 PRVM_G_FLOAT(OFS_RETURN) = VectorLength(PRVM_G_VECTOR(OFS_PARM0));
489 float vectoyaw(vector)
492 void VM_vectoyaw(prvm_prog_t *prog)
497 VM_SAFEPARMCOUNT(1,VM_vectoyaw);
499 value1 = PRVM_G_VECTOR(OFS_PARM0);
501 if (value1[1] == 0 && value1[0] == 0)
505 yaw = (int) (atan2(value1[1], value1[0]) * 180 / M_PI);
510 PRVM_G_FLOAT(OFS_RETURN) = yaw;
518 vector vectoangles(vector[, vector])
521 void VM_vectoangles(prvm_prog_t *prog)
523 VM_SAFEPARMCOUNTRANGE(1, 2,VM_vectoangles);
525 AnglesFromVectors(PRVM_G_VECTOR(OFS_RETURN), PRVM_G_VECTOR(OFS_PARM0), prog->argc >= 2 ? PRVM_G_VECTOR(OFS_PARM1) : NULL, true);
532 Returns a number from 0<= num < 1
537 void VM_random(prvm_prog_t *prog)
539 VM_SAFEPARMCOUNT(0,VM_random);
541 PRVM_G_FLOAT(OFS_RETURN) = lhrandom(0, 1);
548 localsound(string sample)
551 void VM_localsound(prvm_prog_t *prog)
555 VM_SAFEPARMCOUNT(1,VM_localsound);
557 s = PRVM_G_STRING(OFS_PARM0);
559 if(!S_LocalSound (s))
561 PRVM_G_FLOAT(OFS_RETURN) = -4;
562 VM_Warning(prog, "VM_localsound: Failed to play %s for %s !\n", s, prog->name);
566 PRVM_G_FLOAT(OFS_RETURN) = 1;
576 void VM_break(prvm_prog_t *prog)
578 prog->error_cmd("%s: break statement", prog->name);
581 //============================================================================
587 Sends text over to the client's execution buffer
589 [localcmd (string, ...) or]
593 void VM_localcmd(prvm_prog_t *prog)
595 char string[VM_STRINGTEMP_LENGTH];
596 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd);
597 VM_VarString(prog, 0, string, sizeof(string));
598 Cbuf_AddText(string);
601 static qboolean PRVM_Cvar_ReadOk(const char *string)
604 cvar = Cvar_FindVar(string);
605 return ((cvar) && ((cvar->flags & CVAR_PRIVATE) == 0));
615 void VM_cvar(prvm_prog_t *prog)
617 char string[VM_STRINGTEMP_LENGTH];
618 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
619 VM_VarString(prog, 0, string, sizeof(string));
620 VM_CheckEmptyString(prog, string);
621 PRVM_G_FLOAT(OFS_RETURN) = PRVM_Cvar_ReadOk(string) ? Cvar_VariableValue(string) : 0;
628 float cvar_type (string)
629 float CVAR_TYPEFLAG_EXISTS = 1;
630 float CVAR_TYPEFLAG_SAVED = 2;
631 float CVAR_TYPEFLAG_PRIVATE = 4;
632 float CVAR_TYPEFLAG_ENGINE = 8;
633 float CVAR_TYPEFLAG_HASDESCRIPTION = 16;
634 float CVAR_TYPEFLAG_READONLY = 32;
637 void VM_cvar_type(prvm_prog_t *prog)
639 char string[VM_STRINGTEMP_LENGTH];
643 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
644 VM_VarString(prog, 0, string, sizeof(string));
645 VM_CheckEmptyString(prog, string);
646 cvar = Cvar_FindVar(string);
651 PRVM_G_FLOAT(OFS_RETURN) = 0;
652 return; // CVAR_TYPE_NONE
655 ret = 1; // CVAR_EXISTS
656 if(cvar->flags & CVAR_SAVE)
657 ret |= 2; // CVAR_TYPE_SAVED
658 if(cvar->flags & CVAR_PRIVATE)
659 ret |= 4; // CVAR_TYPE_PRIVATE
660 if(!(cvar->flags & CVAR_ALLOCATED))
661 ret |= 8; // CVAR_TYPE_ENGINE
662 if(cvar->description != cvar_dummy_description)
663 ret |= 16; // CVAR_TYPE_HASDESCRIPTION
664 if(cvar->flags & CVAR_READONLY)
665 ret |= 32; // CVAR_TYPE_READONLY
667 PRVM_G_FLOAT(OFS_RETURN) = ret;
674 const string VM_cvar_string (string, ...)
677 void VM_cvar_string(prvm_prog_t *prog)
679 char string[VM_STRINGTEMP_LENGTH];
680 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_string);
681 VM_VarString(prog, 0, string, sizeof(string));
682 VM_CheckEmptyString(prog, string);
683 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_Cvar_ReadOk(string) ? Cvar_VariableString(string) : "");
688 ========================
691 const string VM_cvar_defstring (string, ...)
692 ========================
694 void VM_cvar_defstring(prvm_prog_t *prog)
696 char string[VM_STRINGTEMP_LENGTH];
697 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_defstring);
698 VM_VarString(prog, 0, string, sizeof(string));
699 VM_CheckEmptyString(prog, string);
700 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDefString(string));
704 ========================
707 const string VM_cvar_description (string, ...)
708 ========================
710 void VM_cvar_description(prvm_prog_t *prog)
712 char string[VM_STRINGTEMP_LENGTH];
713 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_description);
714 VM_VarString(prog, 0, string, sizeof(string));
715 VM_CheckEmptyString(prog, string);
716 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDescription(string));
722 void cvar_set (string,string, ...)
725 void VM_cvar_set(prvm_prog_t *prog)
728 char string[VM_STRINGTEMP_LENGTH];
729 VM_SAFEPARMCOUNTRANGE(2,8,VM_cvar_set);
730 VM_VarString(prog, 1, string, sizeof(string));
731 name = PRVM_G_STRING(OFS_PARM0);
732 VM_CheckEmptyString(prog, name);
733 Cvar_Set(name, string);
743 void VM_dprint(prvm_prog_t *prog)
745 char string[VM_STRINGTEMP_LENGTH];
746 VM_SAFEPARMCOUNTRANGE(1, 8, VM_dprint);
747 VM_VarString(prog, 0, string, sizeof(string));
749 Con_DPrintf("%s", string);
751 Con_DPrintf("%s: %s", prog->name, string);
763 void VM_ftos(prvm_prog_t *prog)
768 VM_SAFEPARMCOUNT(1, VM_ftos);
770 v = PRVM_G_FLOAT(OFS_PARM0);
772 if ((float)((int)v) == v)
773 dpsnprintf(s, sizeof(s), "%i", (int)v);
775 dpsnprintf(s, sizeof(s), "%f", v);
776 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
787 void VM_fabs(prvm_prog_t *prog)
791 VM_SAFEPARMCOUNT(1,VM_fabs);
793 v = PRVM_G_FLOAT(OFS_PARM0);
794 PRVM_G_FLOAT(OFS_RETURN) = fabs(v);
805 void VM_vtos(prvm_prog_t *prog)
809 VM_SAFEPARMCOUNT(1,VM_vtos);
811 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]);
812 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
823 void VM_etos(prvm_prog_t *prog)
827 VM_SAFEPARMCOUNT(1, VM_etos);
829 dpsnprintf (s, sizeof(s), "entity %i", PRVM_G_EDICTNUM(OFS_PARM0));
830 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
837 float stof(...[string])
840 void VM_stof(prvm_prog_t *prog)
842 char string[VM_STRINGTEMP_LENGTH];
843 VM_SAFEPARMCOUNTRANGE(1, 8, VM_stof);
844 VM_VarString(prog, 0, string, sizeof(string));
845 PRVM_G_FLOAT(OFS_RETURN) = atof(string);
849 ========================
853 ========================
855 void VM_itof(prvm_prog_t *prog)
857 VM_SAFEPARMCOUNT(1, VM_itof);
858 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
862 ========================
865 entity ftoe(float num)
866 ========================
868 void VM_ftoe(prvm_prog_t *prog)
871 VM_SAFEPARMCOUNT(1, VM_ftoe);
873 ent = (int)PRVM_G_FLOAT(OFS_PARM0);
874 if (ent < 0 || ent >= prog->max_edicts || PRVM_PROG_TO_EDICT(ent)->priv.required->free)
875 ent = 0; // return world instead of a free or invalid entity
877 PRVM_G_INT(OFS_RETURN) = ent;
881 ========================
884 float etof(entity ent)
885 ========================
887 void VM_etof(prvm_prog_t *prog)
889 VM_SAFEPARMCOUNT(1, VM_etof);
890 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICTNUM(OFS_PARM0);
897 string strftime(float uselocaltime, string[, string ...])
900 void VM_strftime(prvm_prog_t *prog)
909 char fmt[VM_STRINGTEMP_LENGTH];
910 char result[VM_STRINGTEMP_LENGTH];
911 VM_SAFEPARMCOUNTRANGE(2, 8, VM_strftime);
912 VM_VarString(prog, 1, fmt, sizeof(fmt));
915 if (PRVM_G_FLOAT(OFS_PARM0))
916 tmresult = localtime_s(&tm, &t);
918 tmresult = gmtime_s(&tm, &t);
921 if (PRVM_G_FLOAT(OFS_PARM0))
928 PRVM_G_INT(OFS_RETURN) = 0;
932 strftime(result, sizeof(result), fmt, &tm);
934 strftime(result, sizeof(result), fmt, tm);
936 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, result);
947 void VM_spawn(prvm_prog_t *prog)
950 VM_SAFEPARMCOUNT(0, VM_spawn);
951 prog->xfunction->builtinsprofile += 20;
952 ed = PRVM_ED_Alloc(prog);
964 void VM_remove(prvm_prog_t *prog)
967 prog->xfunction->builtinsprofile += 20;
969 VM_SAFEPARMCOUNT(1, VM_remove);
971 ed = PRVM_G_EDICT(OFS_PARM0);
972 if( PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
974 if (developer.integer > 0)
975 VM_Warning(prog, "VM_remove: tried to remove the null entity or a reserved entity!\n" );
977 else if( ed->priv.required->free )
979 if (developer.integer > 0)
980 VM_Warning(prog, "VM_remove: tried to remove an already freed entity!\n" );
983 PRVM_ED_Free (prog, ed);
990 entity find(entity start, .string field, string match)
994 void VM_find(prvm_prog_t *prog)
1001 VM_SAFEPARMCOUNT(3,VM_find);
1003 e = PRVM_G_EDICTNUM(OFS_PARM0);
1004 f = PRVM_G_INT(OFS_PARM1);
1005 s = PRVM_G_STRING(OFS_PARM2);
1007 // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1008 // expects it to find all the monsters, so we must be careful to support
1011 for (e++ ; e < prog->num_edicts ; e++)
1013 prog->xfunction->builtinsprofile++;
1014 ed = PRVM_EDICT_NUM(e);
1015 if (ed->priv.required->free)
1017 t = PRVM_E_STRING(ed,f);
1022 VM_RETURN_EDICT(ed);
1027 VM_RETURN_EDICT(prog->edicts);
1034 entity findfloat(entity start, .float field, float match)
1035 entity findentity(entity start, .entity field, entity match)
1038 // LordHavoc: added this for searching float, int, and entity reference fields
1039 void VM_findfloat(prvm_prog_t *prog)
1046 VM_SAFEPARMCOUNT(3,VM_findfloat);
1048 e = PRVM_G_EDICTNUM(OFS_PARM0);
1049 f = PRVM_G_INT(OFS_PARM1);
1050 s = PRVM_G_FLOAT(OFS_PARM2);
1052 for (e++ ; e < prog->num_edicts ; e++)
1054 prog->xfunction->builtinsprofile++;
1055 ed = PRVM_EDICT_NUM(e);
1056 if (ed->priv.required->free)
1058 if (PRVM_E_FLOAT(ed,f) == s)
1060 VM_RETURN_EDICT(ed);
1065 VM_RETURN_EDICT(prog->edicts);
1072 entity findchain(.string field, string match)
1075 // chained search for strings in entity fields
1076 // entity(.string field, string match) findchain = #402;
1077 void VM_findchain(prvm_prog_t *prog)
1082 prvm_edict_t *ent, *chain;
1085 VM_SAFEPARMCOUNTRANGE(2,3,VM_findchain);
1088 chainfield = PRVM_G_INT(OFS_PARM2);
1090 chainfield = prog->fieldoffsets.chain;
1092 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1094 chain = prog->edicts;
1096 f = PRVM_G_INT(OFS_PARM0);
1097 s = PRVM_G_STRING(OFS_PARM1);
1099 // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1100 // expects it to find all the monsters, so we must be careful to support
1103 ent = PRVM_NEXT_EDICT(prog->edicts);
1104 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1106 prog->xfunction->builtinsprofile++;
1107 if (ent->priv.required->free)
1109 t = PRVM_E_STRING(ent,f);
1115 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_NUM_FOR_EDICT(chain);
1119 VM_RETURN_EDICT(chain);
1126 entity findchainfloat(.string field, float match)
1127 entity findchainentity(.string field, entity match)
1130 // LordHavoc: chained search for float, int, and entity reference fields
1131 // entity(.string field, float match) findchainfloat = #403;
1132 void VM_findchainfloat(prvm_prog_t *prog)
1137 prvm_edict_t *ent, *chain;
1140 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainfloat);
1143 chainfield = PRVM_G_INT(OFS_PARM2);
1145 chainfield = prog->fieldoffsets.chain;
1147 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1149 chain = (prvm_edict_t *)prog->edicts;
1151 f = PRVM_G_INT(OFS_PARM0);
1152 s = PRVM_G_FLOAT(OFS_PARM1);
1154 ent = PRVM_NEXT_EDICT(prog->edicts);
1155 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1157 prog->xfunction->builtinsprofile++;
1158 if (ent->priv.required->free)
1160 if (PRVM_E_FLOAT(ent,f) != s)
1163 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1167 VM_RETURN_EDICT(chain);
1171 ========================
1174 entity findflags(entity start, .float field, float match)
1175 ========================
1177 // LordHavoc: search for flags in float fields
1178 void VM_findflags(prvm_prog_t *prog)
1185 VM_SAFEPARMCOUNT(3, VM_findflags);
1188 e = PRVM_G_EDICTNUM(OFS_PARM0);
1189 f = PRVM_G_INT(OFS_PARM1);
1190 s = (int)PRVM_G_FLOAT(OFS_PARM2);
1192 for (e++ ; e < prog->num_edicts ; e++)
1194 prog->xfunction->builtinsprofile++;
1195 ed = PRVM_EDICT_NUM(e);
1196 if (ed->priv.required->free)
1198 if (!PRVM_E_FLOAT(ed,f))
1200 if ((int)PRVM_E_FLOAT(ed,f) & s)
1202 VM_RETURN_EDICT(ed);
1207 VM_RETURN_EDICT(prog->edicts);
1211 ========================
1214 entity findchainflags(.float field, float match)
1215 ========================
1217 // LordHavoc: chained search for flags in float fields
1218 void VM_findchainflags(prvm_prog_t *prog)
1223 prvm_edict_t *ent, *chain;
1226 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainflags);
1229 chainfield = PRVM_G_INT(OFS_PARM2);
1231 chainfield = prog->fieldoffsets.chain;
1233 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1235 chain = (prvm_edict_t *)prog->edicts;
1237 f = PRVM_G_INT(OFS_PARM0);
1238 s = (int)PRVM_G_FLOAT(OFS_PARM1);
1240 ent = PRVM_NEXT_EDICT(prog->edicts);
1241 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1243 prog->xfunction->builtinsprofile++;
1244 if (ent->priv.required->free)
1246 if (!PRVM_E_FLOAT(ent,f))
1248 if (!((int)PRVM_E_FLOAT(ent,f) & s))
1251 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1255 VM_RETURN_EDICT(chain);
1262 string precache_sound (string sample)
1265 void VM_precache_sound(prvm_prog_t *prog)
1269 VM_SAFEPARMCOUNT(1, VM_precache_sound);
1271 s = PRVM_G_STRING(OFS_PARM0);
1272 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1273 //VM_CheckEmptyString(prog, s);
1275 if(snd_initialized.integer && !S_PrecacheSound(s, true, true))
1277 VM_Warning(prog, "VM_precache_sound: Failed to load %s for %s\n", s, prog->name);
1286 returns the same string as output
1288 does nothing, only used by qcc to build .pak archives
1291 void VM_precache_file(prvm_prog_t *prog)
1293 VM_SAFEPARMCOUNT(1,VM_precache_file);
1294 // precache_file is only used to copy files with qcc, it does nothing
1295 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1305 void VM_coredump(prvm_prog_t *prog)
1307 VM_SAFEPARMCOUNT(0,VM_coredump);
1309 Cbuf_AddText("prvm_edicts ");
1310 Cbuf_AddText(prog->name);
1321 void VM_stackdump(prvm_prog_t *prog)
1323 VM_SAFEPARMCOUNT(0, VM_stackdump);
1325 PRVM_StackTrace(prog);
1336 void VM_crash(prvm_prog_t *prog)
1338 VM_SAFEPARMCOUNT(0, VM_crash);
1340 prog->error_cmd("Crash called by %s",prog->name);
1350 void VM_traceon(prvm_prog_t *prog)
1352 VM_SAFEPARMCOUNT(0,VM_traceon);
1364 void VM_traceoff(prvm_prog_t *prog)
1366 VM_SAFEPARMCOUNT(0,VM_traceoff);
1368 prog->trace = false;
1378 void VM_eprint(prvm_prog_t *prog)
1380 VM_SAFEPARMCOUNT(1,VM_eprint);
1382 PRVM_ED_PrintNum (prog, PRVM_G_EDICTNUM(OFS_PARM0), NULL);
1392 void VM_rint(prvm_prog_t *prog)
1395 VM_SAFEPARMCOUNT(1,VM_rint);
1397 f = PRVM_G_FLOAT(OFS_PARM0);
1399 PRVM_G_FLOAT(OFS_RETURN) = floor(f + 0.5);
1401 PRVM_G_FLOAT(OFS_RETURN) = ceil(f - 0.5);
1411 void VM_floor(prvm_prog_t *prog)
1413 VM_SAFEPARMCOUNT(1,VM_floor);
1415 PRVM_G_FLOAT(OFS_RETURN) = floor(PRVM_G_FLOAT(OFS_PARM0));
1425 void VM_ceil(prvm_prog_t *prog)
1427 VM_SAFEPARMCOUNT(1,VM_ceil);
1429 PRVM_G_FLOAT(OFS_RETURN) = ceil(PRVM_G_FLOAT(OFS_PARM0));
1437 entity nextent(entity)
1440 void VM_nextent(prvm_prog_t *prog)
1445 VM_SAFEPARMCOUNT(1, VM_nextent);
1447 i = PRVM_G_EDICTNUM(OFS_PARM0);
1450 prog->xfunction->builtinsprofile++;
1452 if (i == prog->num_edicts)
1454 VM_RETURN_EDICT(prog->edicts);
1457 ent = PRVM_EDICT_NUM(i);
1458 if (!ent->priv.required->free)
1460 VM_RETURN_EDICT(ent);
1466 //=============================================================================
1473 changelevel(string map)
1476 void VM_changelevel(prvm_prog_t *prog)
1479 VM_SAFEPARMCOUNT(1, VM_changelevel);
1483 VM_Warning(prog, "VM_changelevel: game is not server (%s)\n", prog->name);
1487 // make sure we don't issue two changelevels
1488 if (svs.changelevel_issued)
1490 svs.changelevel_issued = true;
1492 Cbuf_AddText(va(vabuf, sizeof(vabuf), "changelevel %s\n",PRVM_G_STRING(OFS_PARM0)));
1502 void VM_sin(prvm_prog_t *prog)
1504 VM_SAFEPARMCOUNT(1,VM_sin);
1505 PRVM_G_FLOAT(OFS_RETURN) = sin(PRVM_G_FLOAT(OFS_PARM0));
1514 void VM_cos(prvm_prog_t *prog)
1516 VM_SAFEPARMCOUNT(1,VM_cos);
1517 PRVM_G_FLOAT(OFS_RETURN) = cos(PRVM_G_FLOAT(OFS_PARM0));
1527 void VM_sqrt(prvm_prog_t *prog)
1529 VM_SAFEPARMCOUNT(1,VM_sqrt);
1530 PRVM_G_FLOAT(OFS_RETURN) = sqrt(PRVM_G_FLOAT(OFS_PARM0));
1540 void VM_asin(prvm_prog_t *prog)
1542 VM_SAFEPARMCOUNT(1,VM_asin);
1543 PRVM_G_FLOAT(OFS_RETURN) = asin(PRVM_G_FLOAT(OFS_PARM0));
1552 void VM_acos(prvm_prog_t *prog)
1554 VM_SAFEPARMCOUNT(1,VM_acos);
1555 PRVM_G_FLOAT(OFS_RETURN) = acos(PRVM_G_FLOAT(OFS_PARM0));
1564 void VM_atan(prvm_prog_t *prog)
1566 VM_SAFEPARMCOUNT(1,VM_atan);
1567 PRVM_G_FLOAT(OFS_RETURN) = atan(PRVM_G_FLOAT(OFS_PARM0));
1573 float atan2(float,float)
1576 void VM_atan2(prvm_prog_t *prog)
1578 VM_SAFEPARMCOUNT(2,VM_atan2);
1579 PRVM_G_FLOAT(OFS_RETURN) = atan2(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1588 void VM_tan(prvm_prog_t *prog)
1590 VM_SAFEPARMCOUNT(1,VM_tan);
1591 PRVM_G_FLOAT(OFS_RETURN) = tan(PRVM_G_FLOAT(OFS_PARM0));
1598 Returns a vector of length < 1 and > 0
1603 void VM_randomvec(prvm_prog_t *prog)
1606 VM_SAFEPARMCOUNT(0, VM_randomvec);
1608 VectorCopy(temp, PRVM_G_VECTOR(OFS_RETURN));
1611 //=============================================================================
1617 float registercvar (string name, string value[, float flags])
1620 void VM_registercvar(prvm_prog_t *prog)
1622 const char *name, *value;
1625 VM_SAFEPARMCOUNTRANGE(2, 3, VM_registercvar);
1627 name = PRVM_G_STRING(OFS_PARM0);
1628 value = PRVM_G_STRING(OFS_PARM1);
1629 flags = prog->argc >= 3 ? (int)PRVM_G_FLOAT(OFS_PARM2) : 0;
1630 PRVM_G_FLOAT(OFS_RETURN) = 0;
1632 if(flags > CVAR_MAXFLAGSVAL)
1635 // first check to see if it has already been defined
1636 if (Cvar_FindVar (name))
1639 // check for overlap with a command
1640 if (Cmd_Exists (name))
1642 VM_Warning(prog, "VM_registercvar: %s is a command\n", name);
1646 Cvar_Get(name, value, flags, NULL);
1648 PRVM_G_FLOAT(OFS_RETURN) = 1; // success
1656 returns the minimum of two supplied floats
1658 float min(float a, float b, ...[float])
1661 void VM_min(prvm_prog_t *prog)
1663 VM_SAFEPARMCOUNTRANGE(2, 8, VM_min);
1664 // LordHavoc: 3+ argument enhancement suggested by FrikaC
1665 if (prog->argc >= 3)
1668 float f = PRVM_G_FLOAT(OFS_PARM0);
1669 for (i = 1;i < prog->argc;i++)
1670 if (f > PRVM_G_FLOAT((OFS_PARM0+i*3)))
1671 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1672 PRVM_G_FLOAT(OFS_RETURN) = f;
1675 PRVM_G_FLOAT(OFS_RETURN) = min(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1682 returns the maximum of two supplied floats
1684 float max(float a, float b, ...[float])
1687 void VM_max(prvm_prog_t *prog)
1689 VM_SAFEPARMCOUNTRANGE(2, 8, VM_max);
1690 // LordHavoc: 3+ argument enhancement suggested by FrikaC
1691 if (prog->argc >= 3)
1694 float f = PRVM_G_FLOAT(OFS_PARM0);
1695 for (i = 1;i < prog->argc;i++)
1696 if (f < PRVM_G_FLOAT((OFS_PARM0+i*3)))
1697 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1698 PRVM_G_FLOAT(OFS_RETURN) = f;
1701 PRVM_G_FLOAT(OFS_RETURN) = max(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1708 returns number bounded by supplied range
1710 float bound(float min, float value, float max)
1713 void VM_bound(prvm_prog_t *prog)
1715 VM_SAFEPARMCOUNT(3,VM_bound);
1716 PRVM_G_FLOAT(OFS_RETURN) = bound(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1), PRVM_G_FLOAT(OFS_PARM2));
1723 returns a raised to power b
1725 float pow(float a, float b)
1728 void VM_pow(prvm_prog_t *prog)
1730 VM_SAFEPARMCOUNT(2,VM_pow);
1731 PRVM_G_FLOAT(OFS_RETURN) = pow(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1734 void VM_log(prvm_prog_t *prog)
1736 VM_SAFEPARMCOUNT(1,VM_log);
1737 PRVM_G_FLOAT(OFS_RETURN) = log(PRVM_G_FLOAT(OFS_PARM0));
1740 void VM_Files_Init(prvm_prog_t *prog)
1743 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1744 prog->openfiles[i] = NULL;
1747 void VM_Files_CloseAll(prvm_prog_t *prog)
1750 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1752 if (prog->openfiles[i])
1753 FS_Close(prog->openfiles[i]);
1754 prog->openfiles[i] = NULL;
1758 static qfile_t *VM_GetFileHandle(prvm_prog_t *prog, int index)
1760 if (index < 0 || index >= PRVM_MAX_OPENFILES)
1762 Con_Printf("VM_GetFileHandle: invalid file handle %i used in %s\n", index, prog->name);
1765 if (prog->openfiles[index] == NULL)
1767 Con_Printf("VM_GetFileHandle: no such file handle %i (or file has been closed) in %s\n", index, prog->name);
1770 return prog->openfiles[index];
1777 float fopen(string filename, float mode)
1780 // float(string filename, float mode) fopen = #110;
1781 // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE),
1782 // returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason
1783 void VM_fopen(prvm_prog_t *prog)
1786 const char *modestring, *filename;
1789 VM_SAFEPARMCOUNT(2,VM_fopen);
1791 for (filenum = 0;filenum < PRVM_MAX_OPENFILES;filenum++)
1792 if (prog->openfiles[filenum] == NULL)
1794 if (filenum >= PRVM_MAX_OPENFILES)
1796 PRVM_G_FLOAT(OFS_RETURN) = -2;
1797 VM_Warning(prog, "VM_fopen: %s ran out of file handles (%i)\n", prog->name, PRVM_MAX_OPENFILES);
1800 filename = PRVM_G_STRING(OFS_PARM0);
1801 mode = (int)PRVM_G_FLOAT(OFS_PARM1);
1804 case 0: // FILE_READ
1806 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
1807 if (prog->openfiles[filenum] == NULL)
1808 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
1810 case 1: // FILE_APPEND
1812 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1814 case 2: // FILE_WRITE
1816 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1819 PRVM_G_FLOAT(OFS_RETURN) = -3;
1820 VM_Warning(prog, "VM_fopen: %s: no such mode %i (valid: 0 = read, 1 = append, 2 = write)\n", prog->name, mode);
1824 if (prog->openfiles[filenum] == NULL)
1826 PRVM_G_FLOAT(OFS_RETURN) = -1;
1827 if (developer_extra.integer)
1828 VM_Warning(prog, "VM_fopen: %s: %s mode %s failed\n", prog->name, filename, modestring);
1832 PRVM_G_FLOAT(OFS_RETURN) = filenum;
1833 if (developer_extra.integer)
1834 Con_DPrintf("VM_fopen: %s: %s mode %s opened as #%i\n", prog->name, filename, modestring, filenum);
1835 prog->openfiles_origin[filenum] = PRVM_AllocationOrigin(prog);
1843 fclose(float fhandle)
1846 //void(float fhandle) fclose = #111; // closes a file
1847 void VM_fclose(prvm_prog_t *prog)
1851 VM_SAFEPARMCOUNT(1,VM_fclose);
1853 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1854 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1856 VM_Warning(prog, "VM_fclose: invalid file handle %i used in %s\n", filenum, prog->name);
1859 if (prog->openfiles[filenum] == NULL)
1861 VM_Warning(prog, "VM_fclose: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1864 FS_Close(prog->openfiles[filenum]);
1865 prog->openfiles[filenum] = NULL;
1866 if(prog->openfiles_origin[filenum])
1867 PRVM_Free((char *)prog->openfiles_origin[filenum]);
1868 if (developer_extra.integer)
1869 Con_DPrintf("VM_fclose: %s: #%i closed\n", prog->name, filenum);
1876 string fgets(float fhandle)
1879 //string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring
1880 void VM_fgets(prvm_prog_t *prog)
1883 char string[VM_STRINGTEMP_LENGTH];
1886 VM_SAFEPARMCOUNT(1,VM_fgets);
1888 // set the return value regardless of any possible errors
1889 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
1891 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1892 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1894 VM_Warning(prog, "VM_fgets: invalid file handle %i used in %s\n", filenum, prog->name);
1897 if (prog->openfiles[filenum] == NULL)
1899 VM_Warning(prog, "VM_fgets: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1905 c = FS_Getc(prog->openfiles[filenum]);
1906 if (c == '\r' || c == '\n' || c < 0)
1908 if (end < VM_STRINGTEMP_LENGTH - 1)
1912 // remove \n following \r
1915 c = FS_Getc(prog->openfiles[filenum]);
1917 FS_UnGetc(prog->openfiles[filenum], (unsigned char)c);
1919 if (developer_extra.integer)
1920 Con_DPrintf("fgets: %s: %s\n", prog->name, string);
1922 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
1929 fputs(float fhandle, string s)
1932 //void(float fhandle, string s) fputs = #113; // writes a line of text to the end of the file
1933 void VM_fputs(prvm_prog_t *prog)
1936 char string[VM_STRINGTEMP_LENGTH];
1939 VM_SAFEPARMCOUNT(2,VM_fputs);
1941 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1942 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1944 VM_Warning(prog, "VM_fputs: invalid file handle %i used in %s\n", filenum, prog->name);
1947 if (prog->openfiles[filenum] == NULL)
1949 VM_Warning(prog, "VM_fputs: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1952 VM_VarString(prog, 1, string, sizeof(string));
1953 if ((stringlength = (int)strlen(string)))
1954 FS_Write(prog->openfiles[filenum], string, stringlength);
1955 if (developer_extra.integer)
1956 Con_DPrintf("fputs: %s: %s\n", prog->name, string);
1963 writetofile(float fhandle, entity ent)
1966 void VM_writetofile(prvm_prog_t *prog)
1971 VM_SAFEPARMCOUNT(2, VM_writetofile);
1973 file = VM_GetFileHandle(prog, (int)PRVM_G_FLOAT(OFS_PARM0));
1976 VM_Warning(prog, "VM_writetofile: invalid or closed file handle\n");
1980 ent = PRVM_G_EDICT(OFS_PARM1);
1981 if(ent->priv.required->free)
1983 VM_Warning(prog, "VM_writetofile: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
1987 PRVM_ED_Write (prog, file, ent);
1990 // KrimZon - DP_QC_ENTITYDATA
1995 float() numentityfields
1996 Return the number of entity fields - NOT offsets
1999 void VM_numentityfields(prvm_prog_t *prog)
2001 PRVM_G_FLOAT(OFS_RETURN) = prog->numfielddefs;
2004 // KrimZon - DP_QC_ENTITYDATA
2009 string(float fieldnum) entityfieldname
2010 Return name of the specified field as a string, or empty if the field is invalid (warning)
2013 void VM_entityfieldname(prvm_prog_t *prog)
2016 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2018 if (i < 0 || i >= prog->numfielddefs)
2020 VM_Warning(prog, "VM_entityfieldname: %s: field index out of bounds\n", prog->name);
2021 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2025 d = &prog->fielddefs[i];
2026 PRVM_G_INT(OFS_RETURN) = d->s_name; // presuming that s_name points to a string already
2029 // KrimZon - DP_QC_ENTITYDATA
2034 float(float fieldnum) entityfieldtype
2037 void VM_entityfieldtype(prvm_prog_t *prog)
2040 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2042 if (i < 0 || i >= prog->numfielddefs)
2044 VM_Warning(prog, "VM_entityfieldtype: %s: field index out of bounds\n", prog->name);
2045 PRVM_G_FLOAT(OFS_RETURN) = -1.0;
2049 d = &prog->fielddefs[i];
2050 PRVM_G_FLOAT(OFS_RETURN) = (float)d->type;
2053 // KrimZon - DP_QC_ENTITYDATA
2056 VM_getentityfieldstring
2058 string(float fieldnum, entity ent) getentityfieldstring
2061 void VM_getentityfieldstring(prvm_prog_t *prog)
2063 // put the data into a string
2068 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2069 char valuebuf[MAX_INPUTLINE];
2071 if (i < 0 || i >= prog->numfielddefs)
2073 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2074 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2078 d = &prog->fielddefs[i];
2081 ent = PRVM_G_EDICT(OFS_PARM1);
2082 if(ent->priv.required->free)
2084 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2085 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2088 v = (int *)((char *)ent->fields.vp + d->ofs*4);
2090 // if it's 0 or blank, return an empty string
2091 type = d->type & ~DEF_SAVEGLOBAL;
2092 for (j=0 ; j<prvm_type_size[type] ; j++)
2095 if (j == prvm_type_size[type])
2097 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2101 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_UglyValueString(prog, (etype_t)d->type, (prvm_eval_t *)v, valuebuf, sizeof(valuebuf)));
2104 // KrimZon - DP_QC_ENTITYDATA
2107 VM_putentityfieldstring
2109 float(float fieldnum, entity ent, string s) putentityfieldstring
2112 void VM_putentityfieldstring(prvm_prog_t *prog)
2116 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2118 if (i < 0 || i >= prog->numfielddefs)
2120 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2121 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2125 d = &prog->fielddefs[i];
2128 ent = PRVM_G_EDICT(OFS_PARM1);
2129 if(ent->priv.required->free)
2131 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2132 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2136 // parse the string into the value
2137 PRVM_G_FLOAT(OFS_RETURN) = ( PRVM_ED_ParseEpair(prog, ent, d, PRVM_G_STRING(OFS_PARM2), false) ) ? 1.0f : 0.0f;
2144 float strlen(string s)
2147 //float(string s) strlen = #114; // returns how many characters are in a string
2148 void VM_strlen(prvm_prog_t *prog)
2150 VM_SAFEPARMCOUNT(1,VM_strlen);
2152 //PRVM_G_FLOAT(OFS_RETURN) = strlen(PRVM_G_STRING(OFS_PARM0));
2153 PRVM_G_FLOAT(OFS_RETURN) = u8_strlen(PRVM_G_STRING(OFS_PARM0));
2156 // DRESK - Decolorized String
2161 string strdecolorize(string s)
2164 // string (string s) strdecolorize = #472; // returns the passed in string with color codes stripped
2165 void VM_strdecolorize(prvm_prog_t *prog)
2167 char szNewString[VM_STRINGTEMP_LENGTH];
2168 const char *szString;
2171 VM_SAFEPARMCOUNT(1,VM_strdecolorize);
2172 szString = PRVM_G_STRING(OFS_PARM0);
2173 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), TRUE);
2174 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2177 // DRESK - String Length (not counting color codes)
2182 float strlennocol(string s)
2185 // float(string s) strlennocol = #471; // returns how many characters are in a string not including color codes
2186 // For example, ^2Dresk returns a length of 5
2187 void VM_strlennocol(prvm_prog_t *prog)
2189 const char *szString;
2192 VM_SAFEPARMCOUNT(1,VM_strlennocol);
2194 szString = PRVM_G_STRING(OFS_PARM0);
2196 //nCnt = COM_StringLengthNoColors(szString, 0, NULL);
2197 nCnt = u8_COM_StringLengthNoColors(szString, 0, NULL);
2199 PRVM_G_FLOAT(OFS_RETURN) = nCnt;
2202 // DRESK - String to Uppercase and Lowercase
2207 string strtolower(string s)
2210 // string (string s) strtolower = #480; // returns passed in string in lowercase form
2211 void VM_strtolower(prvm_prog_t *prog)
2213 char szNewString[VM_STRINGTEMP_LENGTH];
2214 const char *szString;
2217 VM_SAFEPARMCOUNT(1,VM_strtolower);
2218 szString = PRVM_G_STRING(OFS_PARM0);
2220 COM_ToLowerString(szString, szNewString, sizeof(szNewString) );
2222 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2229 string strtoupper(string s)
2232 // string (string s) strtoupper = #481; // returns passed in string in uppercase form
2233 void VM_strtoupper(prvm_prog_t *prog)
2235 char szNewString[VM_STRINGTEMP_LENGTH];
2236 const char *szString;
2239 VM_SAFEPARMCOUNT(1,VM_strtoupper);
2240 szString = PRVM_G_STRING(OFS_PARM0);
2242 COM_ToUpperString(szString, szNewString, sizeof(szNewString) );
2244 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2251 string strcat(string,string,...[string])
2254 //string(string s1, string s2) strcat = #115;
2255 // concatenates two strings (for example "abc", "def" would return "abcdef")
2256 // and returns as a tempstring
2257 void VM_strcat(prvm_prog_t *prog)
2259 char s[VM_STRINGTEMP_LENGTH];
2260 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strcat);
2262 VM_VarString(prog, 0, s, sizeof(s));
2263 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
2270 string substring(string s, float start, float length)
2273 // string(string s, float start, float length) substring = #116;
2274 // returns a section of a string as a tempstring
2275 void VM_substring(prvm_prog_t *prog)
2278 int u_slength = 0, u_start;
2281 char string[VM_STRINGTEMP_LENGTH];
2283 VM_SAFEPARMCOUNT(3,VM_substring);
2286 s = PRVM_G_STRING(OFS_PARM0);
2287 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2288 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2289 slength = strlen(s);
2291 if (start < 0) // FTE_STRINGS feature
2293 start = bound(0, start, slength);
2295 if (length < 0) // FTE_STRINGS feature
2296 length += slength - start + 1;
2297 maxlen = min((int)sizeof(string) - 1, slength - start);
2298 length = bound(0, length, maxlen);
2300 memcpy(string, s + start, length);
2302 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2305 s = PRVM_G_STRING(OFS_PARM0);
2306 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2307 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2309 if (start < 0) // FTE_STRINGS feature
2311 u_slength = u8_strlen(s);
2313 start = bound(0, start, u_slength);
2316 if (length < 0) // FTE_STRINGS feature
2318 if (!u_slength) // it's not calculated when it's not needed above
2319 u_slength = u8_strlen(s);
2320 length += u_slength - start + 1;
2323 // positive start, positive length
2324 u_start = u8_byteofs(s, start, NULL);
2327 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2330 u_length = u8_bytelen(s + u_start, length);
2331 if (u_length >= sizeof(string)-1)
2332 u_length = sizeof(string)-1;
2334 memcpy(string, s + u_start, u_length);
2335 string[u_length] = 0;
2336 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2343 string(string search, string replace, string subject) strreplace = #484;
2346 // replaces all occurrences of search with replace in the string subject, and returns the result
2347 void VM_strreplace(prvm_prog_t *prog)
2350 const char *search, *replace, *subject;
2351 char string[VM_STRINGTEMP_LENGTH];
2352 int search_len, replace_len, subject_len;
2354 VM_SAFEPARMCOUNT(3,VM_strreplace);
2356 search = PRVM_G_STRING(OFS_PARM0);
2357 replace = PRVM_G_STRING(OFS_PARM1);
2358 subject = PRVM_G_STRING(OFS_PARM2);
2360 search_len = (int)strlen(search);
2361 replace_len = (int)strlen(replace);
2362 subject_len = (int)strlen(subject);
2365 for (i = 0; i <= subject_len - search_len; i++)
2367 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2368 if (subject[i+j] != search[j])
2370 if (j == search_len)
2372 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2373 // found it at offset 'i'
2374 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2375 string[si++] = replace[j];
2378 i += search_len - 1;
2382 // the above would subtract 1 from i... so we
2383 // don't do that, but instead output the next
2385 if (si < (int)sizeof(string) - 1)
2386 string[si++] = subject[i];
2391 // in THIS case, we know search_len > 0, thus i < subject_len
2393 if (si < (int)sizeof(string) - 1)
2394 string[si++] = subject[i];
2397 // remaining chars (these cannot match)
2398 for (; i < subject_len; i++)
2399 if (si < (int)sizeof(string) - 1)
2400 string[si++] = subject[i];
2403 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2410 string(string search, string replace, string subject) strireplace = #485;
2413 // case-insensitive version of strreplace
2414 void VM_strireplace(prvm_prog_t *prog)
2417 const char *search, *replace, *subject;
2418 char string[VM_STRINGTEMP_LENGTH];
2419 int search_len, replace_len, subject_len;
2421 VM_SAFEPARMCOUNT(3,VM_strreplace);
2423 search = PRVM_G_STRING(OFS_PARM0);
2424 replace = PRVM_G_STRING(OFS_PARM1);
2425 subject = PRVM_G_STRING(OFS_PARM2);
2427 search_len = (int)strlen(search);
2428 replace_len = (int)strlen(replace);
2429 subject_len = (int)strlen(subject);
2432 for (i = 0; i <= subject_len - search_len; i++)
2434 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2435 if (tolower(subject[i+j]) != tolower(search[j]))
2437 if (j == search_len)
2439 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2440 // found it at offset 'i'
2441 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2442 string[si++] = replace[j];
2445 i += search_len - 1;
2449 // the above would subtract 1 from i... so we
2450 // don't do that, but instead output the next
2452 if (si < (int)sizeof(string) - 1)
2453 string[si++] = subject[i];
2458 // in THIS case, we know search_len > 0, thus i < subject_len
2460 if (si < (int)sizeof(string) - 1)
2461 string[si++] = subject[i];
2464 // remaining chars (these cannot match)
2465 for (; i < subject_len; i++)
2466 if (si < (int)sizeof(string) - 1)
2467 string[si++] = subject[i];
2470 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2477 vector stov(string s)
2480 //vector(string s) stov = #117; // returns vector value from a string
2481 void VM_stov(prvm_prog_t *prog)
2483 char string[VM_STRINGTEMP_LENGTH];
2485 VM_SAFEPARMCOUNT(1,VM_stov);
2487 VM_VarString(prog, 0, string, sizeof(string));
2488 Math_atov(string, PRVM_G_VECTOR(OFS_RETURN));
2495 string strzone(string s)
2498 //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)
2499 void VM_strzone(prvm_prog_t *prog)
2502 char string[VM_STRINGTEMP_LENGTH];
2505 VM_SAFEPARMCOUNT(1,VM_strzone);
2507 VM_VarString(prog, 0, string, sizeof(string));
2508 alloclen = strlen(string) + 1;
2509 PRVM_G_INT(OFS_RETURN) = PRVM_AllocString(prog, alloclen, &out);
2510 memcpy(out, string, alloclen);
2520 //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!!!)
2521 void VM_strunzone(prvm_prog_t *prog)
2523 VM_SAFEPARMCOUNT(1,VM_strunzone);
2524 PRVM_FreeString(prog, PRVM_G_INT(OFS_PARM0));
2529 VM_command (used by client and menu)
2531 clientcommand(float client, string s) (for client and menu)
2534 //void(entity e, string s) clientcommand = #440; // executes a command string as if it came from the specified client
2535 //this function originally written by KrimZon, made shorter by LordHavoc
2536 void VM_clcommand (prvm_prog_t *prog)
2538 client_t *temp_client;
2541 VM_SAFEPARMCOUNT(2,VM_clcommand);
2543 i = (int)PRVM_G_FLOAT(OFS_PARM0);
2544 if (!sv.active || i < 0 || i >= svs.maxclients || !svs.clients[i].active)
2546 VM_Warning(prog, "VM_clientcommand: %s: invalid client/server is not active !\n", prog->name);
2550 temp_client = host_client;
2551 host_client = svs.clients + i;
2552 Cmd_ExecuteString (PRVM_G_STRING(OFS_PARM1), src_client, true);
2553 host_client = temp_client;
2561 float tokenize(string s)
2564 //float(string s) tokenize = #441; // takes apart a string into individal words (access them with argv), returns how many
2565 //this function originally written by KrimZon, made shorter by LordHavoc
2566 //20040203: rewritten by LordHavoc (no longer uses allocations)
2567 static int num_tokens = 0;
2568 static int tokens[VM_STRINGTEMP_LENGTH / 2];
2569 static int tokens_startpos[VM_STRINGTEMP_LENGTH / 2];
2570 static int tokens_endpos[VM_STRINGTEMP_LENGTH / 2];
2571 static char tokenize_string[VM_STRINGTEMP_LENGTH];
2572 void VM_tokenize (prvm_prog_t *prog)
2576 VM_SAFEPARMCOUNT(1,VM_tokenize);
2578 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2579 p = tokenize_string;
2584 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2587 // skip whitespace here to find token start pos
2588 while(*p && ISWHITESPACE(*p))
2591 tokens_startpos[num_tokens] = p - tokenize_string;
2592 if(!COM_ParseToken_VM_Tokenize(&p, false))
2594 tokens_endpos[num_tokens] = p - tokenize_string;
2595 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2599 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2602 //float(string s) tokenize = #514; // takes apart a string into individal words (access them with argv), returns how many
2603 void VM_tokenize_console (prvm_prog_t *prog)
2607 VM_SAFEPARMCOUNT(1,VM_tokenize);
2609 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2610 p = tokenize_string;
2615 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2618 // skip whitespace here to find token start pos
2619 while(*p && ISWHITESPACE(*p))
2622 tokens_startpos[num_tokens] = p - tokenize_string;
2623 if(!COM_ParseToken_Console(&p))
2625 tokens_endpos[num_tokens] = p - tokenize_string;
2626 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2630 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2635 VM_tokenizebyseparator
2637 float tokenizebyseparator(string s, string separator1, ...)
2640 //float(string s, string separator1, ...) tokenizebyseparator = #479; // takes apart a string into individal words (access them with argv), returns how many
2641 //this function returns the token preceding each instance of a separator (of
2642 //which there can be multiple), and the text following the last separator
2643 //useful for parsing certain kinds of data like IP addresses
2645 //numnumbers = tokenizebyseparator("10.1.2.3", ".");
2646 //returns 4 and the tokens "10" "1" "2" "3".
2647 void VM_tokenizebyseparator (prvm_prog_t *prog)
2651 int separatorlen[7];
2652 const char *separators[7];
2655 char tokentext[MAX_INPUTLINE];
2657 VM_SAFEPARMCOUNTRANGE(2, 8,VM_tokenizebyseparator);
2659 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2660 p = tokenize_string;
2663 for (j = 1;j < prog->argc;j++)
2665 // skip any blank separator strings
2666 const char *s = PRVM_G_STRING(OFS_PARM0+j*3);
2669 separators[numseparators] = s;
2670 separatorlen[numseparators] = strlen(s);
2677 while (num_tokens < (int)(sizeof(tokens)/sizeof(tokens[0])))
2679 token = tokentext + j;
2680 tokens_startpos[num_tokens] = p - tokenize_string;
2684 for (k = 0;k < numseparators;k++)
2686 if (!strncmp(p, separators[k], separatorlen[k]))
2688 p += separatorlen[k];
2692 if (k < numseparators)
2694 if (j < (int)sizeof(tokentext)-1)
2695 tokentext[j++] = *p;
2699 tokens_endpos[num_tokens] = p0 - tokenize_string;
2700 if (j >= (int)sizeof(tokentext))
2703 tokens[num_tokens++] = PRVM_SetTempString(prog, token);
2708 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2711 //string(float n) argv = #442; // returns a word from the tokenized string (returns nothing for an invalid index)
2712 //this function originally written by KrimZon, made shorter by LordHavoc
2713 void VM_argv (prvm_prog_t *prog)
2717 VM_SAFEPARMCOUNT(1,VM_argv);
2719 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2722 token_num += num_tokens;
2724 if (token_num >= 0 && token_num < num_tokens)
2725 PRVM_G_INT(OFS_RETURN) = tokens[token_num];
2727 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2730 //float(float n) argv_start_index = #515; // returns the start index of a token
2731 void VM_argv_start_index (prvm_prog_t *prog)
2735 VM_SAFEPARMCOUNT(1,VM_argv);
2737 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2740 token_num += num_tokens;
2742 if (token_num >= 0 && token_num < num_tokens)
2743 PRVM_G_FLOAT(OFS_RETURN) = tokens_startpos[token_num];
2745 PRVM_G_FLOAT(OFS_RETURN) = -1;
2748 //float(float n) argv_end_index = #516; // returns the end index of a token
2749 void VM_argv_end_index (prvm_prog_t *prog)
2753 VM_SAFEPARMCOUNT(1,VM_argv);
2755 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2758 token_num += num_tokens;
2760 if (token_num >= 0 && token_num < num_tokens)
2761 PRVM_G_FLOAT(OFS_RETURN) = tokens_endpos[token_num];
2763 PRVM_G_FLOAT(OFS_RETURN) = -1;
2773 void VM_isserver(prvm_prog_t *prog)
2775 VM_SAFEPARMCOUNT(0,VM_serverstate);
2777 PRVM_G_FLOAT(OFS_RETURN) = sv.active && (svs.maxclients > 1 || cls.state == ca_dedicated);
2787 void VM_clientcount(prvm_prog_t *prog)
2789 VM_SAFEPARMCOUNT(0,VM_clientcount);
2791 PRVM_G_FLOAT(OFS_RETURN) = svs.maxclients;
2801 void VM_clientstate(prvm_prog_t *prog)
2803 VM_SAFEPARMCOUNT(0,VM_clientstate);
2806 switch( cls.state ) {
2807 case ca_uninitialized:
2809 PRVM_G_FLOAT(OFS_RETURN) = 0;
2811 case ca_disconnected:
2812 PRVM_G_FLOAT(OFS_RETURN) = 1;
2815 PRVM_G_FLOAT(OFS_RETURN) = 2;
2818 // should never be reached!
2827 float getostype(prvm_prog_t *prog)
2829 */ // not used at the moment -> not included in the common list
2830 void VM_getostype(prvm_prog_t *prog)
2832 VM_SAFEPARMCOUNT(0,VM_getostype);
2837 OS_MAC - not supported
2841 PRVM_G_FLOAT(OFS_RETURN) = 0;
2842 #elif defined(MACOSX)
2843 PRVM_G_FLOAT(OFS_RETURN) = 2;
2845 PRVM_G_FLOAT(OFS_RETURN) = 1;
2853 float gettime(prvm_prog_t *prog)
2856 float CDAudio_GetPosition(void);
2857 void VM_gettime(prvm_prog_t *prog)
2861 VM_SAFEPARMCOUNTRANGE(0,1,VM_gettime);
2865 PRVM_G_FLOAT(OFS_RETURN) = (float) realtime;
2869 timer_index = (int) PRVM_G_FLOAT(OFS_PARM0);
2872 case 0: // GETTIME_FRAMESTART
2873 PRVM_G_FLOAT(OFS_RETURN) = realtime;
2875 case 1: // GETTIME_REALTIME
2876 PRVM_G_FLOAT(OFS_RETURN) = Sys_DirtyTime();
2878 case 2: // GETTIME_HIRES
2879 PRVM_G_FLOAT(OFS_RETURN) = (Sys_DirtyTime() - host_dirtytime);
2881 case 3: // GETTIME_UPTIME
2882 PRVM_G_FLOAT(OFS_RETURN) = realtime;
2884 case 4: // GETTIME_CDTRACK
2885 PRVM_G_FLOAT(OFS_RETURN) = CDAudio_GetPosition();
2888 VM_Warning(prog, "VM_gettime: %s: unsupported timer specified, returning realtime\n", prog->name);
2889 PRVM_G_FLOAT(OFS_RETURN) = realtime;
2899 float getsoundtime(prvm_prog_t *prog)
2903 void VM_getsoundtime (prvm_prog_t *prog)
2905 int entnum, entchannel;
2906 VM_SAFEPARMCOUNT(2,VM_getsoundtime);
2908 if (prog == SVVM_prog)
2909 entnum = PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2910 else if (prog == CLVM_prog)
2911 entnum = MAX_EDICTS + PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2914 VM_Warning(prog, "VM_getsoundtime: %s: not supported on this progs\n", prog->name);
2915 PRVM_G_FLOAT(OFS_RETURN) = -1;
2918 entchannel = (int)PRVM_G_FLOAT(OFS_PARM1);
2919 entchannel = CHAN_USER2ENGINE(entchannel);
2920 if (!IS_CHAN(entchannel))
2921 VM_Warning(prog, "VM_getsoundtime: %s: bad channel %i\n", prog->name, entchannel);
2922 PRVM_G_FLOAT(OFS_RETURN) = (float)S_GetEntChannelPosition(entnum, entchannel);
2929 string soundlength (string sample)
2932 void VM_soundlength (prvm_prog_t *prog)
2936 VM_SAFEPARMCOUNT(1, VM_soundlength);
2938 s = PRVM_G_STRING(OFS_PARM0);
2939 PRVM_G_FLOAT(OFS_RETURN) = S_SoundLength(s);
2946 loadfromdata(string data)
2949 void VM_loadfromdata(prvm_prog_t *prog)
2951 VM_SAFEPARMCOUNT(1,VM_loadentsfromfile);
2953 PRVM_ED_LoadFromFile(prog, PRVM_G_STRING(OFS_PARM0));
2957 ========================
2960 parseentitydata(entity ent, string data)
2961 ========================
2963 void VM_parseentitydata(prvm_prog_t *prog)
2968 VM_SAFEPARMCOUNT(2, VM_parseentitydata);
2970 // get edict and test it
2971 ent = PRVM_G_EDICT(OFS_PARM0);
2972 if (ent->priv.required->free)
2973 prog->error_cmd("VM_parseentitydata: %s: Can only set already spawned entities (entity %i is free)!", prog->name, PRVM_NUM_FOR_EDICT(ent));
2975 data = PRVM_G_STRING(OFS_PARM1);
2977 // parse the opening brace
2978 if (!COM_ParseToken_Simple(&data, false, false, true) || com_token[0] != '{' )
2979 prog->error_cmd("VM_parseentitydata: %s: Couldn't parse entity data:\n%s", prog->name, data );
2981 PRVM_ED_ParseEdict (prog, data, ent);
2988 loadfromfile(string file)
2991 void VM_loadfromfile(prvm_prog_t *prog)
2993 const char *filename;
2996 VM_SAFEPARMCOUNT(1,VM_loadfromfile);
2998 filename = PRVM_G_STRING(OFS_PARM0);
2999 if (FS_CheckNastyPath(filename, false))
3001 PRVM_G_FLOAT(OFS_RETURN) = -4;
3002 VM_Warning(prog, "VM_loadfromfile: %s dangerous or non-portable filename \"%s\" not allowed. (contains : or \\ or begins with .. or /)\n", prog->name, filename);
3006 // not conform with VM_fopen
3007 data = (char *)FS_LoadFile(filename, tempmempool, false, NULL);
3009 PRVM_G_FLOAT(OFS_RETURN) = -1;
3011 PRVM_ED_LoadFromFile(prog, data);
3022 float mod(float val, float m)
3025 void VM_modulo(prvm_prog_t *prog)
3028 VM_SAFEPARMCOUNT(2,VM_module);
3030 val = (int) PRVM_G_FLOAT(OFS_PARM0);
3031 m = (int) PRVM_G_FLOAT(OFS_PARM1);
3033 PRVM_G_FLOAT(OFS_RETURN) = (float) (val % m);
3036 static void VM_Search_Init(prvm_prog_t *prog)
3039 for (i = 0;i < PRVM_MAX_OPENSEARCHES;i++)
3040 prog->opensearches[i] = NULL;
3043 static void VM_Search_Reset(prvm_prog_t *prog)
3046 // reset the fssearch list
3047 for(i = 0; i < PRVM_MAX_OPENSEARCHES; i++)
3049 if(prog->opensearches[i])
3050 FS_FreeSearch(prog->opensearches[i]);
3051 prog->opensearches[i] = NULL;
3059 float search_begin(string pattern, float caseinsensitive, float quiet)
3062 void VM_search_begin(prvm_prog_t *prog)
3065 const char *pattern;
3066 int caseinsens, quiet;
3068 VM_SAFEPARMCOUNT(3, VM_search_begin);
3070 pattern = PRVM_G_STRING(OFS_PARM0);
3072 VM_CheckEmptyString(prog, pattern);
3074 caseinsens = (int)PRVM_G_FLOAT(OFS_PARM1);
3075 quiet = (int)PRVM_G_FLOAT(OFS_PARM2);
3077 for(handle = 0; handle < PRVM_MAX_OPENSEARCHES; handle++)
3078 if(!prog->opensearches[handle])
3081 if(handle >= PRVM_MAX_OPENSEARCHES)
3083 PRVM_G_FLOAT(OFS_RETURN) = -2;
3084 VM_Warning(prog, "VM_search_begin: %s ran out of search handles (%i)\n", prog->name, PRVM_MAX_OPENSEARCHES);
3088 if(!(prog->opensearches[handle] = FS_Search(pattern,caseinsens, quiet)))
3089 PRVM_G_FLOAT(OFS_RETURN) = -1;
3092 prog->opensearches_origin[handle] = PRVM_AllocationOrigin(prog);
3093 PRVM_G_FLOAT(OFS_RETURN) = handle;
3101 void search_end(float handle)
3104 void VM_search_end(prvm_prog_t *prog)
3107 VM_SAFEPARMCOUNT(1, VM_search_end);
3109 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3111 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3113 VM_Warning(prog, "VM_search_end: invalid handle %i used in %s\n", handle, prog->name);
3116 if(prog->opensearches[handle] == NULL)
3118 VM_Warning(prog, "VM_search_end: no such handle %i in %s\n", handle, prog->name);
3122 FS_FreeSearch(prog->opensearches[handle]);
3123 prog->opensearches[handle] = NULL;
3124 if(prog->opensearches_origin[handle])
3125 PRVM_Free((char *)prog->opensearches_origin[handle]);
3132 float search_getsize(float handle)
3135 void VM_search_getsize(prvm_prog_t *prog)
3138 VM_SAFEPARMCOUNT(1, VM_M_search_getsize);
3140 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3142 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3144 VM_Warning(prog, "VM_search_getsize: invalid handle %i used in %s\n", handle, prog->name);
3147 if(prog->opensearches[handle] == NULL)
3149 VM_Warning(prog, "VM_search_getsize: no such handle %i in %s\n", handle, prog->name);
3153 PRVM_G_FLOAT(OFS_RETURN) = prog->opensearches[handle]->numfilenames;
3158 VM_search_getfilename
3160 string search_getfilename(float handle, float num)
3163 void VM_search_getfilename(prvm_prog_t *prog)
3165 int handle, filenum;
3166 VM_SAFEPARMCOUNT(2, VM_search_getfilename);
3168 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3169 filenum = (int)PRVM_G_FLOAT(OFS_PARM1);
3171 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3173 VM_Warning(prog, "VM_search_getfilename: invalid handle %i used in %s\n", handle, prog->name);
3176 if(prog->opensearches[handle] == NULL)
3178 VM_Warning(prog, "VM_search_getfilename: no such handle %i in %s\n", handle, prog->name);
3181 if(filenum < 0 || filenum >= prog->opensearches[handle]->numfilenames)
3183 VM_Warning(prog, "VM_search_getfilename: invalid filenum %i in %s\n", filenum, prog->name);
3187 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, prog->opensearches[handle]->filenames[filenum]);
3194 string chr(float ascii)
3197 void VM_chr(prvm_prog_t *prog)
3201 VM_SAFEPARMCOUNT(1, VM_chr);
3203 tmp[0] = (unsigned char) PRVM_G_FLOAT(OFS_PARM0);
3206 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3211 VM_SAFEPARMCOUNT(1, VM_chr);
3213 len = u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0), tmp, sizeof(tmp));
3215 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3218 //=============================================================================
3219 // Draw builtins (client & menu)
3225 float iscachedpic(string pic)
3228 void VM_iscachedpic(prvm_prog_t *prog)
3230 VM_SAFEPARMCOUNT(1,VM_iscachedpic);
3232 // drawq hasnt such a function, thus always return true
3233 PRVM_G_FLOAT(OFS_RETURN) = false;
3240 string precache_pic(string pic)
3243 void VM_precache_pic(prvm_prog_t *prog)
3247 VM_SAFEPARMCOUNT(1, VM_precache_pic);
3249 s = PRVM_G_STRING(OFS_PARM0);
3250 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
3251 VM_CheckEmptyString(prog, s);
3253 // AK Draw_CachePic is supposed to always return a valid pointer
3254 if( Draw_CachePic_Flags(s, 0)->tex == r_texture_notexture )
3255 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
3265 void VM_freepic(prvm_prog_t *prog)
3269 VM_SAFEPARMCOUNT(1,VM_freepic);
3271 s = PRVM_G_STRING(OFS_PARM0);
3272 VM_CheckEmptyString(prog, s);
3277 static void getdrawfontscale(prvm_prog_t *prog, float *sx, float *sy)
3281 VectorCopy(PRVM_drawglobalvector(drawfontscale), v);
3282 if(VectorLength2(v) > 0)
3289 static dp_font_t *getdrawfont(prvm_prog_t *prog)
3291 int f = (int) PRVM_drawglobalfloat(drawfont);
3292 if(f < 0 || f >= dp_fonts.maxsize)
3293 return FONT_DEFAULT;
3294 return &dp_fonts.f[f];
3301 float drawcharacter(vector position, float character, vector scale, vector rgb, float alpha, float flag)
3304 void VM_drawcharacter(prvm_prog_t *prog)
3306 float *pos,*scale,*rgb;
3310 VM_SAFEPARMCOUNT(6,VM_drawcharacter);
3312 character = (char) PRVM_G_FLOAT(OFS_PARM1);
3315 PRVM_G_FLOAT(OFS_RETURN) = -1;
3316 VM_Warning(prog, "VM_drawcharacter: %s passed null character !\n",prog->name);
3320 pos = PRVM_G_VECTOR(OFS_PARM0);
3321 scale = PRVM_G_VECTOR(OFS_PARM2);
3322 rgb = PRVM_G_VECTOR(OFS_PARM3);
3323 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3325 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3327 PRVM_G_FLOAT(OFS_RETURN) = -2;
3328 VM_Warning(prog, "VM_drawcharacter: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3332 if(pos[2] || scale[2])
3333 Con_Printf("VM_drawcharacter: z value%c from %s discarded\n",(pos[2] && scale[2]) ? 's' : 0,((pos[2] && scale[2]) ? "pos and scale" : (pos[2] ? "pos" : "scale")));
3335 if(!scale[0] || !scale[1])
3337 PRVM_G_FLOAT(OFS_RETURN) = -3;
3338 VM_Warning(prog, "VM_drawcharacter: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3342 getdrawfontscale(prog, &sx, &sy);
3343 DrawQ_String_Scale(pos[0], pos[1], &character, 1, scale[0], scale[1], sx, sy, rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM4), flag, NULL, true, getdrawfont(prog));
3344 PRVM_G_FLOAT(OFS_RETURN) = 1;
3351 float drawstring(vector position, string text, vector scale, vector rgb, float alpha[, float flag])
3354 void VM_drawstring(prvm_prog_t *prog)
3356 float *pos,*scale,*rgb;
3360 VM_SAFEPARMCOUNTRANGE(5,6,VM_drawstring);
3362 string = PRVM_G_STRING(OFS_PARM1);
3363 pos = PRVM_G_VECTOR(OFS_PARM0);
3364 scale = PRVM_G_VECTOR(OFS_PARM2);
3365 rgb = PRVM_G_VECTOR(OFS_PARM3);
3366 if (prog->argc >= 6)
3367 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3369 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3371 PRVM_G_FLOAT(OFS_RETURN) = -2;
3372 VM_Warning(prog, "VM_drawstring: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3376 if(!scale[0] || !scale[1])
3378 PRVM_G_FLOAT(OFS_RETURN) = -3;
3379 VM_Warning(prog, "VM_drawstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3383 if(pos[2] || scale[2])
3384 Con_Printf("VM_drawstring: z value%s from %s discarded\n",(pos[2] && scale[2]) ? "s" : " ",((pos[2] && scale[2]) ? "pos and scale" : (pos[2] ? "pos" : "scale")));
3386 getdrawfontscale(prog, &sx, &sy);
3387 DrawQ_String_Scale(pos[0], pos[1], string, 0, scale[0], scale[1], sx, sy, rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM4), flag, NULL, true, getdrawfont(prog));
3388 //Font_DrawString(pos[0], pos[1], string, 0, scale[0], scale[1], rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM4), flag, NULL, true);
3389 PRVM_G_FLOAT(OFS_RETURN) = 1;
3394 VM_drawcolorcodedstring
3396 float drawcolorcodedstring(vector position, string text, vector scale, float alpha, float flag)
3398 float drawcolorcodedstring(vector position, string text, vector scale, vector rgb, float alpha, float flag)
3401 void VM_drawcolorcodedstring(prvm_prog_t *prog)
3407 float sx, sy, alpha;
3409 VM_SAFEPARMCOUNTRANGE(5,6,VM_drawcolorcodedstring);
3411 if (prog->argc == 6) // full 6 parms, like normal drawstring
3413 pos = PRVM_G_VECTOR(OFS_PARM0);
3414 string = PRVM_G_STRING(OFS_PARM1);
3415 scale = PRVM_G_VECTOR(OFS_PARM2);
3416 VectorCopy(PRVM_G_VECTOR(OFS_PARM3), rgb);
3417 alpha = PRVM_G_FLOAT(OFS_PARM4);
3418 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3422 pos = PRVM_G_VECTOR(OFS_PARM0);
3423 string = PRVM_G_STRING(OFS_PARM1);
3424 scale = PRVM_G_VECTOR(OFS_PARM2);
3428 alpha = PRVM_G_FLOAT(OFS_PARM3);
3429 flag = (int)PRVM_G_FLOAT(OFS_PARM4);
3432 if(flag < DRAWFLAG_NORMAL || flag >= DRAWFLAG_NUMFLAGS)
3434 PRVM_G_FLOAT(OFS_RETURN) = -2;
3435 VM_Warning(prog, "VM_drawcolorcodedstring: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3439 if(!scale[0] || !scale[1])
3441 PRVM_G_FLOAT(OFS_RETURN) = -3;
3442 VM_Warning(prog, "VM_drawcolorcodedstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3446 if(pos[2] || scale[2])
3447 Con_Printf("VM_drawcolorcodedstring: z value%s from %s discarded\n",(pos[2] && scale[2]) ? "s" : " ",((pos[2] && scale[2]) ? "pos and scale" : (pos[2] ? "pos" : "scale")));
3449 getdrawfontscale(prog, &sx, &sy);
3450 DrawQ_String_Scale(pos[0], pos[1], string, 0, scale[0], scale[1], sx, sy, rgb[0], rgb[1], rgb[2], alpha, flag, NULL, false, getdrawfont(prog));
3451 if (prog->argc == 6) // also return vector of last color
3452 VectorCopy(DrawQ_Color, PRVM_G_VECTOR(OFS_RETURN));
3454 PRVM_G_FLOAT(OFS_RETURN) = 1;
3460 float stringwidth(string text, float allowColorCodes, float size)
3463 void VM_stringwidth(prvm_prog_t *prog)
3467 float mult; // sz is intended font size so we can later add freetype support, mult is font size multiplier in pixels per character cell
3471 VM_SAFEPARMCOUNTRANGE(2,3,VM_drawstring);
3473 getdrawfontscale(prog, &sx, &sy);
3476 szv = PRVM_G_VECTOR(OFS_PARM2);
3481 // we want the width for 8x8 font size, divided by 8
3482 static float defsize[] = {8, 8};
3485 // to make sure snapping is turned off, ALWAYS use a nontrivial scale in this case
3486 if(sx >= 0.9 && sx <= 1.1)
3494 string = PRVM_G_STRING(OFS_PARM0);
3495 colors = (int)PRVM_G_FLOAT(OFS_PARM1);
3497 PRVM_G_FLOAT(OFS_RETURN) = DrawQ_TextWidth_UntilWidth_TrackColors_Scale(string, &maxlen, szv[0], szv[1], sx, sy, NULL, !colors, getdrawfont(prog), 1000000000) * mult;
3501 mult = sz = PRVM_G_FLOAT(OFS_PARM2);
3509 string = PRVM_G_STRING(OFS_PARM0);
3510 colors = (int)PRVM_G_FLOAT(OFS_PARM1);
3512 PRVM_G_FLOAT(OFS_RETURN) = DrawQ_TextWidth(string, 0, !colors, getdrawfont()) * mult; // 1x1 characters, don't actually draw
3520 float findfont(string s)
3524 static float getdrawfontnum(const char *fontname)
3528 for(i = 0; i < dp_fonts.maxsize; ++i)
3529 if(!strcmp(dp_fonts.f[i].title, fontname))
3534 void VM_findfont(prvm_prog_t *prog)
3536 VM_SAFEPARMCOUNT(1,VM_findfont);
3537 PRVM_G_FLOAT(OFS_RETURN) = getdrawfontnum(PRVM_G_STRING(OFS_PARM0));
3544 float loadfont(string fontname, string fontmaps, string sizes, float slot)
3548 void VM_loadfont(prvm_prog_t *prog)
3550 const char *fontname, *filelist, *sizes, *c, *cm;
3551 char mainfont[MAX_QPATH];
3553 float sz, scale, voffset;
3556 VM_SAFEPARMCOUNTRANGE(3,6,VM_loadfont);
3558 fontname = PRVM_G_STRING(OFS_PARM0);
3560 fontname = "default";
3562 filelist = PRVM_G_STRING(OFS_PARM1);
3564 filelist = "gfx/conchars";
3566 sizes = PRVM_G_STRING(OFS_PARM2);
3572 if (prog->argc >= 4)
3574 i = PRVM_G_FLOAT(OFS_PARM3);
3575 if (i >= 0 && i < dp_fonts.maxsize)
3578 strlcpy(f->title, fontname, sizeof(f->title)); // replace name
3582 f = FindFont(fontname, true);
3585 PRVM_G_FLOAT(OFS_RETURN) = -1;
3586 return; // something go wrong
3589 memset(f->fallbacks, 0, sizeof(f->fallbacks));
3590 memset(f->fallback_faces, 0, sizeof(f->fallback_faces));
3592 // first font is handled "normally"
3593 c = strchr(filelist, ':');
3594 cm = strchr(filelist, ',');
3595 if(c && (!cm || c < cm))
3596 f->req_face = atoi(c+1);
3602 if(!c || (c - filelist) > MAX_QPATH)
3603 strlcpy(mainfont, filelist, sizeof(mainfont));
3606 memcpy(mainfont, filelist, c - filelist);
3607 mainfont[c - filelist] = 0;
3611 for(i = 0; i < MAX_FONT_FALLBACKS; ++i)
3613 c = strchr(filelist, ',');
3619 c = strchr(filelist, ':');
3620 cm = strchr(filelist, ',');
3621 if(c && (!cm || c < cm))
3622 f->fallback_faces[i] = atoi(c+1);
3625 f->fallback_faces[i] = 0; // f->req_face; could make it stick to the default-font's face index
3628 if(!c || (c-filelist) > MAX_QPATH)
3630 strlcpy(f->fallbacks[i], filelist, sizeof(mainfont));
3634 memcpy(f->fallbacks[i], filelist, c - filelist);
3635 f->fallbacks[i][c - filelist] = 0;
3640 for(i = 0; i < MAX_FONT_SIZES; ++i)
3641 f->req_sizes[i] = -1;
3642 for (numsizes = 0,c = sizes;;)
3644 if (!COM_ParseToken_VM_Tokenize(&c, 0))
3646 sz = atof(com_token);
3648 if (sz < 0.001f || sz > 1000.0f)
3650 VM_Warning(prog, "VM_loadfont: crap size %s", com_token);
3654 if (numsizes == MAX_FONT_SIZES)
3656 VM_Warning(prog, "VM_loadfont: MAX_FONT_SIZES = %i exceeded", MAX_FONT_SIZES);
3659 f->req_sizes[numsizes] = sz;
3663 // additional scale/hoffset parms
3666 if (prog->argc >= 5)
3668 scale = PRVM_G_FLOAT(OFS_PARM4);
3672 if (prog->argc >= 6)
3673 voffset = PRVM_G_FLOAT(OFS_PARM5);
3676 LoadFont(true, mainfont, f, scale, voffset);
3678 // return index of loaded font
3679 PRVM_G_FLOAT(OFS_RETURN) = (f - dp_fonts.f);
3686 float drawpic(vector position, string pic, vector size, vector rgb, float alpha, float flag)
3689 void VM_drawpic(prvm_prog_t *prog)
3691 const char *picname;
3692 float *size, *pos, *rgb;
3695 VM_SAFEPARMCOUNTRANGE(5,6,VM_drawpic);
3697 picname = PRVM_G_STRING(OFS_PARM1);
3698 VM_CheckEmptyString(prog, picname);
3700 // is pic cached ? no function yet for that
3703 PRVM_G_FLOAT(OFS_RETURN) = -4;
3704 VM_Warning(prog, "VM_drawpic: %s: %s not cached !\n", prog->name, picname);
3708 pos = PRVM_G_VECTOR(OFS_PARM0);
3709 size = PRVM_G_VECTOR(OFS_PARM2);
3710 rgb = PRVM_G_VECTOR(OFS_PARM3);
3711 if (prog->argc >= 6)
3712 flag = (int) PRVM_G_FLOAT(OFS_PARM5);
3714 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3716 PRVM_G_FLOAT(OFS_RETURN) = -2;
3717 VM_Warning(prog, "VM_drawpic: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3721 if(pos[2] || size[2])
3722 Con_Printf("VM_drawpic: z value%s from %s discarded\n",(pos[2] && size[2]) ? "s" : " ",((pos[2] && size[2]) ? "pos and size" : (pos[2] ? "pos" : "size")));
3724 DrawQ_Pic(pos[0], pos[1], Draw_CachePic_Flags (picname, CACHEPICFLAG_NOTPERSISTENT), size[0], size[1], rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM4), flag);
3725 PRVM_G_FLOAT(OFS_RETURN) = 1;
3731 float drawrotpic(vector position, string pic, vector size, vector org, float angle, vector rgb, float alpha, float flag)
3734 void VM_drawrotpic(prvm_prog_t *prog)
3736 const char *picname;
3737 float *size, *pos, *org, *rgb;
3740 VM_SAFEPARMCOUNT(8,VM_drawrotpic);
3742 picname = PRVM_G_STRING(OFS_PARM1);
3743 VM_CheckEmptyString(prog, picname);
3745 // is pic cached ? no function yet for that
3748 PRVM_G_FLOAT(OFS_RETURN) = -4;
3749 VM_Warning(prog, "VM_drawrotpic: %s: %s not cached !\n", prog->name, picname);
3753 pos = PRVM_G_VECTOR(OFS_PARM0);
3754 size = PRVM_G_VECTOR(OFS_PARM2);
3755 org = PRVM_G_VECTOR(OFS_PARM3);
3756 rgb = PRVM_G_VECTOR(OFS_PARM5);
3757 flag = (int) PRVM_G_FLOAT(OFS_PARM7);
3759 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3761 PRVM_G_FLOAT(OFS_RETURN) = -2;
3762 VM_Warning(prog, "VM_drawrotpic: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3766 if(pos[2] || size[2] || org[2])
3767 Con_Printf("VM_drawrotpic: z value from pos/size/org discarded\n");
3769 DrawQ_RotPic(pos[0], pos[1], Draw_CachePic_Flags(picname, CACHEPICFLAG_NOTPERSISTENT), size[0], size[1], org[0], org[1], PRVM_G_FLOAT(OFS_PARM4), rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM6), flag);
3770 PRVM_G_FLOAT(OFS_RETURN) = 1;
3776 float drawsubpic(vector position, vector size, string pic, vector srcPos, vector srcSize, vector rgb, float alpha, float flag)
3780 void VM_drawsubpic(prvm_prog_t *prog)
3782 const char *picname;
3783 float *size, *pos, *rgb, *srcPos, *srcSize, alpha;
3786 VM_SAFEPARMCOUNT(8,VM_drawsubpic);
3788 picname = PRVM_G_STRING(OFS_PARM2);
3789 VM_CheckEmptyString(prog, picname);
3791 // is pic cached ? no function yet for that
3794 PRVM_G_FLOAT(OFS_RETURN) = -4;
3795 VM_Warning(prog, "VM_drawsubpic: %s: %s not cached !\n", prog->name, picname);
3799 pos = PRVM_G_VECTOR(OFS_PARM0);
3800 size = PRVM_G_VECTOR(OFS_PARM1);
3801 srcPos = PRVM_G_VECTOR(OFS_PARM3);
3802 srcSize = PRVM_G_VECTOR(OFS_PARM4);
3803 rgb = PRVM_G_VECTOR(OFS_PARM5);
3804 alpha = PRVM_G_FLOAT(OFS_PARM6);
3805 flag = (int) PRVM_G_FLOAT(OFS_PARM7);
3807 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3809 PRVM_G_FLOAT(OFS_RETURN) = -2;
3810 VM_Warning(prog, "VM_drawsubpic: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3814 if(pos[2] || size[2])
3815 Con_Printf("VM_drawsubpic: z value%s from %s discarded\n",(pos[2] && size[2]) ? "s" : " ",((pos[2] && size[2]) ? "pos and size" : (pos[2] ? "pos" : "size")));
3817 DrawQ_SuperPic(pos[0], pos[1], Draw_CachePic_Flags (picname, CACHEPICFLAG_NOTPERSISTENT),
3819 srcPos[0], srcPos[1], rgb[0], rgb[1], rgb[2], alpha,
3820 srcPos[0] + srcSize[0], srcPos[1], rgb[0], rgb[1], rgb[2], alpha,
3821 srcPos[0], srcPos[1] + srcSize[1], rgb[0], rgb[1], rgb[2], alpha,
3822 srcPos[0] + srcSize[0], srcPos[1] + srcSize[1], rgb[0], rgb[1], rgb[2], alpha,
3824 PRVM_G_FLOAT(OFS_RETURN) = 1;
3831 float drawfill(vector position, vector size, vector rgb, float alpha, float flag)
3834 void VM_drawfill(prvm_prog_t *prog)
3836 float *size, *pos, *rgb;
3839 VM_SAFEPARMCOUNT(5,VM_drawfill);
3842 pos = PRVM_G_VECTOR(OFS_PARM0);
3843 size = PRVM_G_VECTOR(OFS_PARM1);
3844 rgb = PRVM_G_VECTOR(OFS_PARM2);
3845 flag = (int) PRVM_G_FLOAT(OFS_PARM4);
3847 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3849 PRVM_G_FLOAT(OFS_RETURN) = -2;
3850 VM_Warning(prog, "VM_drawfill: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3854 if(pos[2] || size[2])
3855 Con_Printf("VM_drawfill: z value%s from %s discarded\n",(pos[2] && size[2]) ? "s" : " ",((pos[2] && size[2]) ? "pos and size" : (pos[2] ? "pos" : "size")));
3857 DrawQ_Fill(pos[0], pos[1], size[0], size[1], rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM3), flag);
3858 PRVM_G_FLOAT(OFS_RETURN) = 1;
3865 drawsetcliparea(float x, float y, float width, float height)
3868 void VM_drawsetcliparea(prvm_prog_t *prog)
3871 VM_SAFEPARMCOUNT(4,VM_drawsetcliparea);
3873 x = bound(0, PRVM_G_FLOAT(OFS_PARM0), vid_conwidth.integer);
3874 y = bound(0, PRVM_G_FLOAT(OFS_PARM1), vid_conheight.integer);
3875 w = bound(0, PRVM_G_FLOAT(OFS_PARM2) + PRVM_G_FLOAT(OFS_PARM0) - x, (vid_conwidth.integer - x));
3876 h = bound(0, PRVM_G_FLOAT(OFS_PARM3) + PRVM_G_FLOAT(OFS_PARM1) - y, (vid_conheight.integer - y));
3878 DrawQ_SetClipArea(x, y, w, h);
3883 VM_drawresetcliparea
3888 void VM_drawresetcliparea(prvm_prog_t *prog)
3890 VM_SAFEPARMCOUNT(0,VM_drawresetcliparea);
3892 DrawQ_ResetClipArea();
3899 vector getimagesize(string pic)
3902 void VM_getimagesize(prvm_prog_t *prog)
3907 VM_SAFEPARMCOUNT(1,VM_getimagesize);
3909 p = PRVM_G_STRING(OFS_PARM0);
3910 VM_CheckEmptyString(prog, p);
3912 pic = Draw_CachePic_Flags (p, CACHEPICFLAG_NOTPERSISTENT);
3914 PRVM_G_VECTOR(OFS_RETURN)[0] = pic->width;
3915 PRVM_G_VECTOR(OFS_RETURN)[1] = pic->height;
3916 PRVM_G_VECTOR(OFS_RETURN)[2] = 0;
3923 string keynumtostring(float keynum)
3926 void VM_keynumtostring (prvm_prog_t *prog)
3929 VM_SAFEPARMCOUNT(1, VM_keynumtostring);
3931 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_KeynumToString((int)PRVM_G_FLOAT(OFS_PARM0), tinystr, sizeof(tinystr)));
3936 VM_findkeysforcommand
3938 string findkeysforcommand(string command, float bindmap)
3940 the returned string is an altstring
3943 #define FKFC_NUMKEYS 5
3944 void M_FindKeysForCommand(const char *command, int *keys);
3945 void VM_findkeysforcommand(prvm_prog_t *prog)
3948 char ret[VM_STRINGTEMP_LENGTH];
3949 int keys[FKFC_NUMKEYS];
3954 VM_SAFEPARMCOUNTRANGE(1, 2, VM_findkeysforcommand);
3956 cmd = PRVM_G_STRING(OFS_PARM0);
3958 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
3960 bindmap = 0; // consistent to "bind"
3962 VM_CheckEmptyString(prog, cmd);
3964 Key_FindKeysForCommand(cmd, keys, FKFC_NUMKEYS, bindmap);
3967 for(i = 0; i < FKFC_NUMKEYS; i++)
3968 strlcat(ret, va(vabuf, sizeof(vabuf), " \'%i\'", keys[i]), sizeof(ret));
3970 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, ret);
3977 float stringtokeynum(string key)
3980 void VM_stringtokeynum (prvm_prog_t *prog)
3982 VM_SAFEPARMCOUNT( 1, VM_keynumtostring );
3984 PRVM_G_FLOAT(OFS_RETURN) = Key_StringToKeynum(PRVM_G_STRING(OFS_PARM0));
3991 string getkeybind(float key, float bindmap)
3994 void VM_getkeybind (prvm_prog_t *prog)
3997 VM_SAFEPARMCOUNTRANGE(1, 2, VM_CL_getkeybind);
3999 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
4001 bindmap = 0; // consistent to "bind"
4003 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_GetBind((int)PRVM_G_FLOAT(OFS_PARM0), bindmap));
4010 float setkeybind(float key, string cmd, float bindmap)
4013 void VM_setkeybind (prvm_prog_t *prog)
4016 VM_SAFEPARMCOUNTRANGE(2, 3, VM_CL_setkeybind);
4018 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM2), MAX_BINDMAPS-1);
4020 bindmap = 0; // consistent to "bind"
4022 PRVM_G_FLOAT(OFS_RETURN) = 0;
4023 if(Key_SetBinding((int)PRVM_G_FLOAT(OFS_PARM0), bindmap, PRVM_G_STRING(OFS_PARM1)))
4024 PRVM_G_FLOAT(OFS_RETURN) = 1;
4031 vector getbindmaps()
4034 void VM_getbindmaps (prvm_prog_t *prog)
4037 VM_SAFEPARMCOUNT(0, VM_CL_getbindmap);
4038 Key_GetBindMap(&fg, &bg);
4039 PRVM_G_VECTOR(OFS_RETURN)[0] = fg;
4040 PRVM_G_VECTOR(OFS_RETURN)[1] = bg;
4041 PRVM_G_VECTOR(OFS_RETURN)[2] = 0;
4048 float setbindmaps(vector bindmap)
4051 void VM_setbindmaps (prvm_prog_t *prog)
4053 VM_SAFEPARMCOUNT(1, VM_CL_setbindmap);
4054 PRVM_G_FLOAT(OFS_RETURN) = 0;
4055 if(PRVM_G_VECTOR(OFS_PARM0)[2] == 0)
4056 if(Key_SetBindMap((int)PRVM_G_VECTOR(OFS_PARM0)[0], (int)PRVM_G_VECTOR(OFS_PARM0)[1]))
4057 PRVM_G_FLOAT(OFS_RETURN) = 1;
4060 // CL_Video interface functions
4063 ========================
4066 float cin_open(string file, string name)
4067 ========================
4069 void VM_cin_open(prvm_prog_t *prog)
4074 VM_SAFEPARMCOUNT( 2, VM_cin_open );
4076 file = PRVM_G_STRING( OFS_PARM0 );
4077 name = PRVM_G_STRING( OFS_PARM1 );
4079 VM_CheckEmptyString(prog, file );
4080 VM_CheckEmptyString(prog, name );
4082 if( CL_OpenVideo( file, name, MENUOWNER, "" ) )
4083 PRVM_G_FLOAT( OFS_RETURN ) = 1;
4085 PRVM_G_FLOAT( OFS_RETURN ) = 0;
4089 ========================
4092 void cin_close(string name)
4093 ========================
4095 void VM_cin_close(prvm_prog_t *prog)
4099 VM_SAFEPARMCOUNT( 1, VM_cin_close );
4101 name = PRVM_G_STRING( OFS_PARM0 );
4102 VM_CheckEmptyString(prog, name );
4104 CL_CloseVideo( CL_GetVideoByName( name ) );
4108 ========================
4110 void cin_setstate(string name, float type)
4111 ========================
4113 void VM_cin_setstate(prvm_prog_t *prog)
4116 clvideostate_t state;
4119 VM_SAFEPARMCOUNT( 2, VM_cin_netstate );
4121 name = PRVM_G_STRING( OFS_PARM0 );
4122 VM_CheckEmptyString(prog, name );
4124 state = (clvideostate_t)((int)PRVM_G_FLOAT( OFS_PARM1 ));
4126 video = CL_GetVideoByName( name );
4127 if( video && state > CLVIDEO_UNUSED && state < CLVIDEO_STATECOUNT )
4128 CL_SetVideoState( video, state );
4132 ========================
4135 float cin_getstate(string name)
4136 ========================
4138 void VM_cin_getstate(prvm_prog_t *prog)
4143 VM_SAFEPARMCOUNT( 1, VM_cin_getstate );
4145 name = PRVM_G_STRING( OFS_PARM0 );
4146 VM_CheckEmptyString(prog, name );
4148 video = CL_GetVideoByName( name );
4150 PRVM_G_FLOAT( OFS_RETURN ) = (int)video->state;
4152 PRVM_G_FLOAT( OFS_RETURN ) = 0;
4156 ========================
4159 void cin_restart(string name)
4160 ========================
4162 void VM_cin_restart(prvm_prog_t *prog)
4167 VM_SAFEPARMCOUNT( 1, VM_cin_restart );
4169 name = PRVM_G_STRING( OFS_PARM0 );
4170 VM_CheckEmptyString(prog, name );
4172 video = CL_GetVideoByName( name );
4174 CL_RestartVideo( video );
4178 ========================
4181 float[bool] gecko_create( string name )
4182 ========================
4184 void VM_gecko_create(prvm_prog_t *prog) {
4186 PRVM_G_FLOAT( OFS_RETURN ) = 0;
4190 ========================
4193 void gecko_destroy( string name )
4194 ========================
4196 void VM_gecko_destroy(prvm_prog_t *prog) {
4201 ========================
4204 void gecko_navigate( string name, string URI )
4205 ========================
4207 void VM_gecko_navigate(prvm_prog_t *prog) {
4212 ========================
4215 float[bool] gecko_keyevent( string name, float key, float eventtype )
4216 ========================
4218 void VM_gecko_keyevent(prvm_prog_t *prog) {
4220 PRVM_G_FLOAT( OFS_RETURN ) = 0;
4224 ========================
4227 void gecko_mousemove( string name, float x, float y )
4228 ========================
4230 void VM_gecko_movemouse(prvm_prog_t *prog) {
4236 ========================
4239 void gecko_resize( string name, float w, float h )
4240 ========================
4242 void VM_gecko_resize(prvm_prog_t *prog) {
4248 ========================
4249 VM_gecko_get_texture_extent
4251 vector gecko_get_texture_extent( string name )
4252 ========================
4254 void VM_gecko_get_texture_extent(prvm_prog_t *prog) {
4256 PRVM_G_VECTOR(OFS_RETURN)[0] = 0;
4257 PRVM_G_VECTOR(OFS_RETURN)[1] = 0;
4266 Writes new values for v_forward, v_up, and v_right based on angles
4267 void makevectors(vector angle)
4270 void VM_makevectors (prvm_prog_t *prog)
4272 VM_SAFEPARMCOUNT(1, VM_makevectors);
4273 AngleVectors(PRVM_G_VECTOR(OFS_PARM0), PRVM_gameglobalvector(v_forward), PRVM_gameglobalvector(v_right), PRVM_gameglobalvector(v_up));
4280 Writes new values for v_forward, v_up, and v_right based on the given forward vector
4281 vectorvectors(vector)
4284 void VM_vectorvectors (prvm_prog_t *prog)
4286 VM_SAFEPARMCOUNT(1, VM_vectorvectors);
4287 VectorNormalize2(PRVM_G_VECTOR(OFS_PARM0), PRVM_gameglobalvector(v_forward));
4288 VectorVectors(PRVM_gameglobalvector(v_forward), PRVM_gameglobalvector(v_right), PRVM_gameglobalvector(v_up));
4292 ========================
4295 void drawline(float width, vector pos1, vector pos2, vector rgb, float alpha, float flags)
4296 ========================
4298 void VM_drawline (prvm_prog_t *prog)
4300 float *c1, *c2, *rgb;
4302 unsigned char flags;
4304 VM_SAFEPARMCOUNT(6, VM_drawline);
4305 width = PRVM_G_FLOAT(OFS_PARM0);
4306 c1 = PRVM_G_VECTOR(OFS_PARM1);
4307 c2 = PRVM_G_VECTOR(OFS_PARM2);
4308 rgb = PRVM_G_VECTOR(OFS_PARM3);
4309 alpha = PRVM_G_FLOAT(OFS_PARM4);
4310 flags = (int)PRVM_G_FLOAT(OFS_PARM5);
4311 DrawQ_Line(width, c1[0], c1[1], c2[0], c2[1], rgb[0], rgb[1], rgb[2], alpha, flags);
4314 // float(float number, float quantity) bitshift (EXT_BITSHIFT)
4315 void VM_bitshift (prvm_prog_t *prog)
4318 VM_SAFEPARMCOUNT(2, VM_bitshift);
4320 n1 = (int)fabs((float)((int)PRVM_G_FLOAT(OFS_PARM0)));
4321 n2 = (int)PRVM_G_FLOAT(OFS_PARM1);
4323 PRVM_G_FLOAT(OFS_RETURN) = n1;
4326 PRVM_G_FLOAT(OFS_RETURN) = (n1 >> -n2);
4328 PRVM_G_FLOAT(OFS_RETURN) = (n1 << n2);
4331 ////////////////////////////////////////
4332 // AltString functions
4333 ////////////////////////////////////////
4336 ========================
4339 float altstr_count(string)
4340 ========================
4342 void VM_altstr_count(prvm_prog_t *prog)
4344 const char *altstr, *pos;
4347 VM_SAFEPARMCOUNT( 1, VM_altstr_count );
4349 altstr = PRVM_G_STRING( OFS_PARM0 );
4350 //VM_CheckEmptyString(prog, altstr );
4352 for( count = 0, pos = altstr ; *pos ; pos++ ) {
4353 if( *pos == '\\' ) {
4357 } else if( *pos == '\'' ) {
4362 PRVM_G_FLOAT( OFS_RETURN ) = (float) (count / 2);
4366 ========================
4369 string altstr_prepare(string)
4370 ========================
4372 void VM_altstr_prepare(prvm_prog_t *prog)
4375 const char *instr, *in;
4377 char outstr[VM_STRINGTEMP_LENGTH];
4379 VM_SAFEPARMCOUNT( 1, VM_altstr_prepare );
4381 instr = PRVM_G_STRING( OFS_PARM0 );
4383 for( out = outstr, in = instr, size = sizeof(outstr) - 1 ; size && *in ; size--, in++, out++ )
4392 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
4396 ========================
4399 string altstr_get(string, float)
4400 ========================
4402 void VM_altstr_get(prvm_prog_t *prog)
4404 const char *altstr, *pos;
4407 char outstr[VM_STRINGTEMP_LENGTH];
4409 VM_SAFEPARMCOUNT( 2, VM_altstr_get );
4411 altstr = PRVM_G_STRING( OFS_PARM0 );
4413 count = (int)PRVM_G_FLOAT( OFS_PARM1 );
4414 count = count * 2 + 1;
4416 for( pos = altstr ; *pos && count ; pos++ )
4417 if( *pos == '\\' ) {
4420 } else if( *pos == '\'' )
4424 PRVM_G_INT( OFS_RETURN ) = 0;
4428 for( out = outstr, size = sizeof(outstr) - 1 ; size && *pos ; size--, pos++, out++ )
4429 if( *pos == '\\' ) {
4434 } else if( *pos == '\'' )
4440 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
4444 ========================
4447 string altstr_set(string altstr, float num, string set)
4448 ========================
4450 void VM_altstr_set(prvm_prog_t *prog)
4453 const char *altstr, *str;
4456 char outstr[VM_STRINGTEMP_LENGTH];
4458 VM_SAFEPARMCOUNT( 3, VM_altstr_set );
4460 altstr = PRVM_G_STRING( OFS_PARM0 );
4462 num = (int)PRVM_G_FLOAT( OFS_PARM1 );
4464 str = PRVM_G_STRING( OFS_PARM2 );
4467 for( num = num * 2 + 1, in = altstr; *in && num; *out++ = *in++ )
4472 } else if( *in == '\'' ) {
4477 for( ; *str; *out++ = *str++ );
4478 // now jump over the old content
4480 if( *in == '\'' || (*in == '\\' && !*++in) )
4483 strlcpy(out, in, outstr + sizeof(outstr) - out);
4484 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
4488 ========================
4491 string altstr_ins(string altstr, float num, string set)
4492 ========================
4494 void VM_altstr_ins(prvm_prog_t *prog)