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"
17 extern cvar_t prvm_backtraceforwarnings;
19 // LordHavoc: changed this to NOT use a return statement, so that it can be used in functions that must return a value
20 void VM_Warning(const char *fmt, ...)
23 char msg[MAX_INPUTLINE];
24 static double recursive = -1;
27 dpvsnprintf(msg,sizeof(msg),fmt,argptr);
32 // TODO: either add a cvar/cmd to control the state dumping or replace some of the calls with Con_Printf [9/13/2006 Black]
33 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
42 //============================================================================
45 // TODO DONE: move vm_files and vm_fssearchlist to prvm_prog_t struct
46 // TODO: move vm_files and vm_fssearchlist back [9/13/2006 Black]
47 // TODO: (move vm_files and vm_fssearchlist to prvm_prog_t struct again) [2007-01-23 LordHavoc]
48 // TODO: will this war ever end? [2007-01-23 LordHavoc]
50 void VM_CheckEmptyString (const char *s)
52 if (ISWHITESPACE(s[0]))
53 PRVM_ERROR ("%s: Bad string", PRVM_NAME);
56 void VM_GenerateFrameGroupBlend(framegroupblend_t *framegroupblend, const prvm_edict_t *ed)
58 // self.frame is the interpolation target (new frame)
59 // self.frame1time is the animation base time for the interpolation target
60 // self.frame2 is the interpolation start (previous frame)
61 // self.frame2time is the animation base time for the interpolation start
62 // self.lerpfrac is the interpolation strength for self.frame2
63 // self.lerpfrac3 is the interpolation strength for self.frame3
64 // self.lerpfrac4 is the interpolation strength for self.frame4
65 // pitch angle on a player model where the animator set up 5 sets of
66 // animations and the csqc simply lerps between sets)
67 framegroupblend[0].frame = (int) PRVM_gameedictfloat(ed, frame );
68 framegroupblend[1].frame = (int) PRVM_gameedictfloat(ed, frame2 );
69 framegroupblend[2].frame = (int) PRVM_gameedictfloat(ed, frame3 );
70 framegroupblend[3].frame = (int) PRVM_gameedictfloat(ed, frame4 );
71 framegroupblend[0].start = PRVM_gameedictfloat(ed, frame1time);
72 framegroupblend[1].start = PRVM_gameedictfloat(ed, frame2time);
73 framegroupblend[2].start = PRVM_gameedictfloat(ed, frame3time);
74 framegroupblend[3].start = PRVM_gameedictfloat(ed, frame4time);
75 framegroupblend[1].lerp = PRVM_gameedictfloat(ed, lerpfrac );
76 framegroupblend[2].lerp = PRVM_gameedictfloat(ed, lerpfrac3 );
77 framegroupblend[3].lerp = PRVM_gameedictfloat(ed, lerpfrac4 );
78 // assume that the (missing) lerpfrac1 is whatever remains after lerpfrac2+lerpfrac3+lerpfrac4 are summed
79 framegroupblend[0].lerp = 1 - framegroupblend[1].lerp - framegroupblend[2].lerp - framegroupblend[3].lerp;
82 // LordHavoc: quite tempting to break apart this function to reuse the
83 // duplicated code, but I suspect it is better for performance
85 void VM_FrameBlendFromFrameGroupBlend(frameblend_t *frameblend, const framegroupblend_t *framegroupblend, const dp_model_t *model)
87 int sub2, numframes, f, i, k;
88 int isfirstframegroup = true;
90 double sublerp, lerp, d;
91 const animscene_t *scene;
92 const framegroupblend_t *g;
93 frameblend_t *blend = frameblend;
95 memset(blend, 0, MAX_FRAMEBLENDS * sizeof(*blend));
97 if (!model || !model->surfmesh.isanimated)
103 nolerp = (model->type == mod_sprite) ? !r_lerpsprites.integer : !r_lerpmodels.integer;
104 numframes = model->numframes;
105 for (k = 0, g = framegroupblend;k < MAX_FRAMEGROUPBLENDS;k++, g++)
108 if ((unsigned int)f >= (unsigned int)numframes)
110 Con_DPrintf("VM_FrameBlendFromFrameGroupBlend: no such frame %d in model %s\n", f, model->name);
118 if (isfirstframegroup)
121 isfirstframegroup = false;
126 if (model->animscenes)
128 scene = model->animscenes + f;
129 f = scene->firstframe;
130 if (scene->framecount > 1)
132 // this code path is only used on .zym models and torches
133 sublerp = scene->framerate * (cl.time - g->start);
134 f = (int) floor(sublerp);
137 if (sublerp < (1.0 / 65536.0f))
139 if (sublerp > (65535.0f / 65536.0f))
145 f = (f % scene->framecount);
146 sub2 = (sub2 % scene->framecount);
148 f = bound(0, f, (scene->framecount - 1)) + scene->firstframe;
149 sub2 = bound(0, sub2, (scene->framecount - 1)) + scene->firstframe;
151 // two framelerps produced from one animation
154 for (i = 0;i < MAX_FRAMEBLENDS;i++)
156 if (blend[i].lerp <= 0 || blend[i].subframe == sub2)
158 blend[i].subframe = sub2;
164 d = (1 - sublerp) * lerp;
169 for (i = 0;i < MAX_FRAMEBLENDS;i++)
171 if (blend[i].lerp <= 0 || blend[i].subframe == f)
173 blend[i].subframe = f;
182 void VM_UpdateEdictSkeleton(prvm_edict_t *ed, const dp_model_t *edmodel, const frameblend_t *frameblend)
184 if (ed->priv.server->skeleton.model != edmodel)
186 VM_RemoveEdictSkeleton(ed);
187 ed->priv.server->skeleton.model = edmodel;
189 if (!ed->priv.server->skeleton.model || !ed->priv.server->skeleton.model->num_bones)
191 if(ed->priv.server->skeleton.relativetransforms)
192 Mem_Free(ed->priv.server->skeleton.relativetransforms);
193 ed->priv.server->skeleton.relativetransforms = NULL;
198 int skeletonindex = -1;
199 skeleton_t *skeleton;
200 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
201 if (skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones)
203 // custom skeleton controlled by the game (FTE_CSQC_SKELETONOBJECTS)
204 if (!ed->priv.server->skeleton.relativetransforms)
205 ed->priv.server->skeleton.relativetransforms = (matrix4x4_t *)Mem_Alloc(prog->progs_mempool, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
206 memcpy(ed->priv.server->skeleton.relativetransforms, skeleton->relativetransforms, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
210 if(ed->priv.server->skeleton.relativetransforms)
211 Mem_Free(ed->priv.server->skeleton.relativetransforms);
212 ed->priv.server->skeleton.relativetransforms = NULL;
217 void VM_RemoveEdictSkeleton(prvm_edict_t *ed)
219 if (ed->priv.server->skeleton.relativetransforms)
220 Mem_Free(ed->priv.server->skeleton.relativetransforms);
221 memset(&ed->priv.server->skeleton, 0, sizeof(ed->priv.server->skeleton));
227 //============================================================================
230 void VM_VarString(int first, char *out, int outlength)
236 outend = out + outlength - 1;
237 for (i = first;i < prog->argc && out < outend;i++)
239 s = PRVM_G_STRING((OFS_PARM0+i*3));
240 while (out < outend && *s)
250 returns true if the extension is supported by the server
252 checkextension(extensionname)
256 // kind of helper function
257 static qboolean checkextension(const char *name)
260 const char *e, *start;
261 len = (int)strlen(name);
263 for (e = prog->extensionstring;*e;e++)
270 while (*e && *e != ' ')
272 if ((e - start) == len && !strncasecmp(start, name, len))
274 // special sheck for ODE
275 if (!strncasecmp("DP_PHYSICS_ODE", name, 14))
278 return ode_dll ? true : false;
289 void VM_checkextension (void)
291 VM_SAFEPARMCOUNT(1,VM_checkextension);
293 PRVM_G_FLOAT(OFS_RETURN) = checkextension(PRVM_G_STRING(OFS_PARM0));
300 This is a TERMINAL error, which will kill off the entire prog.
309 char string[VM_STRINGTEMP_LENGTH];
311 VM_VarString(0, string, sizeof(string));
312 Con_Printf("======%s ERROR in %s:\n%s\n", PRVM_NAME, PRVM_GetString(prog->xfunction->s_name), string);
313 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
314 PRVM_ED_Print(ed, NULL);
316 PRVM_ERROR ("%s: Program error in function %s:\n%s\nTip: read above for entity information\n", PRVM_NAME, PRVM_GetString(prog->xfunction->s_name), string);
323 Dumps out self, then an error message. The program is aborted and self is
324 removed, but the level can continue.
329 void VM_objerror (void)
332 char string[VM_STRINGTEMP_LENGTH];
334 VM_VarString(0, string, sizeof(string));
335 Con_Printf("======OBJECT ERROR======\n"); // , PRVM_NAME, PRVM_GetString(prog->xfunction->s_name), string); // or include them? FIXME
336 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
337 PRVM_ED_Print(ed, NULL);
339 Con_Printf("%s OBJECT ERROR in %s:\n%s\nTip: read above for entity information\n", PRVM_NAME, PRVM_GetString(prog->xfunction->s_name), string);
353 char string[VM_STRINGTEMP_LENGTH];
355 VM_VarString(0, string, sizeof(string));
363 broadcast print to everyone on server
368 void VM_bprint (void)
370 char string[VM_STRINGTEMP_LENGTH];
374 VM_Warning("VM_bprint: game is not server(%s) !\n", PRVM_NAME);
378 VM_VarString(0, string, sizeof(string));
379 SV_BroadcastPrint(string);
384 VM_sprint (menu & client but only if server.active == true)
386 single print to a specific client
388 sprint(float clientnum,...[string])
391 void VM_sprint (void)
395 char string[VM_STRINGTEMP_LENGTH];
397 VM_SAFEPARMCOUNTRANGE(1, 8, VM_sprint);
399 //find client for this entity
400 clientnum = (int)PRVM_G_FLOAT(OFS_PARM0);
401 if (!sv.active || clientnum < 0 || clientnum >= svs.maxclients || !svs.clients[clientnum].active)
403 VM_Warning("VM_sprint: %s: invalid client or server is not active !\n", PRVM_NAME);
407 client = svs.clients + clientnum;
408 if (!client->netconnection)
411 VM_VarString(1, string, sizeof(string));
412 MSG_WriteChar(&client->netconnection->message,svc_print);
413 MSG_WriteString(&client->netconnection->message, string);
420 single print to the screen
425 void VM_centerprint (void)
427 char string[VM_STRINGTEMP_LENGTH];
429 VM_SAFEPARMCOUNTRANGE(1, 8, VM_centerprint);
430 VM_VarString(0, string, sizeof(string));
431 SCR_CenterPrint(string);
438 vector normalize(vector)
441 void VM_normalize (void)
447 VM_SAFEPARMCOUNT(1,VM_normalize);
449 value1 = PRVM_G_VECTOR(OFS_PARM0);
451 f = VectorLength2(value1);
455 VectorScale(value1, f, newvalue);
458 VectorClear(newvalue);
460 VectorCopy (newvalue, PRVM_G_VECTOR(OFS_RETURN));
472 VM_SAFEPARMCOUNT(1,VM_vlen);
473 PRVM_G_FLOAT(OFS_RETURN) = VectorLength(PRVM_G_VECTOR(OFS_PARM0));
480 float vectoyaw(vector)
483 void VM_vectoyaw (void)
488 VM_SAFEPARMCOUNT(1,VM_vectoyaw);
490 value1 = PRVM_G_VECTOR(OFS_PARM0);
492 if (value1[1] == 0 && value1[0] == 0)
496 yaw = (int) (atan2(value1[1], value1[0]) * 180 / M_PI);
501 PRVM_G_FLOAT(OFS_RETURN) = yaw;
509 vector vectoangles(vector[, vector])
512 void VM_vectoangles (void)
514 VM_SAFEPARMCOUNTRANGE(1, 2,VM_vectoangles);
516 AnglesFromVectors(PRVM_G_VECTOR(OFS_RETURN), PRVM_G_VECTOR(OFS_PARM0), prog->argc >= 2 ? PRVM_G_VECTOR(OFS_PARM1) : NULL, true);
523 Returns a number from 0<= num < 1
528 void VM_random (void)
530 VM_SAFEPARMCOUNT(0,VM_random);
532 PRVM_G_FLOAT(OFS_RETURN) = lhrandom(0, 1);
539 localsound(string sample)
542 void VM_localsound(void)
546 VM_SAFEPARMCOUNT(1,VM_localsound);
548 s = PRVM_G_STRING(OFS_PARM0);
550 if(!S_LocalSound (s))
552 PRVM_G_FLOAT(OFS_RETURN) = -4;
553 VM_Warning("VM_localsound: Failed to play %s for %s !\n", s, PRVM_NAME);
557 PRVM_G_FLOAT(OFS_RETURN) = 1;
569 PRVM_ERROR ("%s: break statement", PRVM_NAME);
572 //============================================================================
578 Sends text over to the client's execution buffer
580 [localcmd (string, ...) or]
584 void VM_localcmd (void)
586 char string[VM_STRINGTEMP_LENGTH];
587 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd);
588 VM_VarString(0, string, sizeof(string));
589 Cbuf_AddText(string);
592 static qboolean PRVM_Cvar_ReadOk(const char *string)
595 cvar = Cvar_FindVar(string);
596 return ((cvar) && ((cvar->flags & CVAR_PRIVATE) == 0));
608 char string[VM_STRINGTEMP_LENGTH];
609 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
610 VM_VarString(0, string, sizeof(string));
611 VM_CheckEmptyString(string);
612 PRVM_G_FLOAT(OFS_RETURN) = PRVM_Cvar_ReadOk(string) ? Cvar_VariableValue(string) : 0;
619 float cvar_type (string)
620 float CVAR_TYPEFLAG_EXISTS = 1;
621 float CVAR_TYPEFLAG_SAVED = 2;
622 float CVAR_TYPEFLAG_PRIVATE = 4;
623 float CVAR_TYPEFLAG_ENGINE = 8;
624 float CVAR_TYPEFLAG_HASDESCRIPTION = 16;
625 float CVAR_TYPEFLAG_READONLY = 32;
628 void VM_cvar_type (void)
630 char string[VM_STRINGTEMP_LENGTH];
634 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
635 VM_VarString(0, string, sizeof(string));
636 VM_CheckEmptyString(string);
637 cvar = Cvar_FindVar(string);
642 PRVM_G_FLOAT(OFS_RETURN) = 0;
643 return; // CVAR_TYPE_NONE
646 ret = 1; // CVAR_EXISTS
647 if(cvar->flags & CVAR_SAVE)
648 ret |= 2; // CVAR_TYPE_SAVED
649 if(cvar->flags & CVAR_PRIVATE)
650 ret |= 4; // CVAR_TYPE_PRIVATE
651 if(!(cvar->flags & CVAR_ALLOCATED))
652 ret |= 8; // CVAR_TYPE_ENGINE
653 if(cvar->description != cvar_dummy_description)
654 ret |= 16; // CVAR_TYPE_HASDESCRIPTION
655 if(cvar->flags & CVAR_READONLY)
656 ret |= 32; // CVAR_TYPE_READONLY
658 PRVM_G_FLOAT(OFS_RETURN) = ret;
665 const string VM_cvar_string (string, ...)
668 void VM_cvar_string(void)
670 char string[VM_STRINGTEMP_LENGTH];
671 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_string);
672 VM_VarString(0, string, sizeof(string));
673 VM_CheckEmptyString(string);
674 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(PRVM_Cvar_ReadOk(string) ? Cvar_VariableString(string) : "");
679 ========================
682 const string VM_cvar_defstring (string, ...)
683 ========================
685 void VM_cvar_defstring (void)
687 char string[VM_STRINGTEMP_LENGTH];
688 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_defstring);
689 VM_VarString(0, string, sizeof(string));
690 VM_CheckEmptyString(string);
691 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(Cvar_VariableDefString(string));
695 ========================
698 const string VM_cvar_description (string, ...)
699 ========================
701 void VM_cvar_description (void)
703 char string[VM_STRINGTEMP_LENGTH];
704 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_description);
705 VM_VarString(0, string, sizeof(string));
706 VM_CheckEmptyString(string);
707 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(Cvar_VariableDescription(string));
713 void cvar_set (string,string, ...)
716 void VM_cvar_set (void)
719 char string[VM_STRINGTEMP_LENGTH];
720 VM_SAFEPARMCOUNTRANGE(2,8,VM_cvar_set);
721 VM_VarString(1, string, sizeof(string));
722 name = PRVM_G_STRING(OFS_PARM0);
723 VM_CheckEmptyString(name);
724 Cvar_Set(name, string);
734 void VM_dprint (void)
736 char string[VM_STRINGTEMP_LENGTH];
737 VM_SAFEPARMCOUNTRANGE(1, 8, VM_dprint);
738 VM_VarString(0, string, sizeof(string));
740 Con_DPrintf("%s", string);
742 Con_DPrintf("%s: %s", PRVM_NAME, string);
759 VM_SAFEPARMCOUNT(1, VM_ftos);
761 v = PRVM_G_FLOAT(OFS_PARM0);
763 if ((float)((int)v) == v)
764 dpsnprintf(s, sizeof(s), "%i", (int)v);
766 dpsnprintf(s, sizeof(s), "%f", v);
767 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
782 VM_SAFEPARMCOUNT(1,VM_fabs);
784 v = PRVM_G_FLOAT(OFS_PARM0);
785 PRVM_G_FLOAT(OFS_RETURN) = fabs(v);
800 VM_SAFEPARMCOUNT(1,VM_vtos);
802 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]);
803 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
818 VM_SAFEPARMCOUNT(1, VM_etos);
820 dpsnprintf (s, sizeof(s), "entity %i", PRVM_G_EDICTNUM(OFS_PARM0));
821 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
828 float stof(...[string])
833 char string[VM_STRINGTEMP_LENGTH];
834 VM_SAFEPARMCOUNTRANGE(1, 8, VM_stof);
835 VM_VarString(0, string, sizeof(string));
836 PRVM_G_FLOAT(OFS_RETURN) = atof(string);
840 ========================
844 ========================
848 VM_SAFEPARMCOUNT(1, VM_itof);
849 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
853 ========================
856 entity ftoe(float num)
857 ========================
862 VM_SAFEPARMCOUNT(1, VM_ftoe);
864 ent = (int)PRVM_G_FLOAT(OFS_PARM0);
865 if (ent < 0 || ent >= prog->max_edicts || PRVM_PROG_TO_EDICT(ent)->priv.required->free)
866 ent = 0; // return world instead of a free or invalid entity
868 PRVM_G_INT(OFS_RETURN) = ent;
872 ========================
875 float etof(entity ent)
876 ========================
880 VM_SAFEPARMCOUNT(1, VM_etof);
881 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICTNUM(OFS_PARM0);
888 string strftime(float uselocaltime, string[, string ...])
891 void VM_strftime(void)
900 char fmt[VM_STRINGTEMP_LENGTH];
901 char result[VM_STRINGTEMP_LENGTH];
902 VM_SAFEPARMCOUNTRANGE(2, 8, VM_strftime);
903 VM_VarString(1, fmt, sizeof(fmt));
906 if (PRVM_G_FLOAT(OFS_PARM0))
907 tmresult = localtime_s(&tm, &t);
909 tmresult = gmtime_s(&tm, &t);
912 if (PRVM_G_FLOAT(OFS_PARM0))
919 PRVM_G_INT(OFS_RETURN) = 0;
923 strftime(result, sizeof(result), fmt, &tm);
925 strftime(result, sizeof(result), fmt, tm);
927 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(result);
941 VM_SAFEPARMCOUNT(0, VM_spawn);
942 prog->xfunction->builtinsprofile += 20;
943 ed = PRVM_ED_Alloc();
955 void VM_remove (void)
958 prog->xfunction->builtinsprofile += 20;
960 VM_SAFEPARMCOUNT(1, VM_remove);
962 ed = PRVM_G_EDICT(OFS_PARM0);
963 if( PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
965 if (developer.integer > 0)
966 VM_Warning( "VM_remove: tried to remove the null entity or a reserved entity!\n" );
968 else if( ed->priv.required->free )
970 if (developer.integer > 0)
971 VM_Warning( "VM_remove: tried to remove an already freed entity!\n" );
981 entity find(entity start, .string field, string match)
992 VM_SAFEPARMCOUNT(3,VM_find);
994 e = PRVM_G_EDICTNUM(OFS_PARM0);
995 f = PRVM_G_INT(OFS_PARM1);
996 s = PRVM_G_STRING(OFS_PARM2);
998 // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
999 // expects it to find all the monsters, so we must be careful to support
1002 for (e++ ; e < prog->num_edicts ; e++)
1004 prog->xfunction->builtinsprofile++;
1005 ed = PRVM_EDICT_NUM(e);
1006 if (ed->priv.required->free)
1008 t = PRVM_E_STRING(ed,f);
1013 VM_RETURN_EDICT(ed);
1018 VM_RETURN_EDICT(prog->edicts);
1025 entity findfloat(entity start, .float field, float match)
1026 entity findentity(entity start, .entity field, entity match)
1029 // LordHavoc: added this for searching float, int, and entity reference fields
1030 void VM_findfloat (void)
1037 VM_SAFEPARMCOUNT(3,VM_findfloat);
1039 e = PRVM_G_EDICTNUM(OFS_PARM0);
1040 f = PRVM_G_INT(OFS_PARM1);
1041 s = PRVM_G_FLOAT(OFS_PARM2);
1043 for (e++ ; e < prog->num_edicts ; e++)
1045 prog->xfunction->builtinsprofile++;
1046 ed = PRVM_EDICT_NUM(e);
1047 if (ed->priv.required->free)
1049 if (PRVM_E_FLOAT(ed,f) == s)
1051 VM_RETURN_EDICT(ed);
1056 VM_RETURN_EDICT(prog->edicts);
1063 entity findchain(.string field, string match)
1066 // chained search for strings in entity fields
1067 // entity(.string field, string match) findchain = #402;
1068 void VM_findchain (void)
1073 prvm_edict_t *ent, *chain;
1076 VM_SAFEPARMCOUNTRANGE(2,3,VM_findchain);
1079 chainfield = PRVM_G_INT(OFS_PARM2);
1081 chainfield = prog->fieldoffsets.chain;
1083 PRVM_ERROR("VM_findchain: %s doesnt have the specified chain field !", PRVM_NAME);
1085 chain = prog->edicts;
1087 f = PRVM_G_INT(OFS_PARM0);
1088 s = PRVM_G_STRING(OFS_PARM1);
1090 // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1091 // expects it to find all the monsters, so we must be careful to support
1094 ent = PRVM_NEXT_EDICT(prog->edicts);
1095 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1097 prog->xfunction->builtinsprofile++;
1098 if (ent->priv.required->free)
1100 t = PRVM_E_STRING(ent,f);
1106 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_NUM_FOR_EDICT(chain);
1110 VM_RETURN_EDICT(chain);
1117 entity findchainfloat(.string field, float match)
1118 entity findchainentity(.string field, entity match)
1121 // LordHavoc: chained search for float, int, and entity reference fields
1122 // entity(.string field, float match) findchainfloat = #403;
1123 void VM_findchainfloat (void)
1128 prvm_edict_t *ent, *chain;
1131 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainfloat);
1134 chainfield = PRVM_G_INT(OFS_PARM2);
1136 chainfield = prog->fieldoffsets.chain;
1138 PRVM_ERROR("VM_findchain: %s doesnt have the specified chain field !", PRVM_NAME);
1140 chain = (prvm_edict_t *)prog->edicts;
1142 f = PRVM_G_INT(OFS_PARM0);
1143 s = PRVM_G_FLOAT(OFS_PARM1);
1145 ent = PRVM_NEXT_EDICT(prog->edicts);
1146 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1148 prog->xfunction->builtinsprofile++;
1149 if (ent->priv.required->free)
1151 if (PRVM_E_FLOAT(ent,f) != s)
1154 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1158 VM_RETURN_EDICT(chain);
1162 ========================
1165 entity findflags(entity start, .float field, float match)
1166 ========================
1168 // LordHavoc: search for flags in float fields
1169 void VM_findflags (void)
1176 VM_SAFEPARMCOUNT(3, VM_findflags);
1179 e = PRVM_G_EDICTNUM(OFS_PARM0);
1180 f = PRVM_G_INT(OFS_PARM1);
1181 s = (int)PRVM_G_FLOAT(OFS_PARM2);
1183 for (e++ ; e < prog->num_edicts ; e++)
1185 prog->xfunction->builtinsprofile++;
1186 ed = PRVM_EDICT_NUM(e);
1187 if (ed->priv.required->free)
1189 if (!PRVM_E_FLOAT(ed,f))
1191 if ((int)PRVM_E_FLOAT(ed,f) & s)
1193 VM_RETURN_EDICT(ed);
1198 VM_RETURN_EDICT(prog->edicts);
1202 ========================
1205 entity findchainflags(.float field, float match)
1206 ========================
1208 // LordHavoc: chained search for flags in float fields
1209 void VM_findchainflags (void)
1214 prvm_edict_t *ent, *chain;
1217 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainflags);
1220 chainfield = PRVM_G_INT(OFS_PARM2);
1222 chainfield = prog->fieldoffsets.chain;
1224 PRVM_ERROR("VM_findchain: %s doesnt have the specified chain field !", PRVM_NAME);
1226 chain = (prvm_edict_t *)prog->edicts;
1228 f = PRVM_G_INT(OFS_PARM0);
1229 s = (int)PRVM_G_FLOAT(OFS_PARM1);
1231 ent = PRVM_NEXT_EDICT(prog->edicts);
1232 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1234 prog->xfunction->builtinsprofile++;
1235 if (ent->priv.required->free)
1237 if (!PRVM_E_FLOAT(ent,f))
1239 if (!((int)PRVM_E_FLOAT(ent,f) & s))
1242 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1246 VM_RETURN_EDICT(chain);
1253 string precache_sound (string sample)
1256 void VM_precache_sound (void)
1260 VM_SAFEPARMCOUNT(1, VM_precache_sound);
1262 s = PRVM_G_STRING(OFS_PARM0);
1263 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1264 //VM_CheckEmptyString(s);
1266 if(snd_initialized.integer && !S_PrecacheSound(s, true, true))
1268 VM_Warning("VM_precache_sound: Failed to load %s for %s\n", s, PRVM_NAME);
1277 returns the same string as output
1279 does nothing, only used by qcc to build .pak archives
1282 void VM_precache_file (void)
1284 VM_SAFEPARMCOUNT(1,VM_precache_file);
1285 // precache_file is only used to copy files with qcc, it does nothing
1286 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1296 void VM_coredump (void)
1298 VM_SAFEPARMCOUNT(0,VM_coredump);
1300 Cbuf_AddText("prvm_edicts ");
1301 Cbuf_AddText(PRVM_NAME);
1312 void PRVM_StackTrace(void);
1313 void VM_stackdump (void)
1315 VM_SAFEPARMCOUNT(0, VM_stackdump);
1330 VM_SAFEPARMCOUNT(0, VM_crash);
1332 PRVM_ERROR("Crash called by %s",PRVM_NAME);
1342 void VM_traceon (void)
1344 VM_SAFEPARMCOUNT(0,VM_traceon);
1356 void VM_traceoff (void)
1358 VM_SAFEPARMCOUNT(0,VM_traceoff);
1360 prog->trace = false;
1370 void VM_eprint (void)
1372 VM_SAFEPARMCOUNT(1,VM_eprint);
1374 PRVM_ED_PrintNum (PRVM_G_EDICTNUM(OFS_PARM0), NULL);
1387 VM_SAFEPARMCOUNT(1,VM_rint);
1389 f = PRVM_G_FLOAT(OFS_PARM0);
1391 PRVM_G_FLOAT(OFS_RETURN) = floor(f + 0.5);
1393 PRVM_G_FLOAT(OFS_RETURN) = ceil(f - 0.5);
1403 void VM_floor (void)
1405 VM_SAFEPARMCOUNT(1,VM_floor);
1407 PRVM_G_FLOAT(OFS_RETURN) = floor(PRVM_G_FLOAT(OFS_PARM0));
1419 VM_SAFEPARMCOUNT(1,VM_ceil);
1421 PRVM_G_FLOAT(OFS_RETURN) = ceil(PRVM_G_FLOAT(OFS_PARM0));
1429 entity nextent(entity)
1432 void VM_nextent (void)
1437 VM_SAFEPARMCOUNT(1, VM_nextent);
1439 i = PRVM_G_EDICTNUM(OFS_PARM0);
1442 prog->xfunction->builtinsprofile++;
1444 if (i == prog->num_edicts)
1446 VM_RETURN_EDICT(prog->edicts);
1449 ent = PRVM_EDICT_NUM(i);
1450 if (!ent->priv.required->free)
1452 VM_RETURN_EDICT(ent);
1458 //=============================================================================
1465 changelevel(string map)
1468 void VM_changelevel (void)
1470 VM_SAFEPARMCOUNT(1, VM_changelevel);
1474 VM_Warning("VM_changelevel: game is not server (%s)\n", PRVM_NAME);
1478 // make sure we don't issue two changelevels
1479 if (svs.changelevel_issued)
1481 svs.changelevel_issued = true;
1483 Cbuf_AddText (va("changelevel %s\n",PRVM_G_STRING(OFS_PARM0)));
1495 VM_SAFEPARMCOUNT(1,VM_sin);
1496 PRVM_G_FLOAT(OFS_RETURN) = sin(PRVM_G_FLOAT(OFS_PARM0));
1507 VM_SAFEPARMCOUNT(1,VM_cos);
1508 PRVM_G_FLOAT(OFS_RETURN) = cos(PRVM_G_FLOAT(OFS_PARM0));
1520 VM_SAFEPARMCOUNT(1,VM_sqrt);
1521 PRVM_G_FLOAT(OFS_RETURN) = sqrt(PRVM_G_FLOAT(OFS_PARM0));
1533 VM_SAFEPARMCOUNT(1,VM_asin);
1534 PRVM_G_FLOAT(OFS_RETURN) = asin(PRVM_G_FLOAT(OFS_PARM0));
1545 VM_SAFEPARMCOUNT(1,VM_acos);
1546 PRVM_G_FLOAT(OFS_RETURN) = acos(PRVM_G_FLOAT(OFS_PARM0));
1557 VM_SAFEPARMCOUNT(1,VM_atan);
1558 PRVM_G_FLOAT(OFS_RETURN) = atan(PRVM_G_FLOAT(OFS_PARM0));
1564 float atan2(float,float)
1567 void VM_atan2 (void)
1569 VM_SAFEPARMCOUNT(2,VM_atan2);
1570 PRVM_G_FLOAT(OFS_RETURN) = atan2(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1581 VM_SAFEPARMCOUNT(1,VM_tan);
1582 PRVM_G_FLOAT(OFS_RETURN) = tan(PRVM_G_FLOAT(OFS_PARM0));
1589 Returns a vector of length < 1 and > 0
1594 void VM_randomvec (void)
1599 VM_SAFEPARMCOUNT(0, VM_randomvec);
1604 temp[0] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1605 temp[1] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1606 temp[2] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1608 while (DotProduct(temp, temp) >= 1);
1609 VectorCopy (temp, PRVM_G_VECTOR(OFS_RETURN));
1612 temp[0] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1613 temp[1] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1614 temp[2] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1615 // length returned always > 0
1616 length = (rand()&32766 + 1) * (1.0 / 32767.0) / VectorLength(temp);
1617 VectorScale(temp,length, temp);*/
1618 //VectorCopy(temp, PRVM_G_VECTOR(OFS_RETURN));
1621 //=============================================================================
1627 float registercvar (string name, string value[, float flags])
1630 void VM_registercvar (void)
1632 const char *name, *value;
1635 VM_SAFEPARMCOUNTRANGE(2, 3, VM_registercvar);
1637 name = PRVM_G_STRING(OFS_PARM0);
1638 value = PRVM_G_STRING(OFS_PARM1);
1639 flags = prog->argc >= 3 ? (int)PRVM_G_FLOAT(OFS_PARM2) : 0;
1640 PRVM_G_FLOAT(OFS_RETURN) = 0;
1642 if(flags > CVAR_MAXFLAGSVAL)
1645 // first check to see if it has already been defined
1646 if (Cvar_FindVar (name))
1649 // check for overlap with a command
1650 if (Cmd_Exists (name))
1652 VM_Warning("VM_registercvar: %s is a command\n", name);
1656 Cvar_Get(name, value, flags, NULL);
1658 PRVM_G_FLOAT(OFS_RETURN) = 1; // success
1666 returns the minimum of two supplied floats
1668 float min(float a, float b, ...[float])
1673 VM_SAFEPARMCOUNTRANGE(2, 8, VM_min);
1674 // LordHavoc: 3+ argument enhancement suggested by FrikaC
1675 if (prog->argc >= 3)
1678 float f = PRVM_G_FLOAT(OFS_PARM0);
1679 for (i = 1;i < prog->argc;i++)
1680 if (f > PRVM_G_FLOAT((OFS_PARM0+i*3)))
1681 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1682 PRVM_G_FLOAT(OFS_RETURN) = f;
1685 PRVM_G_FLOAT(OFS_RETURN) = min(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1692 returns the maximum of two supplied floats
1694 float max(float a, float b, ...[float])
1699 VM_SAFEPARMCOUNTRANGE(2, 8, VM_max);
1700 // LordHavoc: 3+ argument enhancement suggested by FrikaC
1701 if (prog->argc >= 3)
1704 float f = PRVM_G_FLOAT(OFS_PARM0);
1705 for (i = 1;i < prog->argc;i++)
1706 if (f < PRVM_G_FLOAT((OFS_PARM0+i*3)))
1707 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1708 PRVM_G_FLOAT(OFS_RETURN) = f;
1711 PRVM_G_FLOAT(OFS_RETURN) = max(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1718 returns number bounded by supplied range
1720 float bound(float min, float value, float max)
1723 void VM_bound (void)
1725 VM_SAFEPARMCOUNT(3,VM_bound);
1726 PRVM_G_FLOAT(OFS_RETURN) = bound(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1), PRVM_G_FLOAT(OFS_PARM2));
1733 returns a raised to power b
1735 float pow(float a, float b)
1740 VM_SAFEPARMCOUNT(2,VM_pow);
1741 PRVM_G_FLOAT(OFS_RETURN) = pow(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1746 VM_SAFEPARMCOUNT(1,VM_log);
1747 PRVM_G_FLOAT(OFS_RETURN) = log(PRVM_G_FLOAT(OFS_PARM0));
1750 void VM_Files_Init(void)
1753 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1754 prog->openfiles[i] = NULL;
1757 void VM_Files_CloseAll(void)
1760 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1762 if (prog->openfiles[i])
1763 FS_Close(prog->openfiles[i]);
1764 prog->openfiles[i] = NULL;
1768 static qfile_t *VM_GetFileHandle( int index )
1770 if (index < 0 || index >= PRVM_MAX_OPENFILES)
1772 Con_Printf("VM_GetFileHandle: invalid file handle %i used in %s\n", index, PRVM_NAME);
1775 if (prog->openfiles[index] == NULL)
1777 Con_Printf("VM_GetFileHandle: no such file handle %i (or file has been closed) in %s\n", index, PRVM_NAME);
1780 return prog->openfiles[index];
1787 float fopen(string filename, float mode)
1790 // float(string filename, float mode) fopen = #110;
1791 // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE),
1792 // returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason
1796 const char *modestring, *filename;
1798 VM_SAFEPARMCOUNT(2,VM_fopen);
1800 for (filenum = 0;filenum < PRVM_MAX_OPENFILES;filenum++)
1801 if (prog->openfiles[filenum] == NULL)
1803 if (filenum >= PRVM_MAX_OPENFILES)
1805 PRVM_G_FLOAT(OFS_RETURN) = -2;
1806 VM_Warning("VM_fopen: %s ran out of file handles (%i)\n", PRVM_NAME, PRVM_MAX_OPENFILES);
1809 filename = PRVM_G_STRING(OFS_PARM0);
1810 mode = (int)PRVM_G_FLOAT(OFS_PARM1);
1813 case 0: // FILE_READ
1815 prog->openfiles[filenum] = FS_OpenVirtualFile(va("data/%s", filename), false);
1816 if (prog->openfiles[filenum] == NULL)
1817 prog->openfiles[filenum] = FS_OpenVirtualFile(va("%s", filename), false);
1819 case 1: // FILE_APPEND
1821 prog->openfiles[filenum] = FS_OpenRealFile(va("data/%s", filename), modestring, false);
1823 case 2: // FILE_WRITE
1825 prog->openfiles[filenum] = FS_OpenRealFile(va("data/%s", filename), modestring, false);
1828 PRVM_G_FLOAT(OFS_RETURN) = -3;
1829 VM_Warning("VM_fopen: %s: no such mode %i (valid: 0 = read, 1 = append, 2 = write)\n", PRVM_NAME, mode);
1833 if (prog->openfiles[filenum] == NULL)
1835 PRVM_G_FLOAT(OFS_RETURN) = -1;
1836 if (developer_extra.integer)
1837 VM_Warning("VM_fopen: %s: %s mode %s failed\n", PRVM_NAME, filename, modestring);
1841 PRVM_G_FLOAT(OFS_RETURN) = filenum;
1842 if (developer_extra.integer)
1843 Con_DPrintf("VM_fopen: %s: %s mode %s opened as #%i\n", PRVM_NAME, filename, modestring, filenum);
1844 prog->openfiles_origin[filenum] = PRVM_AllocationOrigin();
1852 fclose(float fhandle)
1855 //void(float fhandle) fclose = #111; // closes a file
1856 void VM_fclose(void)
1860 VM_SAFEPARMCOUNT(1,VM_fclose);
1862 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1863 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1865 VM_Warning("VM_fclose: invalid file handle %i used in %s\n", filenum, PRVM_NAME);
1868 if (prog->openfiles[filenum] == NULL)
1870 VM_Warning("VM_fclose: no such file handle %i (or file has been closed) in %s\n", filenum, PRVM_NAME);
1873 FS_Close(prog->openfiles[filenum]);
1874 prog->openfiles[filenum] = NULL;
1875 if(prog->openfiles_origin[filenum])
1876 PRVM_Free((char *)prog->openfiles_origin[filenum]);
1877 if (developer_extra.integer)
1878 Con_DPrintf("VM_fclose: %s: #%i closed\n", PRVM_NAME, filenum);
1885 string fgets(float fhandle)
1888 //string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring
1892 char string[VM_STRINGTEMP_LENGTH];
1895 VM_SAFEPARMCOUNT(1,VM_fgets);
1897 // set the return value regardless of any possible errors
1898 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
1900 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1901 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1903 VM_Warning("VM_fgets: invalid file handle %i used in %s\n", filenum, PRVM_NAME);
1906 if (prog->openfiles[filenum] == NULL)
1908 VM_Warning("VM_fgets: no such file handle %i (or file has been closed) in %s\n", filenum, PRVM_NAME);
1914 c = FS_Getc(prog->openfiles[filenum]);
1915 if (c == '\r' || c == '\n' || c < 0)
1917 if (end < VM_STRINGTEMP_LENGTH - 1)
1921 // remove \n following \r
1924 c = FS_Getc(prog->openfiles[filenum]);
1926 FS_UnGetc(prog->openfiles[filenum], (unsigned char)c);
1928 if (developer_extra.integer)
1929 Con_DPrintf("fgets: %s: %s\n", PRVM_NAME, string);
1931 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
1938 fputs(float fhandle, string s)
1941 //void(float fhandle, string s) fputs = #113; // writes a line of text to the end of the file
1945 char string[VM_STRINGTEMP_LENGTH];
1948 VM_SAFEPARMCOUNT(2,VM_fputs);
1950 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1951 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1953 VM_Warning("VM_fputs: invalid file handle %i used in %s\n", filenum, PRVM_NAME);
1956 if (prog->openfiles[filenum] == NULL)
1958 VM_Warning("VM_fputs: no such file handle %i (or file has been closed) in %s\n", filenum, PRVM_NAME);
1961 VM_VarString(1, string, sizeof(string));
1962 if ((stringlength = (int)strlen(string)))
1963 FS_Write(prog->openfiles[filenum], string, stringlength);
1964 if (developer_extra.integer)
1965 Con_DPrintf("fputs: %s: %s\n", PRVM_NAME, string);
1972 writetofile(float fhandle, entity ent)
1975 void VM_writetofile(void)
1980 VM_SAFEPARMCOUNT(2, VM_writetofile);
1982 file = VM_GetFileHandle( (int)PRVM_G_FLOAT(OFS_PARM0) );
1985 VM_Warning("VM_writetofile: invalid or closed file handle\n");
1989 ent = PRVM_G_EDICT(OFS_PARM1);
1990 if(ent->priv.required->free)
1992 VM_Warning("VM_writetofile: %s: entity %i is free !\n", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
1996 PRVM_ED_Write (file, ent);
1999 // KrimZon - DP_QC_ENTITYDATA
2004 float() numentityfields
2005 Return the number of entity fields - NOT offsets
2008 void VM_numentityfields(void)
2010 PRVM_G_FLOAT(OFS_RETURN) = prog->numfielddefs;
2013 // KrimZon - DP_QC_ENTITYDATA
2018 string(float fieldnum) entityfieldname
2019 Return name of the specified field as a string, or empty if the field is invalid (warning)
2022 void VM_entityfieldname(void)
2025 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2027 if (i < 0 || i >= prog->numfielddefs)
2029 VM_Warning("VM_entityfieldname: %s: field index out of bounds\n", PRVM_NAME);
2030 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
2034 d = &prog->fielddefs[i];
2035 PRVM_G_INT(OFS_RETURN) = d->s_name; // presuming that s_name points to a string already
2038 // KrimZon - DP_QC_ENTITYDATA
2043 float(float fieldnum) entityfieldtype
2046 void VM_entityfieldtype(void)
2049 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2051 if (i < 0 || i >= prog->numfielddefs)
2053 VM_Warning("VM_entityfieldtype: %s: field index out of bounds\n", PRVM_NAME);
2054 PRVM_G_FLOAT(OFS_RETURN) = -1.0;
2058 d = &prog->fielddefs[i];
2059 PRVM_G_FLOAT(OFS_RETURN) = (float)d->type;
2062 // KrimZon - DP_QC_ENTITYDATA
2065 VM_getentityfieldstring
2067 string(float fieldnum, entity ent) getentityfieldstring
2070 void VM_getentityfieldstring(void)
2072 // put the data into a string
2077 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2079 if (i < 0 || i >= prog->numfielddefs)
2081 VM_Warning("VM_entityfielddata: %s: field index out of bounds\n", PRVM_NAME);
2082 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
2086 d = &prog->fielddefs[i];
2089 ent = PRVM_G_EDICT(OFS_PARM1);
2090 if(ent->priv.required->free)
2092 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
2093 VM_Warning("VM_entityfielddata: %s: entity %i is free !\n", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
2096 v = (int *)((char *)ent->fields.vp + d->ofs*4);
2098 // if it's 0 or blank, return an empty string
2099 type = d->type & ~DEF_SAVEGLOBAL;
2100 for (j=0 ; j<prvm_type_size[type] ; j++)
2103 if (j == prvm_type_size[type])
2105 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
2109 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(PRVM_UglyValueString((etype_t)d->type, (prvm_eval_t *)v));
2112 // KrimZon - DP_QC_ENTITYDATA
2115 VM_putentityfieldstring
2117 float(float fieldnum, entity ent, string s) putentityfieldstring
2120 void VM_putentityfieldstring(void)
2124 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2126 if (i < 0 || i >= prog->numfielddefs)
2128 VM_Warning("VM_entityfielddata: %s: field index out of bounds\n", PRVM_NAME);
2129 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2133 d = &prog->fielddefs[i];
2136 ent = PRVM_G_EDICT(OFS_PARM1);
2137 if(ent->priv.required->free)
2139 VM_Warning("VM_entityfielddata: %s: entity %i is free !\n", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
2140 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2144 // parse the string into the value
2145 PRVM_G_FLOAT(OFS_RETURN) = ( PRVM_ED_ParseEpair(ent, d, PRVM_G_STRING(OFS_PARM2), false) ) ? 1.0f : 0.0f;
2152 float strlen(string s)
2155 //float(string s) strlen = #114; // returns how many characters are in a string
2156 void VM_strlen(void)
2158 VM_SAFEPARMCOUNT(1,VM_strlen);
2160 //PRVM_G_FLOAT(OFS_RETURN) = strlen(PRVM_G_STRING(OFS_PARM0));
2161 PRVM_G_FLOAT(OFS_RETURN) = u8_strlen(PRVM_G_STRING(OFS_PARM0));
2164 // DRESK - Decolorized String
2169 string strdecolorize(string s)
2172 // string (string s) strdecolorize = #472; // returns the passed in string with color codes stripped
2173 void VM_strdecolorize(void)
2175 char szNewString[VM_STRINGTEMP_LENGTH];
2176 const char *szString;
2179 VM_SAFEPARMCOUNT(1,VM_strdecolorize);
2180 szString = PRVM_G_STRING(OFS_PARM0);
2181 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), TRUE);
2182 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(szNewString);
2185 // DRESK - String Length (not counting color codes)
2190 float strlennocol(string s)
2193 // float(string s) strlennocol = #471; // returns how many characters are in a string not including color codes
2194 // For example, ^2Dresk returns a length of 5
2195 void VM_strlennocol(void)
2197 const char *szString;
2200 VM_SAFEPARMCOUNT(1,VM_strlennocol);
2202 szString = PRVM_G_STRING(OFS_PARM0);
2204 //nCnt = COM_StringLengthNoColors(szString, 0, NULL);
2205 nCnt = u8_COM_StringLengthNoColors(szString, 0, NULL);
2207 PRVM_G_FLOAT(OFS_RETURN) = nCnt;
2210 // DRESK - String to Uppercase and Lowercase
2215 string strtolower(string s)
2218 // string (string s) strtolower = #480; // returns passed in string in lowercase form
2219 void VM_strtolower(void)
2221 char szNewString[VM_STRINGTEMP_LENGTH];
2222 const char *szString;
2225 VM_SAFEPARMCOUNT(1,VM_strtolower);
2226 szString = PRVM_G_STRING(OFS_PARM0);
2228 COM_ToLowerString(szString, szNewString, sizeof(szNewString) );
2230 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(szNewString);
2237 string strtoupper(string s)
2240 // string (string s) strtoupper = #481; // returns passed in string in uppercase form
2241 void VM_strtoupper(void)
2243 char szNewString[VM_STRINGTEMP_LENGTH];
2244 const char *szString;
2247 VM_SAFEPARMCOUNT(1,VM_strtoupper);
2248 szString = PRVM_G_STRING(OFS_PARM0);
2250 COM_ToUpperString(szString, szNewString, sizeof(szNewString) );
2252 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(szNewString);
2259 string strcat(string,string,...[string])
2262 //string(string s1, string s2) strcat = #115;
2263 // concatenates two strings (for example "abc", "def" would return "abcdef")
2264 // and returns as a tempstring
2265 void VM_strcat(void)
2267 char s[VM_STRINGTEMP_LENGTH];
2268 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strcat);
2270 VM_VarString(0, s, sizeof(s));
2271 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
2278 string substring(string s, float start, float length)
2281 // string(string s, float start, float length) substring = #116;
2282 // returns a section of a string as a tempstring
2283 void VM_substring(void)
2286 int u_slength = 0, u_start;
2289 char string[VM_STRINGTEMP_LENGTH];
2291 VM_SAFEPARMCOUNT(3,VM_substring);
2294 s = PRVM_G_STRING(OFS_PARM0);
2295 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2296 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2297 slength = strlen(s);
2299 if (start < 0) // FTE_STRINGS feature
2301 start = bound(0, start, slength);
2303 if (length < 0) // FTE_STRINGS feature
2304 length += slength - start + 1;
2305 maxlen = min((int)sizeof(string) - 1, slength - start);
2306 length = bound(0, length, maxlen);
2308 memcpy(string, s + start, length);
2310 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
2313 s = PRVM_G_STRING(OFS_PARM0);
2314 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2315 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2317 if (start < 0) // FTE_STRINGS feature
2319 u_slength = u8_strlen(s);
2321 start = bound(0, start, u_slength);
2324 if (length < 0) // FTE_STRINGS feature
2326 if (!u_slength) // it's not calculated when it's not needed above
2327 u_slength = u8_strlen(s);
2328 length += u_slength - start + 1;
2331 // positive start, positive length
2332 u_start = u8_byteofs(s, start, NULL);
2335 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
2338 u_length = u8_bytelen(s + u_start, length);
2339 if (u_length >= sizeof(string)-1)
2340 u_length = sizeof(string)-1;
2342 memcpy(string, s + u_start, u_length);
2343 string[u_length] = 0;
2344 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
2351 string(string search, string replace, string subject) strreplace = #484;
2354 // replaces all occurrences of search with replace in the string subject, and returns the result
2355 void VM_strreplace(void)
2358 const char *search, *replace, *subject;
2359 char string[VM_STRINGTEMP_LENGTH];
2360 int search_len, replace_len, subject_len;
2362 VM_SAFEPARMCOUNT(3,VM_strreplace);
2364 search = PRVM_G_STRING(OFS_PARM0);
2365 replace = PRVM_G_STRING(OFS_PARM1);
2366 subject = PRVM_G_STRING(OFS_PARM2);
2368 search_len = (int)strlen(search);
2369 replace_len = (int)strlen(replace);
2370 subject_len = (int)strlen(subject);
2373 for (i = 0; i <= subject_len - search_len; i++)
2375 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2376 if (subject[i+j] != search[j])
2378 if (j == search_len)
2380 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2381 // found it at offset 'i'
2382 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2383 string[si++] = replace[j];
2386 i += search_len - 1;
2390 // the above would subtract 1 from i... so we
2391 // don't do that, but instead output the next
2393 if (si < (int)sizeof(string) - 1)
2394 string[si++] = subject[i];
2399 // in THIS case, we know search_len > 0, thus i < subject_len
2401 if (si < (int)sizeof(string) - 1)
2402 string[si++] = subject[i];
2405 // remaining chars (these cannot match)
2406 for (; i < subject_len; i++)
2407 if (si < (int)sizeof(string) - 1)
2408 string[si++] = subject[i];
2411 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
2418 string(string search, string replace, string subject) strireplace = #485;
2421 // case-insensitive version of strreplace
2422 void VM_strireplace(void)
2425 const char *search, *replace, *subject;
2426 char string[VM_STRINGTEMP_LENGTH];
2427 int search_len, replace_len, subject_len;
2429 VM_SAFEPARMCOUNT(3,VM_strreplace);
2431 search = PRVM_G_STRING(OFS_PARM0);
2432 replace = PRVM_G_STRING(OFS_PARM1);
2433 subject = PRVM_G_STRING(OFS_PARM2);
2435 search_len = (int)strlen(search);
2436 replace_len = (int)strlen(replace);
2437 subject_len = (int)strlen(subject);
2440 for (i = 0; i <= subject_len - search_len; i++)
2442 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2443 if (tolower(subject[i+j]) != tolower(search[j]))
2445 if (j == search_len)
2447 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2448 // found it at offset 'i'
2449 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2450 string[si++] = replace[j];
2453 i += search_len - 1;
2457 // the above would subtract 1 from i... so we
2458 // don't do that, but instead output the next
2460 if (si < (int)sizeof(string) - 1)
2461 string[si++] = subject[i];
2466 // in THIS case, we know search_len > 0, thus i < subject_len
2468 if (si < (int)sizeof(string) - 1)
2469 string[si++] = subject[i];
2472 // remaining chars (these cannot match)
2473 for (; i < subject_len; i++)
2474 if (si < (int)sizeof(string) - 1)
2475 string[si++] = subject[i];
2478 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
2485 vector stov(string s)
2488 //vector(string s) stov = #117; // returns vector value from a string
2491 char string[VM_STRINGTEMP_LENGTH];
2493 VM_SAFEPARMCOUNT(1,VM_stov);
2495 VM_VarString(0, string, sizeof(string));
2496 Math_atov(string, PRVM_G_VECTOR(OFS_RETURN));
2503 string strzone(string s)
2506 //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)
2507 void VM_strzone(void)
2510 char string[VM_STRINGTEMP_LENGTH];
2513 VM_SAFEPARMCOUNT(1,VM_strzone);
2515 VM_VarString(0, string, sizeof(string));
2516 alloclen = strlen(string) + 1;
2517 PRVM_G_INT(OFS_RETURN) = PRVM_AllocString(alloclen, &out);
2518 memcpy(out, string, alloclen);
2528 //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!!!)
2529 void VM_strunzone(void)
2531 VM_SAFEPARMCOUNT(1,VM_strunzone);
2532 PRVM_FreeString(PRVM_G_INT(OFS_PARM0));
2537 VM_command (used by client and menu)
2539 clientcommand(float client, string s) (for client and menu)
2542 //void(entity e, string s) clientcommand = #440; // executes a command string as if it came from the specified client
2543 //this function originally written by KrimZon, made shorter by LordHavoc
2544 void VM_clcommand (void)
2546 client_t *temp_client;
2549 VM_SAFEPARMCOUNT(2,VM_clcommand);
2551 i = (int)PRVM_G_FLOAT(OFS_PARM0);
2552 if (!sv.active || i < 0 || i >= svs.maxclients || !svs.clients[i].active)
2554 VM_Warning("VM_clientcommand: %s: invalid client/server is not active !\n", PRVM_NAME);
2558 temp_client = host_client;
2559 host_client = svs.clients + i;
2560 Cmd_ExecuteString (PRVM_G_STRING(OFS_PARM1), src_client);
2561 host_client = temp_client;
2569 float tokenize(string s)
2572 //float(string s) tokenize = #441; // takes apart a string into individal words (access them with argv), returns how many
2573 //this function originally written by KrimZon, made shorter by LordHavoc
2574 //20040203: rewritten by LordHavoc (no longer uses allocations)
2575 static int num_tokens = 0;
2576 static int tokens[VM_STRINGTEMP_LENGTH / 2];
2577 static int tokens_startpos[VM_STRINGTEMP_LENGTH / 2];
2578 static int tokens_endpos[VM_STRINGTEMP_LENGTH / 2];
2579 static char tokenize_string[VM_STRINGTEMP_LENGTH];
2580 void VM_tokenize (void)
2584 VM_SAFEPARMCOUNT(1,VM_tokenize);
2586 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2587 p = tokenize_string;
2592 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2595 // skip whitespace here to find token start pos
2596 while(*p && ISWHITESPACE(*p))
2599 tokens_startpos[num_tokens] = p - tokenize_string;
2600 if(!COM_ParseToken_VM_Tokenize(&p, false))
2602 tokens_endpos[num_tokens] = p - tokenize_string;
2603 tokens[num_tokens] = PRVM_SetTempString(com_token);
2607 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2610 //float(string s) tokenize = #514; // takes apart a string into individal words (access them with argv), returns how many
2611 void VM_tokenize_console (void)
2615 VM_SAFEPARMCOUNT(1,VM_tokenize);
2617 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2618 p = tokenize_string;
2623 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2626 // skip whitespace here to find token start pos
2627 while(*p && ISWHITESPACE(*p))
2630 tokens_startpos[num_tokens] = p - tokenize_string;
2631 if(!COM_ParseToken_Console(&p))
2633 tokens_endpos[num_tokens] = p - tokenize_string;
2634 tokens[num_tokens] = PRVM_SetTempString(com_token);
2638 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2643 VM_tokenizebyseparator
2645 float tokenizebyseparator(string s, string separator1, ...)
2648 //float(string s, string separator1, ...) tokenizebyseparator = #479; // takes apart a string into individal words (access them with argv), returns how many
2649 //this function returns the token preceding each instance of a separator (of
2650 //which there can be multiple), and the text following the last separator
2651 //useful for parsing certain kinds of data like IP addresses
2653 //numnumbers = tokenizebyseparator("10.1.2.3", ".");
2654 //returns 4 and the tokens "10" "1" "2" "3".
2655 void VM_tokenizebyseparator (void)
2659 int separatorlen[7];
2660 const char *separators[7];
2663 char tokentext[MAX_INPUTLINE];
2665 VM_SAFEPARMCOUNTRANGE(2, 8,VM_tokenizebyseparator);
2667 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2668 p = tokenize_string;
2671 for (j = 1;j < prog->argc;j++)
2673 // skip any blank separator strings
2674 const char *s = PRVM_G_STRING(OFS_PARM0+j*3);
2677 separators[numseparators] = s;
2678 separatorlen[numseparators] = strlen(s);
2685 while (num_tokens < (int)(sizeof(tokens)/sizeof(tokens[0])))
2687 token = tokentext + j;
2688 tokens_startpos[num_tokens] = p - tokenize_string;
2692 for (k = 0;k < numseparators;k++)
2694 if (!strncmp(p, separators[k], separatorlen[k]))
2696 p += separatorlen[k];
2700 if (k < numseparators)
2702 if (j < (int)sizeof(tokentext)-1)
2703 tokentext[j++] = *p;
2707 tokens_endpos[num_tokens] = p0 - tokenize_string;
2708 if (j >= (int)sizeof(tokentext))
2711 tokens[num_tokens++] = PRVM_SetTempString(token);
2716 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2719 //string(float n) argv = #442; // returns a word from the tokenized string (returns nothing for an invalid index)
2720 //this function originally written by KrimZon, made shorter by LordHavoc
2725 VM_SAFEPARMCOUNT(1,VM_argv);
2727 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2730 token_num += num_tokens;
2732 if (token_num >= 0 && token_num < num_tokens)
2733 PRVM_G_INT(OFS_RETURN) = tokens[token_num];
2735 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2738 //float(float n) argv_start_index = #515; // returns the start index of a token
2739 void VM_argv_start_index (void)
2743 VM_SAFEPARMCOUNT(1,VM_argv);
2745 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2748 token_num += num_tokens;
2750 if (token_num >= 0 && token_num < num_tokens)
2751 PRVM_G_FLOAT(OFS_RETURN) = tokens_startpos[token_num];
2753 PRVM_G_FLOAT(OFS_RETURN) = -1;
2756 //float(float n) argv_end_index = #516; // returns the end index of a token
2757 void VM_argv_end_index (void)
2761 VM_SAFEPARMCOUNT(1,VM_argv);
2763 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2766 token_num += num_tokens;
2768 if (token_num >= 0 && token_num < num_tokens)
2769 PRVM_G_FLOAT(OFS_RETURN) = tokens_endpos[token_num];
2771 PRVM_G_FLOAT(OFS_RETURN) = -1;
2781 void VM_isserver(void)
2783 VM_SAFEPARMCOUNT(0,VM_serverstate);
2785 PRVM_G_FLOAT(OFS_RETURN) = sv.active && (svs.maxclients > 1 || cls.state == ca_dedicated);
2795 void VM_clientcount(void)
2797 VM_SAFEPARMCOUNT(0,VM_clientcount);
2799 PRVM_G_FLOAT(OFS_RETURN) = svs.maxclients;
2809 void VM_clientstate(void)
2811 VM_SAFEPARMCOUNT(0,VM_clientstate);
2814 switch( cls.state ) {
2815 case ca_uninitialized:
2817 PRVM_G_FLOAT(OFS_RETURN) = 0;
2819 case ca_disconnected:
2820 PRVM_G_FLOAT(OFS_RETURN) = 1;
2823 PRVM_G_FLOAT(OFS_RETURN) = 2;
2826 // should never be reached!
2835 float getostype(void)
2837 */ // not used at the moment -> not included in the common list
2838 void VM_getostype(void)
2840 VM_SAFEPARMCOUNT(0,VM_getostype);
2845 OS_MAC - not supported
2849 PRVM_G_FLOAT(OFS_RETURN) = 0;
2850 #elif defined(MACOSX)
2851 PRVM_G_FLOAT(OFS_RETURN) = 2;
2853 PRVM_G_FLOAT(OFS_RETURN) = 1;
2864 extern double host_starttime;
2865 float CDAudio_GetPosition(void);
2866 void VM_gettime(void)
2870 VM_SAFEPARMCOUNTRANGE(0,1,VM_gettime);
2874 PRVM_G_FLOAT(OFS_RETURN) = (float) realtime;
2878 timer_index = (int) PRVM_G_FLOAT(OFS_PARM0);
2881 case 0: // GETTIME_FRAMESTART
2882 PRVM_G_FLOAT(OFS_RETURN) = (float) realtime;
2884 case 1: // GETTIME_REALTIME
2885 PRVM_G_FLOAT(OFS_RETURN) = (float) Sys_DoubleTime();
2887 case 2: // GETTIME_HIRES
2888 PRVM_G_FLOAT(OFS_RETURN) = (float) (Sys_DoubleTime() - realtime);
2890 case 3: // GETTIME_UPTIME
2891 PRVM_G_FLOAT(OFS_RETURN) = (float) (Sys_DoubleTime() - host_starttime);
2893 case 4: // GETTIME_CDTRACK
2894 PRVM_G_FLOAT(OFS_RETURN) = (float) CDAudio_GetPosition();
2897 VM_Warning("VM_gettime: %s: unsupported timer specified, returning realtime\n", PRVM_NAME);
2898 PRVM_G_FLOAT(OFS_RETURN) = (float) realtime;
2908 float getsoundtime(void)
2912 void VM_getsoundtime (void)
2914 int entnum, entchannel, pnum;
2915 VM_SAFEPARMCOUNT(2,VM_getsoundtime);
2917 pnum = PRVM_GetProgNr();
2918 if (pnum == PRVM_MENUPROG)
2920 VM_Warning("VM_getsoundtime: %s: not supported on this progs\n", PRVM_NAME);
2921 PRVM_G_FLOAT(OFS_RETURN) = -1;
2924 entnum = ((pnum == PRVM_CLIENTPROG) ? MAX_EDICTS : 0) + PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2925 entchannel = (int)PRVM_G_FLOAT(OFS_PARM1);
2926 if (entchannel <= 0 || entchannel > 8)
2927 VM_Warning("VM_getsoundtime: %s: bad channel %i\n", PRVM_NAME, entchannel);
2928 PRVM_G_FLOAT(OFS_RETURN) = (float)S_GetEntChannelPosition(entnum, entchannel);
2935 string soundlength (string sample)
2938 void VM_soundlength (void)
2942 VM_SAFEPARMCOUNT(1, VM_soundlength);
2944 s = PRVM_G_STRING(OFS_PARM0);
2945 PRVM_G_FLOAT(OFS_RETURN) = S_SoundLength(s);
2952 loadfromdata(string data)
2955 void VM_loadfromdata(void)
2957 VM_SAFEPARMCOUNT(1,VM_loadentsfromfile);
2959 PRVM_ED_LoadFromFile(PRVM_G_STRING(OFS_PARM0));
2963 ========================
2966 parseentitydata(entity ent, string data)
2967 ========================
2969 void VM_parseentitydata(void)
2974 VM_SAFEPARMCOUNT(2, VM_parseentitydata);
2976 // get edict and test it
2977 ent = PRVM_G_EDICT(OFS_PARM0);
2978 if (ent->priv.required->free)
2979 PRVM_ERROR ("VM_parseentitydata: %s: Can only set already spawned entities (entity %i is free)!", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
2981 data = PRVM_G_STRING(OFS_PARM1);
2983 // parse the opening brace
2984 if (!COM_ParseToken_Simple(&data, false, false) || com_token[0] != '{' )
2985 PRVM_ERROR ("VM_parseentitydata: %s: Couldn't parse entity data:\n%s", PRVM_NAME, data );
2987 PRVM_ED_ParseEdict (data, ent);
2994 loadfromfile(string file)
2997 void VM_loadfromfile(void)
2999 const char *filename;
3002 VM_SAFEPARMCOUNT(1,VM_loadfromfile);
3004 filename = PRVM_G_STRING(OFS_PARM0);
3005 if (FS_CheckNastyPath(filename, false))
3007 PRVM_G_FLOAT(OFS_RETURN) = -4;
3008 VM_Warning("VM_loadfromfile: %s dangerous or non-portable filename \"%s\" not allowed. (contains : or \\ or begins with .. or /)\n", PRVM_NAME, filename);
3012 // not conform with VM_fopen
3013 data = (char *)FS_LoadFile(filename, tempmempool, false, NULL);
3015 PRVM_G_FLOAT(OFS_RETURN) = -1;
3017 PRVM_ED_LoadFromFile(data);
3028 float mod(float val, float m)
3031 void VM_modulo(void)
3034 VM_SAFEPARMCOUNT(2,VM_module);
3036 val = (int) PRVM_G_FLOAT(OFS_PARM0);
3037 m = (int) PRVM_G_FLOAT(OFS_PARM1);
3039 PRVM_G_FLOAT(OFS_RETURN) = (float) (val % m);
3042 void VM_Search_Init(void)
3045 for (i = 0;i < PRVM_MAX_OPENSEARCHES;i++)
3046 prog->opensearches[i] = NULL;
3049 void VM_Search_Reset(void)
3052 // reset the fssearch list
3053 for(i = 0; i < PRVM_MAX_OPENSEARCHES; i++)
3055 if(prog->opensearches[i])
3056 FS_FreeSearch(prog->opensearches[i]);
3057 prog->opensearches[i] = NULL;
3065 float search_begin(string pattern, float caseinsensitive, float quiet)
3068 void VM_search_begin(void)
3071 const char *pattern;
3072 int caseinsens, quiet;
3074 VM_SAFEPARMCOUNT(3, VM_search_begin);
3076 pattern = PRVM_G_STRING(OFS_PARM0);
3078 VM_CheckEmptyString(pattern);
3080 caseinsens = (int)PRVM_G_FLOAT(OFS_PARM1);
3081 quiet = (int)PRVM_G_FLOAT(OFS_PARM2);
3083 for(handle = 0; handle < PRVM_MAX_OPENSEARCHES; handle++)
3084 if(!prog->opensearches[handle])
3087 if(handle >= PRVM_MAX_OPENSEARCHES)
3089 PRVM_G_FLOAT(OFS_RETURN) = -2;
3090 VM_Warning("VM_search_begin: %s ran out of search handles (%i)\n", PRVM_NAME, PRVM_MAX_OPENSEARCHES);
3094 if(!(prog->opensearches[handle] = FS_Search(pattern,caseinsens, quiet)))
3095 PRVM_G_FLOAT(OFS_RETURN) = -1;
3098 prog->opensearches_origin[handle] = PRVM_AllocationOrigin();
3099 PRVM_G_FLOAT(OFS_RETURN) = handle;
3107 void search_end(float handle)
3110 void VM_search_end(void)
3113 VM_SAFEPARMCOUNT(1, VM_search_end);
3115 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3117 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3119 VM_Warning("VM_search_end: invalid handle %i used in %s\n", handle, PRVM_NAME);
3122 if(prog->opensearches[handle] == NULL)
3124 VM_Warning("VM_search_end: no such handle %i in %s\n", handle, PRVM_NAME);
3128 FS_FreeSearch(prog->opensearches[handle]);
3129 prog->opensearches[handle] = NULL;
3130 if(prog->opensearches_origin[handle])
3131 PRVM_Free((char *)prog->opensearches_origin[handle]);
3138 float search_getsize(float handle)
3141 void VM_search_getsize(void)
3144 VM_SAFEPARMCOUNT(1, VM_M_search_getsize);
3146 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3148 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3150 VM_Warning("VM_search_getsize: invalid handle %i used in %s\n", handle, PRVM_NAME);
3153 if(prog->opensearches[handle] == NULL)
3155 VM_Warning("VM_search_getsize: no such handle %i in %s\n", handle, PRVM_NAME);
3159 PRVM_G_FLOAT(OFS_RETURN) = prog->opensearches[handle]->numfilenames;
3164 VM_search_getfilename
3166 string search_getfilename(float handle, float num)
3169 void VM_search_getfilename(void)
3171 int handle, filenum;
3172 VM_SAFEPARMCOUNT(2, VM_search_getfilename);
3174 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3175 filenum = (int)PRVM_G_FLOAT(OFS_PARM1);
3177 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3179 VM_Warning("VM_search_getfilename: invalid handle %i used in %s\n", handle, PRVM_NAME);
3182 if(prog->opensearches[handle] == NULL)
3184 VM_Warning("VM_search_getfilename: no such handle %i in %s\n", handle, PRVM_NAME);
3187 if(filenum < 0 || filenum >= prog->opensearches[handle]->numfilenames)
3189 VM_Warning("VM_search_getfilename: invalid filenum %i in %s\n", filenum, PRVM_NAME);
3193 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog->opensearches[handle]->filenames[filenum]);
3200 string chr(float ascii)
3207 VM_SAFEPARMCOUNT(1, VM_chr);
3209 tmp[0] = (unsigned char) PRVM_G_FLOAT(OFS_PARM0);
3212 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(tmp);
3217 VM_SAFEPARMCOUNT(1, VM_chr);
3219 len = u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0), tmp, sizeof(tmp));
3221 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(tmp);
3224 //=============================================================================
3225 // Draw builtins (client & menu)
3231 float iscachedpic(string pic)
3234 void VM_iscachedpic(void)
3236 VM_SAFEPARMCOUNT(1,VM_iscachedpic);
3238 // drawq hasnt such a function, thus always return true
3239 PRVM_G_FLOAT(OFS_RETURN) = false;
3246 string precache_pic(string pic)
3249 void VM_precache_pic(void)
3253 VM_SAFEPARMCOUNT(1, VM_precache_pic);
3255 s = PRVM_G_STRING(OFS_PARM0);
3256 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
3257 VM_CheckEmptyString (s);
3259 // AK Draw_CachePic is supposed to always return a valid pointer
3260 if( Draw_CachePic_Flags(s, 0)->tex == r_texture_notexture )
3261 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
3271 void VM_freepic(void)
3275 VM_SAFEPARMCOUNT(1,VM_freepic);
3277 s = PRVM_G_STRING(OFS_PARM0);
3278 VM_CheckEmptyString (s);
3283 void getdrawfontscale(float *sx, float *sy)
3287 VectorCopy(PRVM_drawglobalvector(drawfontscale), v);
3288 if(VectorLength2(v) > 0)
3295 dp_font_t *getdrawfont(void)
3297 int f = (int) PRVM_drawglobalfloat(drawfont);
3298 if(f < 0 || f >= dp_fonts.maxsize)
3299 return FONT_DEFAULT;
3300 return &dp_fonts.f[f];
3307 float drawcharacter(vector position, float character, vector scale, vector rgb, float alpha, float flag)
3310 void VM_drawcharacter(void)
3312 float *pos,*scale,*rgb;
3316 VM_SAFEPARMCOUNT(6,VM_drawcharacter);
3318 character = (char) PRVM_G_FLOAT(OFS_PARM1);
3321 PRVM_G_FLOAT(OFS_RETURN) = -1;
3322 VM_Warning("VM_drawcharacter: %s passed null character !\n",PRVM_NAME);
3326 pos = PRVM_G_VECTOR(OFS_PARM0);
3327 scale = PRVM_G_VECTOR(OFS_PARM2);
3328 rgb = PRVM_G_VECTOR(OFS_PARM3);
3329 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3331 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3333 PRVM_G_FLOAT(OFS_RETURN) = -2;
3334 VM_Warning("VM_drawcharacter: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3338 if(pos[2] || scale[2])
3339 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")));
3341 if(!scale[0] || !scale[1])
3343 PRVM_G_FLOAT(OFS_RETURN) = -3;
3344 VM_Warning("VM_drawcharacter: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3348 getdrawfontscale(&sx, &sy);
3349 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());
3350 PRVM_G_FLOAT(OFS_RETURN) = 1;
3357 float drawstring(vector position, string text, vector scale, vector rgb, float alpha, float flag)
3360 void VM_drawstring(void)
3362 float *pos,*scale,*rgb;
3366 VM_SAFEPARMCOUNT(6,VM_drawstring);
3368 string = PRVM_G_STRING(OFS_PARM1);
3369 pos = PRVM_G_VECTOR(OFS_PARM0);
3370 scale = PRVM_G_VECTOR(OFS_PARM2);
3371 rgb = PRVM_G_VECTOR(OFS_PARM3);
3372 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3374 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3376 PRVM_G_FLOAT(OFS_RETURN) = -2;
3377 VM_Warning("VM_drawstring: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3381 if(!scale[0] || !scale[1])
3383 PRVM_G_FLOAT(OFS_RETURN) = -3;
3384 VM_Warning("VM_drawstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3388 if(pos[2] || scale[2])
3389 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")));
3391 getdrawfontscale(&sx, &sy);
3392 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());
3393 //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);
3394 PRVM_G_FLOAT(OFS_RETURN) = 1;
3399 VM_drawcolorcodedstring
3401 float drawcolorcodedstring(vector position, string text, vector scale, float alpha, float flag)
3403 float drawcolorcodedstring(vector position, string text, vector scale, vector rgb, float alpha, float flag)
3406 void VM_drawcolorcodedstring(void)
3412 float sx, sy, alpha;
3414 VM_SAFEPARMCOUNTRANGE(5,6,VM_drawcolorcodedstring);
3416 if (prog->argc == 6) // full 6 parms, like normal drawstring
3418 pos = PRVM_G_VECTOR(OFS_PARM0);
3419 string = PRVM_G_STRING(OFS_PARM1);
3420 scale = PRVM_G_VECTOR(OFS_PARM2);
3421 VectorCopy(PRVM_G_VECTOR(OFS_PARM3), rgb);
3422 alpha = PRVM_G_FLOAT(OFS_PARM4);
3423 flag = (int)PRVM_G_FLOAT(OFS_PARM5);
3427 pos = PRVM_G_VECTOR(OFS_PARM0);
3428 string = PRVM_G_STRING(OFS_PARM1);
3429 scale = PRVM_G_VECTOR(OFS_PARM2);
3433 alpha = PRVM_G_FLOAT(OFS_PARM3);
3434 flag = (int)PRVM_G_FLOAT(OFS_PARM4);
3437 if(flag < DRAWFLAG_NORMAL || flag >= DRAWFLAG_NUMFLAGS)
3439 PRVM_G_FLOAT(OFS_RETURN) = -2;
3440 VM_Warning("VM_drawcolorcodedstring: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3444 if(!scale[0] || !scale[1])
3446 PRVM_G_FLOAT(OFS_RETURN) = -3;
3447 VM_Warning("VM_drawcolorcodedstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
3451 if(pos[2] || scale[2])
3452 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")));
3454 getdrawfontscale(&sx, &sy);
3455 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());
3456 if (prog->argc == 6) // also return vector of last color
3457 VectorCopy(DrawQ_Color, PRVM_G_VECTOR(OFS_RETURN));
3459 PRVM_G_FLOAT(OFS_RETURN) = 1;
3465 float stringwidth(string text, float allowColorCodes, float size)
3468 void VM_stringwidth(void)
3472 float mult; // sz is intended font size so we can later add freetype support, mult is font size multiplier in pixels per character cell
3476 VM_SAFEPARMCOUNTRANGE(2,3,VM_drawstring);
3478 getdrawfontscale(&sx, &sy);
3481 szv = PRVM_G_VECTOR(OFS_PARM2);
3486 // we want the width for 8x8 font size, divided by 8
3487 static float defsize[] = {8, 8};
3490 // to make sure snapping is turned off, ALWAYS use a nontrivial scale in this case
3491 if(sx >= 0.9 && sx <= 1.1)
3499 string = PRVM_G_STRING(OFS_PARM0);
3500 colors = (int)PRVM_G_FLOAT(OFS_PARM1);
3502 PRVM_G_FLOAT(OFS_RETURN) = DrawQ_TextWidth_UntilWidth_TrackColors_Scale(string, &maxlen, szv[0], szv[1], sx, sy, NULL, !colors, getdrawfont(), 1000000000) * mult;
3506 mult = sz = PRVM_G_FLOAT(OFS_PARM2);
3514 string = PRVM_G_STRING(OFS_PARM0);
3515 colors = (int)PRVM_G_FLOAT(OFS_PARM1);
3517 PRVM_G_FLOAT(OFS_RETURN) = DrawQ_TextWidth(string, 0, !colors, getdrawfont()) * mult; // 1x1 characters, don't actually draw
3525 float findfont(string s)
3529 float getdrawfontnum(const char *fontname)
3533 for(i = 0; i < dp_fonts.maxsize; ++i)
3534 if(!strcmp(dp_fonts.f[i].title, fontname))
3539 void VM_findfont(void)
3541 VM_SAFEPARMCOUNT(1,VM_findfont);
3542 PRVM_G_FLOAT(OFS_RETURN) = getdrawfontnum(PRVM_G_STRING(OFS_PARM0));
3549 float loadfont(string fontname, string fontmaps, string sizes, float slot)
3553 dp_font_t *FindFont(const char *title, qboolean allocate_new);
3554 void LoadFont(qboolean override, const char *name, dp_font_t *fnt, float scale, float voffset);
3555 void VM_loadfont(void)
3557 const char *fontname, *filelist, *sizes, *c, *cm;
3558 char mainfont[MAX_QPATH];
3560 float sz, scale, voffset;
3563 VM_SAFEPARMCOUNTRANGE(3,6,VM_loadfont);
3565 fontname = PRVM_G_STRING(OFS_PARM0);
3567 fontname = "default";
3569 filelist = PRVM_G_STRING(OFS_PARM1);
3571 filelist = "gfx/conchars";
3573 sizes = PRVM_G_STRING(OFS_PARM2);
3579 if (prog->argc >= 4)
3581 i = PRVM_G_FLOAT(OFS_PARM3);
3582 if (i >= 0 && i < dp_fonts.maxsize)
3585 strlcpy(f->title, fontname, sizeof(f->title)); // replace name
3589 f = FindFont(fontname, true);
3592 PRVM_G_FLOAT(OFS_RETURN) = -1;
3593 return; // something go wrong
3596 memset(f->fallbacks, 0, sizeof(f->fallbacks));
3597 memset(f->fallback_faces, 0, sizeof(f->fallback_faces));
3599 // first font is handled "normally"
3600 c = strchr(filelist, ':');
3601 cm = strchr(filelist, ',');
3602 if(c && (!cm || c < cm))
3603 f->req_face = atoi(c+1);
3609 if(!c || (c - filelist) > MAX_QPATH)
3610 strlcpy(mainfont, filelist, sizeof(mainfont));
3613 memcpy(mainfont, filelist, c - filelist);
3614 mainfont[c - filelist] = 0;
3618 for(i = 0; i < MAX_FONT_FALLBACKS; ++i)
3620 c = strchr(filelist, ',');
3626 c = strchr(filelist, ':');
3627 cm = strchr(filelist, ',');
3628 if(c && (!cm || c < cm))
3629 f->fallback_faces[i] = atoi(c+1);
3632 f->fallback_faces[i] = 0; // f->req_face; could make it stick to the default-font's face index
3635 if(!c || (c-filelist) > MAX_QPATH)
3637 strlcpy(f->fallbacks[i], filelist, sizeof(mainfont));
3641 memcpy(f->fallbacks[i], filelist, c - filelist);
3642 f->fallbacks[i][c - filelist] = 0;
3647 for(i = 0; i < MAX_FONT_SIZES; ++i)
3648 f->req_sizes[i] = -1;
3649 for (numsizes = 0,c = sizes;;)
3651 if (!COM_ParseToken_VM_Tokenize(&c, 0))
3653 sz = atof(com_token);
3655 if (sz < 0.001f || sz > 1000.0f)
3657 VM_Warning("VM_loadfont: crap size %s", com_token);
3661 if (numsizes == MAX_FONT_SIZES)
3663 VM_Warning("VM_loadfont: MAX_FONT_SIZES = %i exceeded", MAX_FONT_SIZES);
3666 f->req_sizes[numsizes] = sz;
3670 // additional scale/hoffset parms
3673 if (prog->argc >= 5)
3675 scale = PRVM_G_FLOAT(OFS_PARM4);
3679 if (prog->argc >= 6)
3680 voffset = PRVM_G_FLOAT(OFS_PARM5);
3683 LoadFont(true, mainfont, f, scale, voffset);
3685 // return index of loaded font
3686 PRVM_G_FLOAT(OFS_RETURN) = (f - dp_fonts.f);
3693 float drawpic(vector position, string pic, vector size, vector rgb, float alpha, float flag)
3696 void VM_drawpic(void)
3698 const char *picname;
3699 float *size, *pos, *rgb;
3702 VM_SAFEPARMCOUNT(6,VM_drawpic);
3704 picname = PRVM_G_STRING(OFS_PARM1);
3705 VM_CheckEmptyString (picname);
3707 // is pic cached ? no function yet for that
3710 PRVM_G_FLOAT(OFS_RETURN) = -4;
3711 VM_Warning("VM_drawpic: %s: %s not cached !\n", PRVM_NAME, picname);
3715 pos = PRVM_G_VECTOR(OFS_PARM0);
3716 size = PRVM_G_VECTOR(OFS_PARM2);
3717 rgb = PRVM_G_VECTOR(OFS_PARM3);
3718 flag = (int) PRVM_G_FLOAT(OFS_PARM5);
3720 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3722 PRVM_G_FLOAT(OFS_RETURN) = -2;
3723 VM_Warning("VM_drawpic: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3727 if(pos[2] || size[2])
3728 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")));
3730 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);
3731 PRVM_G_FLOAT(OFS_RETURN) = 1;
3737 float drawrotpic(vector position, string pic, vector size, vector org, float angle, vector rgb, float alpha, float flag)
3740 void VM_drawrotpic(void)
3742 const char *picname;
3743 float *size, *pos, *org, *rgb;
3746 VM_SAFEPARMCOUNT(8,VM_drawrotpic);
3748 picname = PRVM_G_STRING(OFS_PARM1);
3749 VM_CheckEmptyString (picname);
3751 // is pic cached ? no function yet for that
3754 PRVM_G_FLOAT(OFS_RETURN) = -4;
3755 VM_Warning("VM_drawrotpic: %s: %s not cached !\n", PRVM_NAME, picname);
3759 pos = PRVM_G_VECTOR(OFS_PARM0);
3760 size = PRVM_G_VECTOR(OFS_PARM2);
3761 org = PRVM_G_VECTOR(OFS_PARM3);
3762 rgb = PRVM_G_VECTOR(OFS_PARM5);
3763 flag = (int) PRVM_G_FLOAT(OFS_PARM7);
3765 if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3767 PRVM_G_FLOAT(OFS_RETURN) = -2;
3768 VM_Warning("VM_drawrotpic: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3772 if(pos[2] || size[2] || org[2])
3773 Con_Printf("VM_drawrotpic: z value from pos/size/org discarded\n");
3775 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);
3776 PRVM_G_FLOAT(OFS_RETURN) = 1;
3782 float drawsubpic(vector position, vector size, string pic, vector srcPos, vector srcSize, vector rgb, float alpha, float flag)
3786 void VM_drawsubpic(void)
3788 const char *picname;
3789 float *size, *pos, *rgb, *srcPos, *srcSize, alpha;