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;
20 extern dllhandle_t ode_dll;
22 // LordHavoc: changed this to NOT use a return statement, so that it can be used in functions that must return a value
23 void VM_Warning(prvm_prog_t *prog, const char *fmt, ...)
26 char msg[MAX_INPUTLINE];
27 static double recursive = -1;
30 dpvsnprintf(msg,sizeof(msg),fmt,argptr);
35 // TODO: either add a cvar/cmd to control the state dumping or replace some of the calls with Con_Printf [9/13/2006 Black]
36 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
39 PRVM_PrintState(prog);
45 //============================================================================
48 // TODO DONE: move vm_files and vm_fssearchlist to prvm_prog_t struct
49 // TODO: move vm_files and vm_fssearchlist back [9/13/2006 Black]
50 // TODO: (move vm_files and vm_fssearchlist to prvm_prog_t struct again) [2007-01-23 LordHavoc]
51 // TODO: will this war ever end? [2007-01-23 LordHavoc]
53 void VM_CheckEmptyString(prvm_prog_t *prog, const char *s)
55 if (ISWHITESPACE(s[0]))
56 prog->error_cmd("%s: Bad string", prog->name);
59 void VM_GenerateFrameGroupBlend(prvm_prog_t *prog, framegroupblend_t *framegroupblend, const prvm_edict_t *ed)
61 // self.frame is the interpolation target (new frame)
62 // self.frame1time is the animation base time for the interpolation target
63 // self.frame2 is the interpolation start (previous frame)
64 // self.frame2time is the animation base time for the interpolation start
65 // self.lerpfrac is the interpolation strength for self.frame2
66 // self.lerpfrac3 is the interpolation strength for self.frame3
67 // self.lerpfrac4 is the interpolation strength for self.frame4
68 // pitch angle on a player model where the animator set up 5 sets of
69 // animations and the csqc simply lerps between sets)
70 framegroupblend[0].frame = (int) PRVM_gameedictfloat(ed, frame );
71 framegroupblend[1].frame = (int) PRVM_gameedictfloat(ed, frame2 );
72 framegroupblend[2].frame = (int) PRVM_gameedictfloat(ed, frame3 );
73 framegroupblend[3].frame = (int) PRVM_gameedictfloat(ed, frame4 );
74 framegroupblend[0].start = PRVM_gameedictfloat(ed, frame1time);
75 framegroupblend[1].start = PRVM_gameedictfloat(ed, frame2time);
76 framegroupblend[2].start = PRVM_gameedictfloat(ed, frame3time);
77 framegroupblend[3].start = PRVM_gameedictfloat(ed, frame4time);
78 framegroupblend[1].lerp = PRVM_gameedictfloat(ed, lerpfrac );
79 framegroupblend[2].lerp = PRVM_gameedictfloat(ed, lerpfrac3 );
80 framegroupblend[3].lerp = PRVM_gameedictfloat(ed, lerpfrac4 );
81 // assume that the (missing) lerpfrac1 is whatever remains after lerpfrac2+lerpfrac3+lerpfrac4 are summed
82 framegroupblend[0].lerp = 1 - framegroupblend[1].lerp - framegroupblend[2].lerp - framegroupblend[3].lerp;
85 // LordHavoc: quite tempting to break apart this function to reuse the
86 // duplicated code, but I suspect it is better for performance
88 void VM_FrameBlendFromFrameGroupBlend(frameblend_t *frameblend, const framegroupblend_t *framegroupblend, const dp_model_t *model, double curtime)
90 int sub2, numframes, f, i, k;
91 int isfirstframegroup = true;
93 double sublerp, lerp, d;
94 const animscene_t *scene;
95 const framegroupblend_t *g;
96 frameblend_t *blend = frameblend;
98 memset(blend, 0, MAX_FRAMEBLENDS * sizeof(*blend));
100 if (!model || !model->surfmesh.isanimated)
106 nolerp = (model->type == mod_sprite) ? !r_lerpsprites.integer : !r_lerpmodels.integer;
107 numframes = model->numframes;
108 for (k = 0, g = framegroupblend;k < MAX_FRAMEGROUPBLENDS;k++, g++)
111 if ((unsigned int)f >= (unsigned int)numframes)
113 if (developer_extra.integer)
114 Con_DPrintf("VM_FrameBlendFromFrameGroupBlend: no such frame %d in model %s\n", f, model->name);
122 if (isfirstframegroup)
125 isfirstframegroup = false;
130 if (model->animscenes)
132 scene = model->animscenes + f;
133 f = scene->firstframe;
134 if (scene->framecount > 1)
136 // this code path is only used on .zym models and torches
137 sublerp = scene->framerate * (curtime - g->start);
138 f = (int) floor(sublerp);
141 if (sublerp < (1.0 / 65536.0f))
143 if (sublerp > (65535.0f / 65536.0f))
149 f = (f % scene->framecount);
150 sub2 = (sub2 % scene->framecount);
152 f = bound(0, f, (scene->framecount - 1)) + scene->firstframe;
153 sub2 = bound(0, sub2, (scene->framecount - 1)) + scene->firstframe;
155 // two framelerps produced from one animation
158 for (i = 0;i < MAX_FRAMEBLENDS;i++)
160 if (blend[i].lerp <= 0 || blend[i].subframe == sub2)
162 blend[i].subframe = sub2;
168 d = (1 - sublerp) * lerp;
173 for (i = 0;i < MAX_FRAMEBLENDS;i++)
175 if (blend[i].lerp <= 0 || blend[i].subframe == f)
177 blend[i].subframe = f;
186 void VM_UpdateEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed, const dp_model_t *edmodel, const frameblend_t *frameblend)
188 if (ed->priv.server->skeleton.model != edmodel)
190 VM_RemoveEdictSkeleton(prog, ed);
191 ed->priv.server->skeleton.model = edmodel;
193 if (!ed->priv.server->skeleton.model || !ed->priv.server->skeleton.model->num_bones)
195 if(ed->priv.server->skeleton.relativetransforms)
196 Mem_Free(ed->priv.server->skeleton.relativetransforms);
197 ed->priv.server->skeleton.relativetransforms = NULL;
202 int skeletonindex = -1;
203 skeleton_t *skeleton;
204 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
205 if (skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones)
207 // custom skeleton controlled by the game (FTE_CSQC_SKELETONOBJECTS)
208 if (!ed->priv.server->skeleton.relativetransforms)
209 ed->priv.server->skeleton.relativetransforms = (matrix4x4_t *)Mem_Alloc(prog->progs_mempool, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
210 memcpy(ed->priv.server->skeleton.relativetransforms, skeleton->relativetransforms, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
214 if(ed->priv.server->skeleton.relativetransforms)
215 Mem_Free(ed->priv.server->skeleton.relativetransforms);
216 ed->priv.server->skeleton.relativetransforms = NULL;
221 void VM_RemoveEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed)
223 if (ed->priv.server->skeleton.relativetransforms)
224 Mem_Free(ed->priv.server->skeleton.relativetransforms);
225 memset(&ed->priv.server->skeleton, 0, sizeof(ed->priv.server->skeleton));
231 //============================================================================
234 void VM_VarString(prvm_prog_t *prog, int first, char *out, int outlength)
240 outend = out + outlength - 1;
241 for (i = first;i < prog->argc && out < outend;i++)
243 s = PRVM_G_STRING((OFS_PARM0+i*3));
244 while (out < outend && *s)
254 returns true if the extension is supported by the server
256 checkextension(extensionname)
260 // kind of helper function
261 static qboolean checkextension(prvm_prog_t *prog, const char *name)
264 const char *e, *start;
265 len = (int)strlen(name);
267 for (e = prog->extensionstring;*e;e++)
274 while (*e && *e != ' ')
276 if ((e - start) == len && !strncasecmp(start, name, len))
278 // special sheck for ODE
279 if (!strncasecmp("DP_PHYSICS_ODE", name, 14))
282 return ode_dll ? true : false;
292 // special sheck for d0_blind_id
293 if (!strcasecmp("DP_CRYPTO", name))
294 return Crypto_Available();
295 if (!strcasecmp("DP_QC_DIGEST_SHA256", name))
296 return Crypto_Available();
304 void VM_checkextension(prvm_prog_t *prog)
306 VM_SAFEPARMCOUNT(1,VM_checkextension);
308 PRVM_G_FLOAT(OFS_RETURN) = checkextension(prog, PRVM_G_STRING(OFS_PARM0));
315 This is a TERMINAL error, which will kill off the entire prog.
321 void VM_error(prvm_prog_t *prog)
324 char string[VM_STRINGTEMP_LENGTH];
326 VM_VarString(prog, 0, string, sizeof(string));
327 Con_Printf("======%s ERROR in %s:\n%s\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
328 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
329 PRVM_ED_Print(prog, ed, NULL);
331 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);
338 Dumps out self, then an error message. The program is aborted and self is
339 removed, but the level can continue.
344 void VM_objerror(prvm_prog_t *prog)
347 char string[VM_STRINGTEMP_LENGTH];
349 VM_VarString(prog, 0, string, sizeof(string));
350 Con_Printf("======OBJECT ERROR======\n"); // , prog->name, PRVM_GetString(prog->xfunction->s_name), string); // or include them? FIXME
351 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
352 PRVM_ED_Print(prog, ed, NULL);
353 PRVM_ED_Free (prog, ed);
354 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);
366 void VM_print(prvm_prog_t *prog)
368 char string[VM_STRINGTEMP_LENGTH];
370 VM_VarString(prog, 0, string, sizeof(string));
378 broadcast print to everyone on server
383 void VM_bprint(prvm_prog_t *prog)
385 char string[VM_STRINGTEMP_LENGTH];
389 VM_Warning(prog, "VM_bprint: game is not server(%s) !\n", prog->name);
393 VM_VarString(prog, 0, string, sizeof(string));
394 SV_BroadcastPrint(string);
399 VM_sprint (menu & client but only if server.active == true)
401 single print to a specific client
403 sprint(float clientnum,...[string])
406 void VM_sprint(prvm_prog_t *prog)
410 char string[VM_STRINGTEMP_LENGTH];
412 VM_SAFEPARMCOUNTRANGE(1, 8, VM_sprint);
414 //find client for this entity
415 clientnum = (int)PRVM_G_FLOAT(OFS_PARM0);
416 if (!sv.active || clientnum < 0 || clientnum >= svs.maxclients || !svs.clients[clientnum].active)
418 VM_Warning(prog, "VM_sprint: %s: invalid client or server is not active !\n", prog->name);
422 client = svs.clients + clientnum;
423 if (!client->netconnection)
426 VM_VarString(prog, 1, string, sizeof(string));
427 MSG_WriteChar(&client->netconnection->message,svc_print);
428 MSG_WriteString(&client->netconnection->message, string);
435 single print to the screen
440 void VM_centerprint(prvm_prog_t *prog)
442 char string[VM_STRINGTEMP_LENGTH];
444 VM_SAFEPARMCOUNTRANGE(1, 8, VM_centerprint);
445 VM_VarString(prog, 0, string, sizeof(string));
446 SCR_CenterPrint(string);
453 vector normalize(vector)
456 void VM_normalize(prvm_prog_t *prog)
462 VM_SAFEPARMCOUNT(1,VM_normalize);
464 value1 = PRVM_G_VECTOR(OFS_PARM0);
466 f = VectorLength2(value1);
470 VectorScale(value1, f, newvalue);
473 VectorClear(newvalue);
475 VectorCopy (newvalue, PRVM_G_VECTOR(OFS_RETURN));
485 void VM_vlen(prvm_prog_t *prog)
487 VM_SAFEPARMCOUNT(1,VM_vlen);
488 PRVM_G_FLOAT(OFS_RETURN) = VectorLength(PRVM_G_VECTOR(OFS_PARM0));
495 float vectoyaw(vector)
498 void VM_vectoyaw(prvm_prog_t *prog)
503 VM_SAFEPARMCOUNT(1,VM_vectoyaw);
505 value1 = PRVM_G_VECTOR(OFS_PARM0);
507 if (value1[1] == 0 && value1[0] == 0)
511 yaw = (int) (atan2(value1[1], value1[0]) * 180 / M_PI);
516 PRVM_G_FLOAT(OFS_RETURN) = yaw;
524 vector vectoangles(vector[, vector])
527 void VM_vectoangles(prvm_prog_t *prog)
529 vec3_t result, forward, up;
530 VM_SAFEPARMCOUNTRANGE(1, 2,VM_vectoangles);
532 VectorCopy(PRVM_G_VECTOR(OFS_PARM0), forward);
535 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), up);
536 AnglesFromVectors(result, forward, up, true);
539 AnglesFromVectors(result, forward, NULL, true);
540 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
547 Returns a number from 0<= num < 1
552 void VM_random(prvm_prog_t *prog)
554 VM_SAFEPARMCOUNT(0,VM_random);
556 PRVM_G_FLOAT(OFS_RETURN) = lhrandom(0, 1);
563 localsound(string sample)
566 void VM_localsound(prvm_prog_t *prog)
570 VM_SAFEPARMCOUNT(1,VM_localsound);
572 s = PRVM_G_STRING(OFS_PARM0);
574 if(!S_LocalSound (s))
576 PRVM_G_FLOAT(OFS_RETURN) = -4;
577 VM_Warning(prog, "VM_localsound: Failed to play %s for %s !\n", s, prog->name);
581 PRVM_G_FLOAT(OFS_RETURN) = 1;
591 void VM_break(prvm_prog_t *prog)
593 prog->error_cmd("%s: break statement", prog->name);
596 //============================================================================
602 Sends text over to the client's execution buffer
604 [localcmd (string, ...) or]
608 void VM_localcmd(prvm_prog_t *prog)
610 char string[VM_STRINGTEMP_LENGTH];
611 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd);
612 VM_VarString(prog, 0, string, sizeof(string));
613 Cbuf_AddText(string);
616 static qboolean PRVM_Cvar_ReadOk(const char *string)
619 cvar = Cvar_FindVar(string);
620 return ((cvar) && ((cvar->flags & CVAR_PRIVATE) == 0));
630 void VM_cvar(prvm_prog_t *prog)
632 char string[VM_STRINGTEMP_LENGTH];
633 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
634 VM_VarString(prog, 0, string, sizeof(string));
635 VM_CheckEmptyString(prog, string);
636 PRVM_G_FLOAT(OFS_RETURN) = PRVM_Cvar_ReadOk(string) ? Cvar_VariableValue(string) : 0;
643 float cvar_type (string)
644 float CVAR_TYPEFLAG_EXISTS = 1;
645 float CVAR_TYPEFLAG_SAVED = 2;
646 float CVAR_TYPEFLAG_PRIVATE = 4;
647 float CVAR_TYPEFLAG_ENGINE = 8;
648 float CVAR_TYPEFLAG_HASDESCRIPTION = 16;
649 float CVAR_TYPEFLAG_READONLY = 32;
652 void VM_cvar_type(prvm_prog_t *prog)
654 char string[VM_STRINGTEMP_LENGTH];
658 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
659 VM_VarString(prog, 0, string, sizeof(string));
660 VM_CheckEmptyString(prog, string);
661 cvar = Cvar_FindVar(string);
666 PRVM_G_FLOAT(OFS_RETURN) = 0;
667 return; // CVAR_TYPE_NONE
670 ret = 1; // CVAR_EXISTS
671 if(cvar->flags & CVAR_SAVE)
672 ret |= 2; // CVAR_TYPE_SAVED
673 if(cvar->flags & CVAR_PRIVATE)
674 ret |= 4; // CVAR_TYPE_PRIVATE
675 if(!(cvar->flags & CVAR_ALLOCATED))
676 ret |= 8; // CVAR_TYPE_ENGINE
677 if(cvar->description != cvar_dummy_description)
678 ret |= 16; // CVAR_TYPE_HASDESCRIPTION
679 if(cvar->flags & CVAR_READONLY)
680 ret |= 32; // CVAR_TYPE_READONLY
682 PRVM_G_FLOAT(OFS_RETURN) = ret;
689 const string VM_cvar_string (string, ...)
692 void VM_cvar_string(prvm_prog_t *prog)
694 char string[VM_STRINGTEMP_LENGTH];
695 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_string);
696 VM_VarString(prog, 0, string, sizeof(string));
697 VM_CheckEmptyString(prog, string);
698 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_Cvar_ReadOk(string) ? Cvar_VariableString(string) : "");
703 ========================
706 const string VM_cvar_defstring (string, ...)
707 ========================
709 void VM_cvar_defstring(prvm_prog_t *prog)
711 char string[VM_STRINGTEMP_LENGTH];
712 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_defstring);
713 VM_VarString(prog, 0, string, sizeof(string));
714 VM_CheckEmptyString(prog, string);
715 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDefString(string));
719 ========================
722 const string VM_cvar_description (string, ...)
723 ========================
725 void VM_cvar_description(prvm_prog_t *prog)
727 char string[VM_STRINGTEMP_LENGTH];
728 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_description);
729 VM_VarString(prog, 0, string, sizeof(string));
730 VM_CheckEmptyString(prog, string);
731 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDescription(string));
737 void cvar_set (string,string, ...)
740 void VM_cvar_set(prvm_prog_t *prog)
743 char string[VM_STRINGTEMP_LENGTH];
744 VM_SAFEPARMCOUNTRANGE(2,8,VM_cvar_set);
745 VM_VarString(prog, 1, string, sizeof(string));
746 name = PRVM_G_STRING(OFS_PARM0);
747 VM_CheckEmptyString(prog, name);
748 Cvar_Set(name, string);
758 void VM_dprint(prvm_prog_t *prog)
760 char string[VM_STRINGTEMP_LENGTH];
761 VM_SAFEPARMCOUNTRANGE(1, 8, VM_dprint);
762 VM_VarString(prog, 0, string, sizeof(string));
764 Con_DPrintf("%s", string);
766 Con_DPrintf("%s: %s", prog->name, string);
778 void VM_ftos(prvm_prog_t *prog)
783 VM_SAFEPARMCOUNT(1, VM_ftos);
785 v = PRVM_G_FLOAT(OFS_PARM0);
787 if ((float)((int)v) == v)
788 dpsnprintf(s, sizeof(s), "%i", (int)v);
790 dpsnprintf(s, sizeof(s), "%f", v);
791 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
802 void VM_fabs(prvm_prog_t *prog)
806 VM_SAFEPARMCOUNT(1,VM_fabs);
808 v = PRVM_G_FLOAT(OFS_PARM0);
809 PRVM_G_FLOAT(OFS_RETURN) = fabs(v);
820 void VM_vtos(prvm_prog_t *prog)
824 VM_SAFEPARMCOUNT(1,VM_vtos);
826 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]);
827 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
838 void VM_etos(prvm_prog_t *prog)
842 VM_SAFEPARMCOUNT(1, VM_etos);
844 dpsnprintf (s, sizeof(s), "entity %i", PRVM_G_EDICTNUM(OFS_PARM0));
845 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
852 float stof(...[string])
855 void VM_stof(prvm_prog_t *prog)
857 char string[VM_STRINGTEMP_LENGTH];
858 VM_SAFEPARMCOUNTRANGE(1, 8, VM_stof);
859 VM_VarString(prog, 0, string, sizeof(string));
860 PRVM_G_FLOAT(OFS_RETURN) = atof(string);
864 ========================
868 ========================
870 void VM_itof(prvm_prog_t *prog)
872 VM_SAFEPARMCOUNT(1, VM_itof);
873 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
877 ========================
880 entity ftoe(float num)
881 ========================
883 void VM_ftoe(prvm_prog_t *prog)
886 VM_SAFEPARMCOUNT(1, VM_ftoe);
888 ent = (int)PRVM_G_FLOAT(OFS_PARM0);
889 if (ent < 0 || ent >= prog->max_edicts || PRVM_PROG_TO_EDICT(ent)->priv.required->free)
890 ent = 0; // return world instead of a free or invalid entity
892 PRVM_G_INT(OFS_RETURN) = ent;
896 ========================
899 float etof(entity ent)
900 ========================
902 void VM_etof(prvm_prog_t *prog)
904 VM_SAFEPARMCOUNT(1, VM_etof);
905 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICTNUM(OFS_PARM0);
912 string strftime(float uselocaltime, string[, string ...])
915 void VM_strftime(prvm_prog_t *prog)
924 char fmt[VM_STRINGTEMP_LENGTH];
925 char result[VM_STRINGTEMP_LENGTH];
926 VM_SAFEPARMCOUNTRANGE(2, 8, VM_strftime);
927 VM_VarString(prog, 1, fmt, sizeof(fmt));
930 if (PRVM_G_FLOAT(OFS_PARM0))
931 tmresult = localtime_s(&tm, &t);
933 tmresult = gmtime_s(&tm, &t);
936 if (PRVM_G_FLOAT(OFS_PARM0))
943 PRVM_G_INT(OFS_RETURN) = 0;
947 strftime(result, sizeof(result), fmt, &tm);
949 strftime(result, sizeof(result), fmt, tm);
951 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, result);
962 void VM_spawn(prvm_prog_t *prog)
965 VM_SAFEPARMCOUNT(0, VM_spawn);
966 prog->xfunction->builtinsprofile += 20;
967 ed = PRVM_ED_Alloc(prog);
979 void VM_remove(prvm_prog_t *prog)
982 prog->xfunction->builtinsprofile += 20;
984 VM_SAFEPARMCOUNT(1, VM_remove);
986 ed = PRVM_G_EDICT(OFS_PARM0);
987 if( PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
989 if (developer.integer > 0)
990 VM_Warning(prog, "VM_remove: tried to remove the null entity or a reserved entity!\n" );
992 else if( ed->priv.required->free )
994 if (developer.integer > 0)
995 VM_Warning(prog, "VM_remove: tried to remove an already freed entity!\n" );
998 PRVM_ED_Free (prog, ed);
1005 entity find(entity start, .string field, string match)
1009 void VM_find(prvm_prog_t *prog)
1016 VM_SAFEPARMCOUNT(3,VM_find);
1018 e = PRVM_G_EDICTNUM(OFS_PARM0);
1019 f = PRVM_G_INT(OFS_PARM1);
1020 s = PRVM_G_STRING(OFS_PARM2);
1022 // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1023 // expects it to find all the monsters, so we must be careful to support
1026 for (e++ ; e < prog->num_edicts ; e++)
1028 prog->xfunction->builtinsprofile++;
1029 ed = PRVM_EDICT_NUM(e);
1030 if (ed->priv.required->free)
1032 t = PRVM_E_STRING(ed,f);
1037 VM_RETURN_EDICT(ed);
1042 VM_RETURN_EDICT(prog->edicts);
1049 entity findfloat(entity start, .float field, float match)
1050 entity findentity(entity start, .entity field, entity match)
1053 // LordHavoc: added this for searching float, int, and entity reference fields
1054 void VM_findfloat(prvm_prog_t *prog)
1061 VM_SAFEPARMCOUNT(3,VM_findfloat);
1063 e = PRVM_G_EDICTNUM(OFS_PARM0);
1064 f = PRVM_G_INT(OFS_PARM1);
1065 s = PRVM_G_FLOAT(OFS_PARM2);
1067 for (e++ ; e < prog->num_edicts ; e++)
1069 prog->xfunction->builtinsprofile++;
1070 ed = PRVM_EDICT_NUM(e);
1071 if (ed->priv.required->free)
1073 if (PRVM_E_FLOAT(ed,f) == s)
1075 VM_RETURN_EDICT(ed);
1080 VM_RETURN_EDICT(prog->edicts);
1087 entity findchain(.string field, string match)
1090 // chained search for strings in entity fields
1091 // entity(.string field, string match) findchain = #402;
1092 void VM_findchain(prvm_prog_t *prog)
1097 prvm_edict_t *ent, *chain;
1100 VM_SAFEPARMCOUNTRANGE(2,3,VM_findchain);
1103 chainfield = PRVM_G_INT(OFS_PARM2);
1105 chainfield = prog->fieldoffsets.chain;
1107 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1109 chain = prog->edicts;
1111 f = PRVM_G_INT(OFS_PARM0);
1112 s = PRVM_G_STRING(OFS_PARM1);
1114 // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1115 // expects it to find all the monsters, so we must be careful to support
1118 ent = PRVM_NEXT_EDICT(prog->edicts);
1119 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1121 prog->xfunction->builtinsprofile++;
1122 if (ent->priv.required->free)
1124 t = PRVM_E_STRING(ent,f);
1130 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_NUM_FOR_EDICT(chain);
1134 VM_RETURN_EDICT(chain);
1141 entity findchainfloat(.string field, float match)
1142 entity findchainentity(.string field, entity match)
1145 // LordHavoc: chained search for float, int, and entity reference fields
1146 // entity(.string field, float match) findchainfloat = #403;
1147 void VM_findchainfloat(prvm_prog_t *prog)
1152 prvm_edict_t *ent, *chain;
1155 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainfloat);
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 = (prvm_edict_t *)prog->edicts;
1166 f = PRVM_G_INT(OFS_PARM0);
1167 s = PRVM_G_FLOAT(OFS_PARM1);
1169 ent = PRVM_NEXT_EDICT(prog->edicts);
1170 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1172 prog->xfunction->builtinsprofile++;
1173 if (ent->priv.required->free)
1175 if (PRVM_E_FLOAT(ent,f) != s)
1178 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1182 VM_RETURN_EDICT(chain);
1186 ========================
1189 entity findflags(entity start, .float field, float match)
1190 ========================
1192 // LordHavoc: search for flags in float fields
1193 void VM_findflags(prvm_prog_t *prog)
1200 VM_SAFEPARMCOUNT(3, VM_findflags);
1203 e = PRVM_G_EDICTNUM(OFS_PARM0);
1204 f = PRVM_G_INT(OFS_PARM1);
1205 s = (int)PRVM_G_FLOAT(OFS_PARM2);
1207 for (e++ ; e < prog->num_edicts ; e++)
1209 prog->xfunction->builtinsprofile++;
1210 ed = PRVM_EDICT_NUM(e);
1211 if (ed->priv.required->free)
1213 if (!PRVM_E_FLOAT(ed,f))
1215 if ((int)PRVM_E_FLOAT(ed,f) & s)
1217 VM_RETURN_EDICT(ed);
1222 VM_RETURN_EDICT(prog->edicts);
1226 ========================
1229 entity findchainflags(.float field, float match)
1230 ========================
1232 // LordHavoc: chained search for flags in float fields
1233 void VM_findchainflags(prvm_prog_t *prog)
1238 prvm_edict_t *ent, *chain;
1241 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainflags);
1244 chainfield = PRVM_G_INT(OFS_PARM2);
1246 chainfield = prog->fieldoffsets.chain;
1248 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1250 chain = (prvm_edict_t *)prog->edicts;
1252 f = PRVM_G_INT(OFS_PARM0);
1253 s = (int)PRVM_G_FLOAT(OFS_PARM1);
1255 ent = PRVM_NEXT_EDICT(prog->edicts);
1256 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1258 prog->xfunction->builtinsprofile++;
1259 if (ent->priv.required->free)
1261 if (!PRVM_E_FLOAT(ent,f))
1263 if (!((int)PRVM_E_FLOAT(ent,f) & s))
1266 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1270 VM_RETURN_EDICT(chain);
1277 string precache_sound (string sample)
1280 void VM_precache_sound(prvm_prog_t *prog)
1284 VM_SAFEPARMCOUNT(1, VM_precache_sound);
1286 s = PRVM_G_STRING(OFS_PARM0);
1287 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1288 //VM_CheckEmptyString(prog, s);
1290 if(snd_initialized.integer && !S_PrecacheSound(s, true, true))
1292 VM_Warning(prog, "VM_precache_sound: Failed to load %s for %s\n", s, prog->name);
1301 returns the same string as output
1303 does nothing, only used by qcc to build .pak archives
1306 void VM_precache_file(prvm_prog_t *prog)
1308 VM_SAFEPARMCOUNT(1,VM_precache_file);
1309 // precache_file is only used to copy files with qcc, it does nothing
1310 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1320 void VM_coredump(prvm_prog_t *prog)
1322 VM_SAFEPARMCOUNT(0,VM_coredump);
1324 Cbuf_AddText("prvm_edicts ");
1325 Cbuf_AddText(prog->name);
1336 void VM_stackdump(prvm_prog_t *prog)
1338 VM_SAFEPARMCOUNT(0, VM_stackdump);
1340 PRVM_StackTrace(prog);
1351 void VM_crash(prvm_prog_t *prog)
1353 VM_SAFEPARMCOUNT(0, VM_crash);
1355 prog->error_cmd("Crash called by %s",prog->name);
1365 void VM_traceon(prvm_prog_t *prog)
1367 VM_SAFEPARMCOUNT(0,VM_traceon);
1379 void VM_traceoff(prvm_prog_t *prog)
1381 VM_SAFEPARMCOUNT(0,VM_traceoff);
1383 prog->trace = false;
1393 void VM_eprint(prvm_prog_t *prog)
1395 VM_SAFEPARMCOUNT(1,VM_eprint);
1397 PRVM_ED_PrintNum (prog, PRVM_G_EDICTNUM(OFS_PARM0), NULL);
1407 void VM_rint(prvm_prog_t *prog)
1410 VM_SAFEPARMCOUNT(1,VM_rint);
1412 f = PRVM_G_FLOAT(OFS_PARM0);
1414 PRVM_G_FLOAT(OFS_RETURN) = floor(f + 0.5);
1416 PRVM_G_FLOAT(OFS_RETURN) = ceil(f - 0.5);
1426 void VM_floor(prvm_prog_t *prog)
1428 VM_SAFEPARMCOUNT(1,VM_floor);
1430 PRVM_G_FLOAT(OFS_RETURN) = floor(PRVM_G_FLOAT(OFS_PARM0));
1440 void VM_ceil(prvm_prog_t *prog)
1442 VM_SAFEPARMCOUNT(1,VM_ceil);
1444 PRVM_G_FLOAT(OFS_RETURN) = ceil(PRVM_G_FLOAT(OFS_PARM0));
1452 entity nextent(entity)
1455 void VM_nextent(prvm_prog_t *prog)
1460 VM_SAFEPARMCOUNT(1, VM_nextent);
1462 i = PRVM_G_EDICTNUM(OFS_PARM0);
1465 prog->xfunction->builtinsprofile++;
1467 if (i == prog->num_edicts)
1469 VM_RETURN_EDICT(prog->edicts);
1472 ent = PRVM_EDICT_NUM(i);
1473 if (!ent->priv.required->free)
1475 VM_RETURN_EDICT(ent);
1481 //=============================================================================
1488 changelevel(string map)
1491 void VM_changelevel(prvm_prog_t *prog)
1494 VM_SAFEPARMCOUNT(1, VM_changelevel);
1498 VM_Warning(prog, "VM_changelevel: game is not server (%s)\n", prog->name);
1502 // make sure we don't issue two changelevels
1503 if (svs.changelevel_issued)
1505 svs.changelevel_issued = true;
1507 Cbuf_AddText(va(vabuf, sizeof(vabuf), "changelevel %s\n",PRVM_G_STRING(OFS_PARM0)));
1517 void VM_sin(prvm_prog_t *prog)
1519 VM_SAFEPARMCOUNT(1,VM_sin);
1520 PRVM_G_FLOAT(OFS_RETURN) = sin(PRVM_G_FLOAT(OFS_PARM0));
1529 void VM_cos(prvm_prog_t *prog)
1531 VM_SAFEPARMCOUNT(1,VM_cos);
1532 PRVM_G_FLOAT(OFS_RETURN) = cos(PRVM_G_FLOAT(OFS_PARM0));
1542 void VM_sqrt(prvm_prog_t *prog)
1544 VM_SAFEPARMCOUNT(1,VM_sqrt);
1545 PRVM_G_FLOAT(OFS_RETURN) = sqrt(PRVM_G_FLOAT(OFS_PARM0));
1555 void VM_asin(prvm_prog_t *prog)
1557 VM_SAFEPARMCOUNT(1,VM_asin);
1558 PRVM_G_FLOAT(OFS_RETURN) = asin(PRVM_G_FLOAT(OFS_PARM0));
1567 void VM_acos(prvm_prog_t *prog)
1569 VM_SAFEPARMCOUNT(1,VM_acos);
1570 PRVM_G_FLOAT(OFS_RETURN) = acos(PRVM_G_FLOAT(OFS_PARM0));
1579 void VM_atan(prvm_prog_t *prog)
1581 VM_SAFEPARMCOUNT(1,VM_atan);
1582 PRVM_G_FLOAT(OFS_RETURN) = atan(PRVM_G_FLOAT(OFS_PARM0));
1588 float atan2(float,float)
1591 void VM_atan2(prvm_prog_t *prog)
1593 VM_SAFEPARMCOUNT(2,VM_atan2);
1594 PRVM_G_FLOAT(OFS_RETURN) = atan2(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1603 void VM_tan(prvm_prog_t *prog)
1605 VM_SAFEPARMCOUNT(1,VM_tan);
1606 PRVM_G_FLOAT(OFS_RETURN) = tan(PRVM_G_FLOAT(OFS_PARM0));
1613 Returns a vector of length < 1 and > 0
1618 void VM_randomvec(prvm_prog_t *prog)
1621 VM_SAFEPARMCOUNT(0, VM_randomvec);
1623 VectorCopy(temp, PRVM_G_VECTOR(OFS_RETURN));
1626 //=============================================================================
1632 float registercvar (string name, string value[, float flags])
1635 void VM_registercvar(prvm_prog_t *prog)
1637 const char *name, *value;
1640 VM_SAFEPARMCOUNTRANGE(2, 3, VM_registercvar);
1642 name = PRVM_G_STRING(OFS_PARM0);
1643 value = PRVM_G_STRING(OFS_PARM1);
1644 flags = prog->argc >= 3 ? (int)PRVM_G_FLOAT(OFS_PARM2) : 0;
1645 PRVM_G_FLOAT(OFS_RETURN) = 0;
1647 if(flags > CVAR_MAXFLAGSVAL)
1650 // first check to see if it has already been defined
1651 if (Cvar_FindVar (name))
1654 // check for overlap with a command
1655 if (Cmd_Exists (name))
1657 VM_Warning(prog, "VM_registercvar: %s is a command\n", name);
1661 Cvar_Get(name, value, flags, NULL);
1663 PRVM_G_FLOAT(OFS_RETURN) = 1; // success
1671 returns the minimum of two supplied floats
1673 float min(float a, float b, ...[float])
1676 void VM_min(prvm_prog_t *prog)
1678 VM_SAFEPARMCOUNTRANGE(2, 8, VM_min);
1679 // LordHavoc: 3+ argument enhancement suggested by FrikaC
1680 if (prog->argc >= 3)
1683 float f = PRVM_G_FLOAT(OFS_PARM0);
1684 for (i = 1;i < prog->argc;i++)
1685 if (f > PRVM_G_FLOAT((OFS_PARM0+i*3)))
1686 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1687 PRVM_G_FLOAT(OFS_RETURN) = f;
1690 PRVM_G_FLOAT(OFS_RETURN) = min(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1697 returns the maximum of two supplied floats
1699 float max(float a, float b, ...[float])
1702 void VM_max(prvm_prog_t *prog)
1704 VM_SAFEPARMCOUNTRANGE(2, 8, VM_max);
1705 // LordHavoc: 3+ argument enhancement suggested by FrikaC
1706 if (prog->argc >= 3)
1709 float f = PRVM_G_FLOAT(OFS_PARM0);
1710 for (i = 1;i < prog->argc;i++)
1711 if (f < PRVM_G_FLOAT((OFS_PARM0+i*3)))
1712 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1713 PRVM_G_FLOAT(OFS_RETURN) = f;
1716 PRVM_G_FLOAT(OFS_RETURN) = max(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1723 returns number bounded by supplied range
1725 float bound(float min, float value, float max)
1728 void VM_bound(prvm_prog_t *prog)
1730 VM_SAFEPARMCOUNT(3,VM_bound);
1731 PRVM_G_FLOAT(OFS_RETURN) = bound(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1), PRVM_G_FLOAT(OFS_PARM2));
1738 returns a raised to power b
1740 float pow(float a, float b)
1743 void VM_pow(prvm_prog_t *prog)
1745 VM_SAFEPARMCOUNT(2,VM_pow);
1746 PRVM_G_FLOAT(OFS_RETURN) = pow(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1749 void VM_log(prvm_prog_t *prog)
1751 VM_SAFEPARMCOUNT(1,VM_log);
1752 PRVM_G_FLOAT(OFS_RETURN) = log(PRVM_G_FLOAT(OFS_PARM0));
1755 void VM_Files_Init(prvm_prog_t *prog)
1758 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1759 prog->openfiles[i] = NULL;
1762 void VM_Files_CloseAll(prvm_prog_t *prog)
1765 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1767 if (prog->openfiles[i])
1768 FS_Close(prog->openfiles[i]);
1769 prog->openfiles[i] = NULL;
1773 static qfile_t *VM_GetFileHandle(prvm_prog_t *prog, int index)
1775 if (index < 0 || index >= PRVM_MAX_OPENFILES)
1777 Con_Printf("VM_GetFileHandle: invalid file handle %i used in %s\n", index, prog->name);
1780 if (prog->openfiles[index] == NULL)
1782 Con_Printf("VM_GetFileHandle: no such file handle %i (or file has been closed) in %s\n", index, prog->name);
1785 return prog->openfiles[index];
1792 float fopen(string filename, float mode)
1795 // float(string filename, float mode) fopen = #110;
1796 // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE),
1797 // returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason
1798 void VM_fopen(prvm_prog_t *prog)
1801 const char *modestring, *filename;
1804 VM_SAFEPARMCOUNT(2,VM_fopen);
1806 for (filenum = 0;filenum < PRVM_MAX_OPENFILES;filenum++)
1807 if (prog->openfiles[filenum] == NULL)
1809 if (filenum >= PRVM_MAX_OPENFILES)
1811 PRVM_G_FLOAT(OFS_RETURN) = -2;
1812 VM_Warning(prog, "VM_fopen: %s ran out of file handles (%i)\n", prog->name, PRVM_MAX_OPENFILES);
1815 filename = PRVM_G_STRING(OFS_PARM0);
1816 mode = (int)PRVM_G_FLOAT(OFS_PARM1);
1819 case 0: // FILE_READ
1821 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
1822 if (prog->openfiles[filenum] == NULL)
1823 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
1825 case 1: // FILE_APPEND
1827 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1829 case 2: // FILE_WRITE
1831 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1834 PRVM_G_FLOAT(OFS_RETURN) = -3;
1835 VM_Warning(prog, "VM_fopen: %s: no such mode %i (valid: 0 = read, 1 = append, 2 = write)\n", prog->name, mode);
1839 if (prog->openfiles[filenum] == NULL)
1841 PRVM_G_FLOAT(OFS_RETURN) = -1;
1842 if (developer_extra.integer)
1843 VM_Warning(prog, "VM_fopen: %s: %s mode %s failed\n", prog->name, filename, modestring);
1847 PRVM_G_FLOAT(OFS_RETURN) = filenum;
1848 if (developer_extra.integer)
1849 Con_DPrintf("VM_fopen: %s: %s mode %s opened as #%i\n", prog->name, filename, modestring, filenum);
1850 prog->openfiles_origin[filenum] = PRVM_AllocationOrigin(prog);
1858 fclose(float fhandle)
1861 //void(float fhandle) fclose = #111; // closes a file
1862 void VM_fclose(prvm_prog_t *prog)
1866 VM_SAFEPARMCOUNT(1,VM_fclose);
1868 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1869 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1871 VM_Warning(prog, "VM_fclose: invalid file handle %i used in %s\n", filenum, prog->name);
1874 if (prog->openfiles[filenum] == NULL)
1876 VM_Warning(prog, "VM_fclose: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1879 FS_Close(prog->openfiles[filenum]);
1880 prog->openfiles[filenum] = NULL;
1881 if(prog->openfiles_origin[filenum])
1882 PRVM_Free((char *)prog->openfiles_origin[filenum]);
1883 if (developer_extra.integer)
1884 Con_DPrintf("VM_fclose: %s: #%i closed\n", prog->name, filenum);
1891 string fgets(float fhandle)
1894 //string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring
1895 void VM_fgets(prvm_prog_t *prog)
1898 char string[VM_STRINGTEMP_LENGTH];
1901 VM_SAFEPARMCOUNT(1,VM_fgets);
1903 // set the return value regardless of any possible errors
1904 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
1906 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1907 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1909 VM_Warning(prog, "VM_fgets: invalid file handle %i used in %s\n", filenum, prog->name);
1912 if (prog->openfiles[filenum] == NULL)
1914 VM_Warning(prog, "VM_fgets: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1920 c = FS_Getc(prog->openfiles[filenum]);
1921 if (c == '\r' || c == '\n' || c < 0)
1923 if (end < VM_STRINGTEMP_LENGTH - 1)
1927 // remove \n following \r
1930 c = FS_Getc(prog->openfiles[filenum]);
1932 FS_UnGetc(prog->openfiles[filenum], (unsigned char)c);
1934 if (developer_extra.integer)
1935 Con_DPrintf("fgets: %s: %s\n", prog->name, string);
1937 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
1944 fputs(float fhandle, string s)
1947 //void(float fhandle, string s) fputs = #113; // writes a line of text to the end of the file
1948 void VM_fputs(prvm_prog_t *prog)
1951 char string[VM_STRINGTEMP_LENGTH];
1954 VM_SAFEPARMCOUNT(2,VM_fputs);
1956 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1957 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1959 VM_Warning(prog, "VM_fputs: invalid file handle %i used in %s\n", filenum, prog->name);
1962 if (prog->openfiles[filenum] == NULL)
1964 VM_Warning(prog, "VM_fputs: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1967 VM_VarString(prog, 1, string, sizeof(string));
1968 if ((stringlength = (int)strlen(string)))
1969 FS_Write(prog->openfiles[filenum], string, stringlength);
1970 if (developer_extra.integer)
1971 Con_DPrintf("fputs: %s: %s\n", prog->name, string);
1978 writetofile(float fhandle, entity ent)
1981 void VM_writetofile(prvm_prog_t *prog)
1986 VM_SAFEPARMCOUNT(2, VM_writetofile);
1988 file = VM_GetFileHandle(prog, (int)PRVM_G_FLOAT(OFS_PARM0));
1991 VM_Warning(prog, "VM_writetofile: invalid or closed file handle\n");
1995 ent = PRVM_G_EDICT(OFS_PARM1);
1996 if(ent->priv.required->free)
1998 VM_Warning(prog, "VM_writetofile: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2002 PRVM_ED_Write (prog, file, ent);
2005 // KrimZon - DP_QC_ENTITYDATA
2010 float() numentityfields
2011 Return the number of entity fields - NOT offsets
2014 void VM_numentityfields(prvm_prog_t *prog)
2016 PRVM_G_FLOAT(OFS_RETURN) = prog->numfielddefs;
2019 // KrimZon - DP_QC_ENTITYDATA
2024 string(float fieldnum) entityfieldname
2025 Return name of the specified field as a string, or empty if the field is invalid (warning)
2028 void VM_entityfieldname(prvm_prog_t *prog)
2031 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2033 if (i < 0 || i >= prog->numfielddefs)
2035 VM_Warning(prog, "VM_entityfieldname: %s: field index out of bounds\n", prog->name);
2036 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2040 d = &prog->fielddefs[i];
2041 PRVM_G_INT(OFS_RETURN) = d->s_name; // presuming that s_name points to a string already
2044 // KrimZon - DP_QC_ENTITYDATA
2049 float(float fieldnum) entityfieldtype
2052 void VM_entityfieldtype(prvm_prog_t *prog)
2055 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2057 if (i < 0 || i >= prog->numfielddefs)
2059 VM_Warning(prog, "VM_entityfieldtype: %s: field index out of bounds\n", prog->name);
2060 PRVM_G_FLOAT(OFS_RETURN) = -1.0;
2064 d = &prog->fielddefs[i];
2065 PRVM_G_FLOAT(OFS_RETURN) = (float)d->type;
2068 // KrimZon - DP_QC_ENTITYDATA
2071 VM_getentityfieldstring
2073 string(float fieldnum, entity ent) getentityfieldstring
2076 void VM_getentityfieldstring(prvm_prog_t *prog)
2078 // put the data into a string
2083 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2084 char valuebuf[MAX_INPUTLINE];
2086 if (i < 0 || i >= prog->numfielddefs)
2088 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2089 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2093 d = &prog->fielddefs[i];
2096 ent = PRVM_G_EDICT(OFS_PARM1);
2097 if(ent->priv.required->free)
2099 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2100 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2103 val = (prvm_eval_t *)(ent->fields.fp + d->ofs);
2105 // if it's 0 or blank, return an empty string
2106 type = d->type & ~DEF_SAVEGLOBAL;
2107 for (j=0 ; j<prvm_type_size[type] ; j++)
2108 if (val->ivector[j])
2110 if (j == prvm_type_size[type])
2112 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2116 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_UglyValueString(prog, (etype_t)d->type, val, valuebuf, sizeof(valuebuf)));
2119 // KrimZon - DP_QC_ENTITYDATA
2122 VM_putentityfieldstring
2124 float(float fieldnum, entity ent, string s) putentityfieldstring
2127 void VM_putentityfieldstring(prvm_prog_t *prog)
2131 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2133 if (i < 0 || i >= prog->numfielddefs)
2135 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2136 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2140 d = &prog->fielddefs[i];
2143 ent = PRVM_G_EDICT(OFS_PARM1);
2144 if(ent->priv.required->free)
2146 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2147 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2151 // parse the string into the value
2152 PRVM_G_FLOAT(OFS_RETURN) = ( PRVM_ED_ParseEpair(prog, ent, d, PRVM_G_STRING(OFS_PARM2), false) ) ? 1.0f : 0.0f;
2159 float strlen(string s)
2162 //float(string s) strlen = #114; // returns how many characters are in a string
2163 void VM_strlen(prvm_prog_t *prog)
2165 VM_SAFEPARMCOUNT(1,VM_strlen);
2167 //PRVM_G_FLOAT(OFS_RETURN) = strlen(PRVM_G_STRING(OFS_PARM0));
2168 PRVM_G_FLOAT(OFS_RETURN) = u8_strlen(PRVM_G_STRING(OFS_PARM0));
2171 // DRESK - Decolorized String
2176 string strdecolorize(string s)
2179 // string (string s) strdecolorize = #472; // returns the passed in string with color codes stripped
2180 void VM_strdecolorize(prvm_prog_t *prog)
2182 char szNewString[VM_STRINGTEMP_LENGTH];
2183 const char *szString;
2186 VM_SAFEPARMCOUNT(1,VM_strdecolorize);
2187 szString = PRVM_G_STRING(OFS_PARM0);
2188 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), TRUE);
2189 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2192 // DRESK - String Length (not counting color codes)
2197 float strlennocol(string s)
2200 // float(string s) strlennocol = #471; // returns how many characters are in a string not including color codes
2201 // For example, ^2Dresk returns a length of 5
2202 void VM_strlennocol(prvm_prog_t *prog)
2204 const char *szString;
2207 VM_SAFEPARMCOUNT(1,VM_strlennocol);
2209 szString = PRVM_G_STRING(OFS_PARM0);
2211 //nCnt = COM_StringLengthNoColors(szString, 0, NULL);
2212 nCnt = u8_COM_StringLengthNoColors(szString, 0, NULL);
2214 PRVM_G_FLOAT(OFS_RETURN) = nCnt;
2217 // DRESK - String to Uppercase and Lowercase
2222 string strtolower(string s)
2225 // string (string s) strtolower = #480; // returns passed in string in lowercase form
2226 void VM_strtolower(prvm_prog_t *prog)
2228 char szNewString[VM_STRINGTEMP_LENGTH];
2229 const char *szString;
2232 VM_SAFEPARMCOUNT(1,VM_strtolower);
2233 szString = PRVM_G_STRING(OFS_PARM0);
2235 COM_ToLowerString(szString, szNewString, sizeof(szNewString) );
2237 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2244 string strtoupper(string s)
2247 // string (string s) strtoupper = #481; // returns passed in string in uppercase form
2248 void VM_strtoupper(prvm_prog_t *prog)
2250 char szNewString[VM_STRINGTEMP_LENGTH];
2251 const char *szString;
2254 VM_SAFEPARMCOUNT(1,VM_strtoupper);
2255 szString = PRVM_G_STRING(OFS_PARM0);
2257 COM_ToUpperString(szString, szNewString, sizeof(szNewString) );
2259 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2266 string strcat(string,string,...[string])
2269 //string(string s1, string s2) strcat = #115;
2270 // concatenates two strings (for example "abc", "def" would return "abcdef")
2271 // and returns as a tempstring
2272 void VM_strcat(prvm_prog_t *prog)
2274 char s[VM_STRINGTEMP_LENGTH];
2275 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strcat);
2277 VM_VarString(prog, 0, s, sizeof(s));
2278 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
2285 string substring(string s, float start, float length)
2288 // string(string s, float start, float length) substring = #116;
2289 // returns a section of a string as a tempstring
2290 void VM_substring(prvm_prog_t *prog)
2293 int u_slength = 0, u_start;
2296 char string[VM_STRINGTEMP_LENGTH];
2298 VM_SAFEPARMCOUNT(3,VM_substring);
2301 s = PRVM_G_STRING(OFS_PARM0);
2302 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2303 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2304 slength = strlen(s);
2306 if (start < 0) // FTE_STRINGS feature
2308 start = bound(0, start, slength);
2310 if (length < 0) // FTE_STRINGS feature
2311 length += slength - start + 1;
2312 maxlen = min((int)sizeof(string) - 1, slength - start);
2313 length = bound(0, length, maxlen);
2315 memcpy(string, s + start, length);
2317 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2320 s = PRVM_G_STRING(OFS_PARM0);
2321 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2322 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2324 if (start < 0) // FTE_STRINGS feature
2326 u_slength = u8_strlen(s);
2328 start = bound(0, start, u_slength);
2331 if (length < 0) // FTE_STRINGS feature
2333 if (!u_slength) // it's not calculated when it's not needed above
2334 u_slength = u8_strlen(s);
2335 length += u_slength - start + 1;
2338 // positive start, positive length
2339 u_start = u8_byteofs(s, start, NULL);
2342 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2345 u_length = u8_bytelen(s + u_start, length);
2346 if (u_length >= sizeof(string)-1)
2347 u_length = sizeof(string)-1;
2349 memcpy(string, s + u_start, u_length);
2350 string[u_length] = 0;
2351 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2358 string(string search, string replace, string subject) strreplace = #484;
2361 // replaces all occurrences of search with replace in the string subject, and returns the result
2362 void VM_strreplace(prvm_prog_t *prog)
2365 const char *search, *replace, *subject;
2366 char string[VM_STRINGTEMP_LENGTH];
2367 int search_len, replace_len, subject_len;
2369 VM_SAFEPARMCOUNT(3,VM_strreplace);
2371 search = PRVM_G_STRING(OFS_PARM0);
2372 replace = PRVM_G_STRING(OFS_PARM1);
2373 subject = PRVM_G_STRING(OFS_PARM2);
2375 search_len = (int)strlen(search);
2376 replace_len = (int)strlen(replace);
2377 subject_len = (int)strlen(subject);
2380 for (i = 0; i <= subject_len - search_len; i++)
2382 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2383 if (subject[i+j] != search[j])
2385 if (j == search_len)
2387 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2388 // found it at offset 'i'
2389 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2390 string[si++] = replace[j];
2393 i += search_len - 1;
2397 // the above would subtract 1 from i... so we
2398 // don't do that, but instead output the next
2400 if (si < (int)sizeof(string) - 1)
2401 string[si++] = subject[i];
2406 // in THIS case, we know search_len > 0, thus i < subject_len
2408 if (si < (int)sizeof(string) - 1)
2409 string[si++] = subject[i];
2412 // remaining chars (these cannot match)
2413 for (; i < subject_len; i++)
2414 if (si < (int)sizeof(string) - 1)
2415 string[si++] = subject[i];
2418 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2425 string(string search, string replace, string subject) strireplace = #485;
2428 // case-insensitive version of strreplace
2429 void VM_strireplace(prvm_prog_t *prog)
2432 const char *search, *replace, *subject;
2433 char string[VM_STRINGTEMP_LENGTH];
2434 int search_len, replace_len, subject_len;
2436 VM_SAFEPARMCOUNT(3,VM_strreplace);
2438 search = PRVM_G_STRING(OFS_PARM0);
2439 replace = PRVM_G_STRING(OFS_PARM1);
2440 subject = PRVM_G_STRING(OFS_PARM2);
2442 search_len = (int)strlen(search);
2443 replace_len = (int)strlen(replace);
2444 subject_len = (int)strlen(subject);
2447 for (i = 0; i <= subject_len - search_len; i++)
2449 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2450 if (tolower(subject[i+j]) != tolower(search[j]))
2452 if (j == search_len)
2454 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2455 // found it at offset 'i'
2456 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2457 string[si++] = replace[j];
2460 i += search_len - 1;
2464 // the above would subtract 1 from i... so we
2465 // don't do that, but instead output the next
2467 if (si < (int)sizeof(string) - 1)
2468 string[si++] = subject[i];
2473 // in THIS case, we know search_len > 0, thus i < subject_len
2475 if (si < (int)sizeof(string) - 1)
2476 string[si++] = subject[i];
2479 // remaining chars (these cannot match)
2480 for (; i < subject_len; i++)
2481 if (si < (int)sizeof(string) - 1)
2482 string[si++] = subject[i];
2485 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2492 vector stov(string s)
2495 //vector(string s) stov = #117; // returns vector value from a string
2496 void VM_stov(prvm_prog_t *prog)
2498 char string[VM_STRINGTEMP_LENGTH];
2500 VM_SAFEPARMCOUNT(1,VM_stov);
2502 VM_VarString(prog, 0, string, sizeof(string));
2503 Math_atov(string, PRVM_G_VECTOR(OFS_RETURN));
2510 string strzone(string s)
2513 //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)
2514 void VM_strzone(prvm_prog_t *prog)
2517 char string[VM_STRINGTEMP_LENGTH];
2520 VM_SAFEPARMCOUNT(1,VM_strzone);
2522 VM_VarString(prog, 0, string, sizeof(string));
2523 alloclen = strlen(string) + 1;
2524 PRVM_G_INT(OFS_RETURN) = PRVM_AllocString(prog, alloclen, &out);
2525 memcpy(out, string, alloclen);
2535 //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!!!)
2536 void VM_strunzone(prvm_prog_t *prog)
2538 VM_SAFEPARMCOUNT(1,VM_strunzone);
2539 PRVM_FreeString(prog, PRVM_G_INT(OFS_PARM0));
2544 VM_command (used by client and menu)
2546 clientcommand(float client, string s) (for client and menu)
2549 //void(entity e, string s) clientcommand = #440; // executes a command string as if it came from the specified client
2550 //this function originally written by KrimZon, made shorter by LordHavoc
2551 void VM_clcommand (prvm_prog_t *prog)
2553 client_t *temp_client;
2556 VM_SAFEPARMCOUNT(2,VM_clcommand);
2558 i = (int)PRVM_G_FLOAT(OFS_PARM0);
2559 if (!sv.active || i < 0 || i >= svs.maxclients || !svs.clients[i].active)
2561 VM_Warning(prog, "VM_clientcommand: %s: invalid client/server is not active !\n", prog->name);
2565 temp_client = host_client;
2566 host_client = svs.clients + i;
2567 Cmd_ExecuteString (PRVM_G_STRING(OFS_PARM1), src_client, true);
2568 host_client = temp_client;
2576 float tokenize(string s)
2579 //float(string s) tokenize = #441; // takes apart a string into individal words (access them with argv), returns how many
2580 //this function originally written by KrimZon, made shorter by LordHavoc
2581 //20040203: rewritten by LordHavoc (no longer uses allocations)
2582 static int num_tokens = 0;
2583 static int tokens[VM_STRINGTEMP_LENGTH / 2];
2584 static int tokens_startpos[VM_STRINGTEMP_LENGTH / 2];
2585 static int tokens_endpos[VM_STRINGTEMP_LENGTH / 2];
2586 static char tokenize_string[VM_STRINGTEMP_LENGTH];
2587 void VM_tokenize (prvm_prog_t *prog)
2591 VM_SAFEPARMCOUNT(1,VM_tokenize);
2593 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2594 p = tokenize_string;
2599 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2602 // skip whitespace here to find token start pos
2603 while(*p && ISWHITESPACE(*p))
2606 tokens_startpos[num_tokens] = p - tokenize_string;
2607 if(!COM_ParseToken_VM_Tokenize(&p, false))
2609 tokens_endpos[num_tokens] = p - tokenize_string;
2610 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2614 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2617 //float(string s) tokenize = #514; // takes apart a string into individal words (access them with argv), returns how many
2618 void VM_tokenize_console (prvm_prog_t *prog)
2622 VM_SAFEPARMCOUNT(1,VM_tokenize);
2624 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2625 p = tokenize_string;
2630 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2633 // skip whitespace here to find token start pos
2634 while(*p && ISWHITESPACE(*p))
2637 tokens_startpos[num_tokens] = p - tokenize_string;
2638 if(!COM_ParseToken_Console(&p))
2640 tokens_endpos[num_tokens] = p - tokenize_string;
2641 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2645 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2650 VM_tokenizebyseparator
2652 float tokenizebyseparator(string s, string separator1, ...)
2655 //float(string s, string separator1, ...) tokenizebyseparator = #479; // takes apart a string into individal words (access them with argv), returns how many
2656 //this function returns the token preceding each instance of a separator (of
2657 //which there can be multiple), and the text following the last separator
2658 //useful for parsing certain kinds of data like IP addresses
2660 //numnumbers = tokenizebyseparator("10.1.2.3", ".");
2661 //returns 4 and the tokens "10" "1" "2" "3".
2662 void VM_tokenizebyseparator (prvm_prog_t *prog)
2666 int separatorlen[7];
2667 const char *separators[7];
2670 char tokentext[MAX_INPUTLINE];
2672 VM_SAFEPARMCOUNTRANGE(2, 8,VM_tokenizebyseparator);
2674 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2675 p = tokenize_string;
2678 for (j = 1;j < prog->argc;j++)
2680 // skip any blank separator strings
2681 const char *s = PRVM_G_STRING(OFS_PARM0+j*3);
2684 separators[numseparators] = s;
2685 separatorlen[numseparators] = strlen(s);
2692 while (num_tokens < (int)(sizeof(tokens)/sizeof(tokens[0])))
2694 token = tokentext + j;
2695 tokens_startpos[num_tokens] = p - tokenize_string;
2699 for (k = 0;k < numseparators;k++)
2701 if (!strncmp(p, separators[k], separatorlen[k]))
2703 p += separatorlen[k];
2707 if (k < numseparators)
2709 if (j < (int)sizeof(tokentext)-1)
2710 tokentext[j++] = *p;
2714 tokens_endpos[num_tokens] = p0 - tokenize_string;
2715 if (j >= (int)sizeof(tokentext))
2718 tokens[num_tokens++] = PRVM_SetTempString(prog, token);
2723 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2726 //string(float n) argv = #442; // returns a word from the tokenized string (returns nothing for an invalid index)
2727 //this function originally written by KrimZon, made shorter by LordHavoc
2728 void VM_argv (prvm_prog_t *prog)
2732 VM_SAFEPARMCOUNT(1,VM_argv);
2734 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2737 token_num += num_tokens;
2739 if (token_num >= 0 && token_num < num_tokens)
2740 PRVM_G_INT(OFS_RETURN) = tokens[token_num];
2742 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2745 //float(float n) argv_start_index = #515; // returns the start index of a token
2746 void VM_argv_start_index (prvm_prog_t *prog)
2750 VM_SAFEPARMCOUNT(1,VM_argv);
2752 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2755 token_num += num_tokens;
2757 if (token_num >= 0 && token_num < num_tokens)
2758 PRVM_G_FLOAT(OFS_RETURN) = tokens_startpos[token_num];
2760 PRVM_G_FLOAT(OFS_RETURN) = -1;
2763 //float(float n) argv_end_index = #516; // returns the end index of a token
2764 void VM_argv_end_index (prvm_prog_t *prog)
2768 VM_SAFEPARMCOUNT(1,VM_argv);
2770 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2773 token_num += num_tokens;
2775 if (token_num >= 0 && token_num < num_tokens)
2776 PRVM_G_FLOAT(OFS_RETURN) = tokens_endpos[token_num];
2778 PRVM_G_FLOAT(OFS_RETURN) = -1;
2788 void VM_isserver(prvm_prog_t *prog)
2790 VM_SAFEPARMCOUNT(0,VM_serverstate);
2792 PRVM_G_FLOAT(OFS_RETURN) = sv.active && (svs.maxclients > 1 || cls.state == ca_dedicated);
2802 void VM_clientcount(prvm_prog_t *prog)
2804 VM_SAFEPARMCOUNT(0,VM_clientcount);
2806 PRVM_G_FLOAT(OFS_RETURN) = svs.maxclients;
2816 void VM_clientstate(prvm_prog_t *prog)
2818 VM_SAFEPARMCOUNT(0,VM_clientstate);
2821 switch( cls.state ) {
2822 case ca_uninitialized:
2824 PRVM_G_FLOAT(OFS_RETURN) = 0;
2826 case ca_disconnected:
2827 PRVM_G_FLOAT(OFS_RETURN) = 1;
2830 PRVM_G_FLOAT(OFS_RETURN) = 2;
2833 // should never be reached!
2842 float getostype(prvm_prog_t *prog)
2844 */ // not used at the moment -> not included in the common list
2845 void VM_getostype(prvm_prog_t *prog)
2847 VM_SAFEPARMCOUNT(0,VM_getostype);
2852 OS_MAC - not supported
2856 PRVM_G_FLOAT(OFS_RETURN) = 0;
2857 #elif defined(MACOSX)
2858 PRVM_G_FLOAT(OFS_RETURN) = 2;
2860 PRVM_G_FLOAT(OFS_RETURN) = 1;
2868 float gettime(prvm_prog_t *prog)
2871 float CDAudio_GetPosition(void);
2872 void VM_gettime(prvm_prog_t *prog)
2876 VM_SAFEPARMCOUNTRANGE(0,1,VM_gettime);
2880 PRVM_G_FLOAT(OFS_RETURN) = (float) realtime;
2884 timer_index = (int) PRVM_G_FLOAT(OFS_PARM0);
2887 case 0: // GETTIME_FRAMESTART
2888 PRVM_G_FLOAT(OFS_RETURN) = realtime;
2890 case 1: // GETTIME_REALTIME
2891 PRVM_G_FLOAT(OFS_RETURN) = Sys_DirtyTime();
2893 case 2: // GETTIME_HIRES
2894 PRVM_G_FLOAT(OFS_RETURN) = (Sys_DirtyTime() - host_dirtytime);
2896 case 3: // GETTIME_UPTIME
2897 PRVM_G_FLOAT(OFS_RETURN) = realtime;
2899 case 4: // GETTIME_CDTRACK
2900 PRVM_G_FLOAT(OFS_RETURN) = CDAudio_GetPosition();
2903 VM_Warning(prog, "VM_gettime: %s: unsupported timer specified, returning realtime\n", prog->name);
2904 PRVM_G_FLOAT(OFS_RETURN) = realtime;
2914 float getsoundtime(prvm_prog_t *prog)
2918 void VM_getsoundtime (prvm_prog_t *prog)
2920 int entnum, entchannel;
2921 VM_SAFEPARMCOUNT(2,VM_getsoundtime);
2923 if (prog == SVVM_prog)
2924 entnum = PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2925 else if (prog == CLVM_prog)
2926 entnum = MAX_EDICTS + PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2929 VM_Warning(prog, "VM_getsoundtime: %s: not supported on this progs\n", prog->name);
2930 PRVM_G_FLOAT(OFS_RETURN) = -1;
2933 entchannel = (int)PRVM_G_FLOAT(OFS_PARM1);
2934 entchannel = CHAN_USER2ENGINE(entchannel);
2935 if (!IS_CHAN(entchannel))
2936 VM_Warning(prog, "VM_getsoundtime: %s: bad channel %i\n", prog->name, entchannel);
2937 PRVM_G_FLOAT(OFS_RETURN) = (float)S_GetEntChannelPosition(entnum, entchannel);
2944 string soundlength (string sample)
2947 void VM_soundlength (prvm_prog_t *prog)
2951 VM_SAFEPARMCOUNT(1, VM_soundlength);
2953 s = PRVM_G_STRING(OFS_PARM0);
2954 PRVM_G_FLOAT(OFS_RETURN) = S_SoundLength(s);
2961 loadfromdata(string data)
2964 void VM_loadfromdata(prvm_prog_t *prog)
2966 VM_SAFEPARMCOUNT(1,VM_loadentsfromfile);
2968 PRVM_ED_LoadFromFile(prog, PRVM_G_STRING(OFS_PARM0));
2972 ========================
2975 parseentitydata(entity ent, string data)
2976 ========================
2978 void VM_parseentitydata(prvm_prog_t *prog)
2983 VM_SAFEPARMCOUNT(2, VM_parseentitydata);
2985 // get edict and test it
2986 ent = PRVM_G_EDICT(OFS_PARM0);
2987 if (ent->priv.required->free)
2988 prog->error_cmd("VM_parseentitydata: %s: Can only set already spawned entities (entity %i is free)!", prog->name, PRVM_NUM_FOR_EDICT(ent));
2990 data = PRVM_G_STRING(OFS_PARM1);
2992 // parse the opening brace
2993 if (!COM_ParseToken_Simple(&data, false, false, true) || com_token[0] != '{' )
2994 prog->error_cmd("VM_parseentitydata: %s: Couldn't parse entity data:\n%s", prog->name, data );
2996 PRVM_ED_ParseEdict (prog, data, ent);
3003 loadfromfile(string file)
3006 void VM_loadfromfile(prvm_prog_t *prog)
3008 const char *filename;
3011 VM_SAFEPARMCOUNT(1,VM_loadfromfile);
3013 filename = PRVM_G_STRING(OFS_PARM0);
3014 if (FS_CheckNastyPath(filename, false))
3016 PRVM_G_FLOAT(OFS_RETURN) = -4;
3017 VM_Warning(prog, "VM_loadfromfile: %s dangerous or non-portable filename \"%s\" not allowed. (contains : or \\ or begins with .. or /)\n", prog->name, filename);
3021 // not conform with VM_fopen
3022 data = (char *)FS_LoadFile(filename, tempmempool, false, NULL);
3024 PRVM_G_FLOAT(OFS_RETURN) = -1;
3026 PRVM_ED_LoadFromFile(prog, data);
3037 float mod(float val, float m)
3040 void VM_modulo(prvm_prog_t *prog)
3043 VM_SAFEPARMCOUNT(2,VM_module);
3045 val = (int) PRVM_G_FLOAT(OFS_PARM0);
3046 m = (int) PRVM_G_FLOAT(OFS_PARM1);
3048 PRVM_G_FLOAT(OFS_RETURN) = (float) (val % m);
3051 static void VM_Search_Init(prvm_prog_t *prog)
3054 for (i = 0;i < PRVM_MAX_OPENSEARCHES;i++)
3055 prog->opensearches[i] = NULL;
3058 static void VM_Search_Reset(prvm_prog_t *prog)
3061 // reset the fssearch list
3062 for(i = 0; i < PRVM_MAX_OPENSEARCHES; i++)
3064 if(prog->opensearches[i])
3065 FS_FreeSearch(prog->opensearches[i]);
3066 prog->opensearches[i] = NULL;
3074 float search_begin(string pattern, float caseinsensitive, float quiet)
3077 void VM_search_begin(prvm_prog_t *prog)
3080 const char *pattern;
3081 int caseinsens, quiet;
3083 VM_SAFEPARMCOUNT(3, VM_search_begin);
3085 pattern = PRVM_G_STRING(OFS_PARM0);
3087 VM_CheckEmptyString(prog, pattern);
3089 caseinsens = (int)PRVM_G_FLOAT(OFS_PARM1);
3090 quiet = (int)PRVM_G_FLOAT(OFS_PARM2);
3092 for(handle = 0; handle < PRVM_MAX_OPENSEARCHES; handle++)
3093 if(!prog->opensearches[handle])
3096 if(handle >= PRVM_MAX_OPENSEARCHES)
3098 PRVM_G_FLOAT(OFS_RETURN) = -2;
3099 VM_Warning(prog, "VM_search_begin: %s ran out of search handles (%i)\n", prog->name, PRVM_MAX_OPENSEARCHES);
3103 if(!(prog->opensearches[handle] = FS_Search(pattern,caseinsens, quiet)))
3104 PRVM_G_FLOAT(OFS_RETURN) = -1;
3107 prog->opensearches_origin[handle] = PRVM_AllocationOrigin(prog);
3108 PRVM_G_FLOAT(OFS_RETURN) = handle;
3116 void search_end(float handle)
3119 void VM_search_end(prvm_prog_t *prog)
3122 VM_SAFEPARMCOUNT(1, VM_search_end);
3124 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3126 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3128 VM_Warning(prog, "VM_search_end: invalid handle %i used in %s\n", handle, prog->name);
3131 if(prog->opensearches[handle] == NULL)
3133 VM_Warning(prog, "VM_search_end: no such handle %i in %s\n", handle, prog->name);
3137 FS_FreeSearch(prog->opensearches[handle]);
3138 prog->opensearches[handle] = NULL;
3139 if(prog->opensearches_origin[handle])
3140 PRVM_Free((char *)prog->opensearches_origin[handle]);
3147 float search_getsize(float handle)
3150 void VM_search_getsize(prvm_prog_t *prog)
3153 VM_SAFEPARMCOUNT(1, VM_M_search_getsize);
3155 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3157 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3159 VM_Warning(prog, "VM_search_getsize: invalid handle %i used in %s\n", handle, prog->name);
3162 if(prog->opensearches[handle] == NULL)
3164 VM_Warning(prog, "VM_search_getsize: no such handle %i in %s\n", handle, prog->name);
3168 PRVM_G_FLOAT(OFS_RETURN) = prog->opensearches[handle]->numfilenames;
3173 VM_search_getfilename
3175 string search_getfilename(float handle, float num)
3178 void VM_search_getfilename(prvm_prog_t *prog)
3180 int handle, filenum;
3181 VM_SAFEPARMCOUNT(2, VM_search_getfilename);
3183 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3184 filenum = (int)PRVM_G_FLOAT(OFS_PARM1);
3186 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3188 VM_Warning(prog, "VM_search_getfilename: invalid handle %i used in %s\n", handle, prog->name);
3191 if(prog->opensearches[handle] == NULL)
3193 VM_Warning(prog, "VM_search_getfilename: no such handle %i in %s\n", handle, prog->name);
3196 if(filenum < 0 || filenum >= prog->opensearches[handle]->numfilenames)
3198 VM_Warning(prog, "VM_search_getfilename: invalid filenum %i in %s\n", filenum, prog->name);
3202 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, prog->opensearches[handle]->filenames[filenum]);
3209 string chr(float ascii)
3212 void VM_chr(prvm_prog_t *prog)
3216 VM_SAFEPARMCOUNT(1, VM_chr);
3218 tmp[0] = (unsigned char) PRVM_G_FLOAT(OFS_PARM0);
3221 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3226 VM_SAFEPARMCOUNT(1, VM_chr);
3228 len = u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0), tmp, sizeof(tmp));
3230 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3233 //=============================================================================
3234 // Draw builtins (client & menu)
3240 float iscachedpic(string pic)
3243 void VM_iscachedpic(prvm_prog_t *prog)
3245 VM_SAFEPARMCOUNT(1,VM_iscachedpic);
3247 // drawq hasnt such a function, thus always return true
3248 PRVM_G_FLOAT(OFS_RETURN) = false;
3255 string precache_pic(string pic)
3258 #define PRECACHE_PIC_FROMWAD 1 /* FTEQW, not supported here */
3259 #define PRECACHE_PIC_NOTPERSISTENT 2
3260 //#define PRECACHE_PIC_NOCLAMP 4
3261 #define PRECACHE_PIC_MIPMAP 8
3262 void VM_precache_pic(prvm_prog_t *prog)
3267 VM_SAFEPARMCOUNTRANGE(1, 2, VM_precache_pic);
3269 s = PRVM_G_STRING(OFS_PARM0);
3270 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
3271 VM_CheckEmptyString(prog, s);
3275 int f = PRVM_G_FLOAT(OFS_PARM1);
3276 if(f & PRECACHE_PIC_NOTPERSISTENT)
3277 flags |= CACHEPICFLAG_NOTPERSISTENT;
3278 //if(f & PRECACHE_PIC_NOCLAMP)
3279 // flags |= CACHEPICFLAG_NOCLAMP;
3280 if(f & PRECACHE_PIC_MIPMAP)
3281 flags |= CACHEPICFLAG_MIPMAP;
3284 // AK Draw_CachePic is supposed to always return a valid pointer
3285 if( Draw_CachePic_Flags(s, flags)->tex == r_texture_notexture )
3286 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
3296 void VM_freepic(prvm_prog_t *prog)
3300 VM_SAFEPARMCOUNT(1,VM_freepic);
3302 s = PRVM_G_STRING(OFS_PARM0);
3303 VM_CheckEmptyString(prog, s);
3308 static void getdrawfontscale(prvm_prog_t *prog, float *sx, float *sy)
3312 VectorCopy(PRVM_drawglobalvector(drawfontscale), v);
3313 if(VectorLength2(v) > 0)
3320 static dp_font_t *getdrawfont(prvm_prog_t *prog)
3322 int f = (int) PRVM_drawglobalfloat(drawfont);
3323 if(f < 0 || f >= dp_fonts.maxsize)
3324 return FONT_DEFAULT;
3325 return &dp_fonts.f[f];
3332 float drawcharacter(vector position, float character, vector scale, vector rgb, float alpha, float flag)
3335 void VM_drawcharacter(prvm_prog_t *prog)
3337 prvm_vec_t *pos,*scale,*rgb;
3341 VM_SAFEPARMCOUNT(6,VM_drawcharacter);
3343 character = (char) PRVM_G_FLOAT(OFS_PARM1);
3346 PRVM_G_FLOAT(OFS_RETURN) = -1;
3347 VM_Warning(prog, "VM_drawcharacter: %s passed null character !\n",prog->name);
3351 pos = PRVM_G_VECTOR(OFS_PARM0);
3352 scale = PRVM_G_VECTOR(OFS_PARM2);
3353 rgb = PRVM_G_VECTOR(OFS_PARM3);
3354 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3356 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3358 PRVM_G_FLOAT(OFS_RETURN) = -2;
3359 VM_Warning(prog, "VM_drawcharacter: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3363 if(pos[2] || scale[2])
3364 VM_Warning(prog, "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")));
3366 if(!scale[0] || !scale[1])
3368 PRVM_G_FLOAT(OFS_RETURN) = -3;
3369 VM_Warning(prog, "VM_drawcharacter: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3373 getdrawfontscale(prog, &sx, &sy);
3374 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));
3375 PRVM_G_FLOAT(OFS_RETURN) = 1;
3382 float drawstring(vector position, string text, vector scale, vector rgb, float alpha[, float flag])
3385 void VM_drawstring(prvm_prog_t *prog)
3387 prvm_vec_t *pos,*scale,*rgb;
3391 VM_SAFEPARMCOUNTRANGE(5,6,VM_drawstring);
3393 string = PRVM_G_STRING(OFS_PARM1);
3394 pos = PRVM_G_VECTOR(OFS_PARM0);
3395 scale = PRVM_G_VECTOR(OFS_PARM2);
3396 rgb = PRVM_G_VECTOR(OFS_PARM3);
3397 if (prog->argc >= 6)
3398 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3400 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3402 PRVM_G_FLOAT(OFS_RETURN) = -2;
3403 VM_Warning(prog, "VM_drawstring: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3407 if(!scale[0] || !scale[1])
3409 PRVM_G_FLOAT(OFS_RETURN) = -3;
3410 VM_Warning(prog, "VM_drawstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3414 if(pos[2] || scale[2])
3415 VM_Warning(prog, "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")));
3417 getdrawfontscale(prog, &sx, &sy);
3418 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));
3419 //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);
3420 PRVM_G_FLOAT(OFS_RETURN) = 1;
3425 VM_drawcolorcodedstring
3427 float drawcolorcodedstring(vector position, string text, vector scale, float alpha, float flag)
3429 float drawcolorcodedstring(vector position, string text, vector scale, vector rgb, float alpha, float flag)
3432 void VM_drawcolorcodedstring(prvm_prog_t *prog)
3434 prvm_vec_t *pos, *scale;
3438 float sx, sy, alpha;
3440 VM_SAFEPARMCOUNTRANGE(5,6,VM_drawcolorcodedstring);
3442 if (prog->argc == 6) // full 6 parms, like normal drawstring
3444 pos = PRVM_G_VECTOR(OFS_PARM0);
3445 string = PRVM_G_STRING(OFS_PARM1);
3446 scale = PRVM_G_VECTOR(OFS_PARM2);
3447 VectorCopy(PRVM_G_VECTOR(OFS_PARM3), rgb);
3448 alpha = PRVM_G_FLOAT(OFS_PARM4);
3449 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3453 pos = PRVM_G_VECTOR(OFS_PARM0);
3454 string = PRVM_G_STRING(OFS_PARM1);
3455 scale = PRVM_G_VECTOR(OFS_PARM2);
3459 alpha = PRVM_G_FLOAT(OFS_PARM3);
3460 flag = (int)PRVM_G_FLOAT(OFS_PARM4);
3463 if(flag < DRAWFLAG_NORMAL || flag >= DRAWFLAG_NUMFLAGS)
3465 PRVM_G_FLOAT(OFS_RETURN) = -2;
3466 VM_Warning(prog, "VM_drawcolorcodedstring: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3470 if(!scale[0] || !scale[1])
3472 PRVM_G_FLOAT(OFS_RETURN) = -3;
3473 VM_Warning(prog, "VM_drawcolorcodedstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3477 if(pos[2] || scale[2])
3478 VM_Warning(prog, "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")));
3480 getdrawfontscale(prog, &sx, &sy);
3481 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));
3482 if (prog->argc == 6) // also return vector of last color
3483 VectorCopy(DrawQ_Color, PRVM_G_VECTOR(OFS_RETURN));
3485 PRVM_G_FLOAT(OFS_RETURN) = 1;
3491 float stringwidth(string text, float allowColorCodes, float size)
3494 void VM_stringwidth(prvm_prog_t *prog)
3498 float mult; // sz is intended font size so we can later add freetype support, mult is font size multiplier in pixels per character cell
3502 VM_SAFEPARMCOUNTRANGE(2,3,VM_drawstring);
3504 getdrawfontscale(prog, &sx, &sy);
3507 Vector2Copy(PRVM_G_VECTOR(OFS_PARM2), szv);
3512 // we want the width for 8x8 font size, divided by 8
3513 Vector2Set(szv, 8, 8);
3515 // to make sure snapping is turned off, ALWAYS use a nontrivial scale in this case
3516 if(sx >= 0.9 && sx <= 1.1)
3524 string = PRVM_G_STRING(OFS_PARM0);
3525 colors = (int)PRVM_G_FLOAT(OFS_PARM1);
3527 PRVM_G_FLOAT(OFS_RETURN) = DrawQ_TextWidth_UntilWidth_TrackColors_Scale(string, &maxlen, szv[0], szv[1], sx, sy, NULL, !colors, getdrawfont(prog), 1000000000) * mult;
3531 mult = sz = PRVM_G_FLOAT(OFS_PARM2);
3539 string = PRVM_G_STRING(OFS_PARM0);
3540 colors = (int)PRVM_G_FLOAT(OFS_PARM1);
3542 PRVM_G_FLOAT(OFS_RETURN) = DrawQ_TextWidth(string, 0, !colors, getdrawfont()) * mult; // 1x1 characters, don't actually draw
3550 float findfont(string s)
3554 static float getdrawfontnum(const char *fontname)
3558 for(i = 0; i < dp_fonts.maxsize; ++i)
3559 if(!strcmp(dp_fonts.f[i].title, fontname))
3564 void VM_findfont(prvm_prog_t *prog)
3566 VM_SAFEPARMCOUNT(1,VM_findfont);
3567 PRVM_G_FLOAT(OFS_RETURN) = getdrawfontnum(PRVM_G_STRING(OFS_PARM0));
3574 float loadfont(string fontname, string fontmaps, string sizes, float slot)
3578 void VM_loadfont(prvm_prog_t *prog)
3580 const char *fontname, *filelist, *sizes, *c, *cm;
3581 char mainfont[MAX_QPATH];
3583 float sz, scale, voffset;
3586 VM_SAFEPARMCOUNTRANGE(3,6,VM_loadfont);
3588 fontname = PRVM_G_STRING(OFS_PARM0);
3590 fontname = "default";
3592 filelist = PRVM_G_STRING(OFS_PARM1);
3594 filelist = "gfx/conchars";
3596 sizes = PRVM_G_STRING(OFS_PARM2);
3602 if (prog->argc >= 4)
3604 i = PRVM_G_FLOAT(OFS_PARM3);
3605 if (i >= 0 && i < dp_fonts.maxsize)
3608 strlcpy(f->title, fontname, sizeof(f->title)); // replace name
3612 f = FindFont(fontname, true);
3615 PRVM_G_FLOAT(OFS_RETURN) = -1;
3616 return; // something go wrong
3619 memset(f->fallbacks, 0, sizeof(f->fallbacks));
3620 memset(f->fallback_faces, 0, sizeof(f->fallback_faces));
3622 // first font is handled "normally"
3623 c = strchr(filelist, ':');
3624 cm = strchr(filelist, ',');
3625 if(c && (!cm || c < cm))
3626 f->req_face = atoi(c+1);
3632 if(!c || (c - filelist) > MAX_QPATH)
3633 strlcpy(mainfont, filelist, sizeof(mainfont));
3636 memcpy(mainfont, filelist, c - filelist);
3637 mainfont[c - filelist] = 0;
3641 for(i = 0; i < MAX_FONT_FALLBACKS; ++i)
3643 c = strchr(filelist, ',');
3649 c = strchr(filelist, ':');
3650 cm = strchr(filelist, ',');
3651 if(c && (!cm || c < cm))
3652 f->fallback_faces[i] = atoi(c+1);
3655 f->fallback_faces[i] = 0; // f->req_face; could make it stick to the default-font's face index
3658 if(!c || (c-filelist) > MAX_QPATH)
3660 strlcpy(f->fallbacks[i], filelist, sizeof(mainfont));
3664 memcpy(f->fallbacks[i], filelist, c - filelist);
3665 f->fallbacks[i][c - filelist] = 0;
3670 for(i = 0; i < MAX_FONT_SIZES; ++i)
3671 f->req_sizes[i] = -1;
3672 for (numsizes = 0,c = sizes;;)
3674 if (!COM_ParseToken_VM_Tokenize(&c, 0))
3676 sz = atof(com_token);
3678 if (sz < 0.001f || sz > 1000.0f)
3680 VM_Warning(prog, "VM_loadfont: crap size %s", com_token);
3684 if (numsizes == MAX_FONT_SIZES)
3686 VM_Warning(prog, "VM_loadfont: MAX_FONT_SIZES = %i exceeded", MAX_FONT_SIZES);
3689 f->req_sizes[numsizes] = sz;
3693 // additional scale/hoffset parms
3696 if (prog->argc >= 5)
3698 scale = PRVM_G_FLOAT(OFS_PARM4);
3702 if (prog->argc >= 6)
3703 voffset = PRVM_G_FLOAT(OFS_PARM5);
3706 LoadFont(true, mainfont, f, scale, voffset);
3708 // return index of loaded font
3709 PRVM_G_FLOAT(OFS_RETURN) = (f - dp_fonts.f);
3716 float drawpic(vector position, string pic, vector size, vector rgb, float alpha, float flag)
3719 void VM_drawpic(prvm_prog_t *prog)
3721 const char *picname;
3722 prvm_vec_t *size, *pos, *rgb;
3725 VM_SAFEPARMCOUNTRANGE(5,6,VM_drawpic);
3727 picname = PRVM_G_STRING(OFS_PARM1);
3728 VM_CheckEmptyString(prog, picname);
3730 // is pic cached ? no function yet for that
3733 PRVM_G_FLOAT(OFS_RETURN) = -4;
3734 VM_Warning(prog, "VM_drawpic: %s: %s not cached !\n", prog->name, picname);
3738 pos = PRVM_G_VECTOR(OFS_PARM0);
3739 size = PRVM_G_VECTOR(OFS_PARM2);
3740 rgb = PRVM_G_VECTOR(OFS_PARM3);
3741 if (prog->argc >= 6)
3742 flag = (int) PRVM_G_FLOAT(OFS_PARM5);
3744 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3746 PRVM_G_FLOAT(OFS_RETURN) = -2;
3747 VM_Warning(prog, "VM_drawpic: %s: wrong DRAWFLAG %i !\n",prog->name,flag);
3751 if(pos[2] || size[2])
3752 VM_Warning(prog, "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")));
3754 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);
3755 PRVM_G_FLOAT(OFS_RETURN) = 1;
3761 float drawrotpic(vector position, string pic, vector size, vector org, float angle, vector rgb, float alpha, float flag)
3764 void VM_drawrotpic(prvm_prog_t *prog)
3766 const char *picname;
3767 prvm_vec_t *size, *pos, *org, *rgb;