2 // Basically every vm builtin cmd should be in here.
3 // All 3 builtin and extension lists can be found here
4 // cause large (I think they will) parts are from pr_cmds the same copyright like in pr_cmds
13 #include "cl_collision.h"
14 #include "clvm_cmds.h"
19 extern cvar_t prvm_backtraceforwarnings;
21 extern dllhandle_t ode_dll;
24 // LadyHavoc: changed this to NOT use a return statement, so that it can be used in functions that must return a value
25 void VM_Warning(prvm_prog_t *prog, const char *fmt, ...)
28 char msg[MAX_INPUTLINE];
29 static double recursive = -1;
32 dpvsnprintf(msg,sizeof(msg),fmt,argptr);
35 Con_Printf(CON_WARN "%s", msg);
37 // TODO: either add a cvar/cmd to control the state dumping or replace some of the calls with Con_Printf [9/13/2006 Black]
38 if(prvm_backtraceforwarnings.integer && recursive != host.realtime) // NOTE: this compares to the time, just in case if PRVM_PrintState causes a Host_Error and keeps recursive set
40 recursive = host.realtime;
41 PRVM_PrintState(prog, 0);
47 //============================================================================
50 // TODO DONE: move vm_files and vm_fssearchlist to prvm_prog_t struct
51 // TODO: move vm_files and vm_fssearchlist back [9/13/2006 Black]
52 // TODO: (move vm_files and vm_fssearchlist to prvm_prog_t struct again) [2007-01-23 LadyHavoc]
53 // TODO: will this war ever end? [2007-01-23 LadyHavoc]
55 void VM_CheckEmptyString(prvm_prog_t *prog, const char *s)
57 if (ISWHITESPACE(s[0]))
58 prog->error_cmd("%s: Bad string", prog->name);
61 qbool PRVM_ConsoleCommand (prvm_prog_t *prog, const char *text, int *func, qbool preserve_self, int curself, double ptime, qbool prog_loaded, const char *error_message)
63 int restorevm_tempstringsbuf_cursize;
64 int save_self = 0; // hush compiler warning
73 save_self = PRVM_gameglobaledict(self);
75 PRVM_gameglobalfloat(time) = ptime;
76 PRVM_gameglobaledict(self) = curself;
77 restorevm_tempstringsbuf_cursize = prog->tempstringsbuf.cursize;
78 PRVM_G_INT(OFS_PARM0) = PRVM_SetTempString(prog, text);
79 prog->ExecuteProgram(prog, *func, error_message);
80 prog->tempstringsbuf.cursize = restorevm_tempstringsbuf_cursize;
82 PRVM_gameglobaledict(self) = save_self;
83 r = (int) PRVM_G_FLOAT(OFS_RETURN) != 0;
89 void VM_GenerateFrameGroupBlend(prvm_prog_t *prog, framegroupblend_t *framegroupblend, const prvm_edict_t *ed)
91 // self.frame is the interpolation target (new frame)
92 // self.frame1time is the animation base time for the interpolation target
93 // self.frame2 is the interpolation start (previous frame)
94 // self.frame2time is the animation base time for the interpolation start
95 // self.lerpfrac is the interpolation strength for self.frame2
96 // self.lerpfrac3 is the interpolation strength for self.frame3
97 // self.lerpfrac4 is the interpolation strength for self.frame4
98 // pitch angle on a player model where the animator set up 5 sets of
99 // animations and the csqc simply lerps between sets)
100 framegroupblend[0].frame = (int) PRVM_gameedictfloat(ed, frame );
101 framegroupblend[1].frame = (int) PRVM_gameedictfloat(ed, frame2 );
102 framegroupblend[2].frame = (int) PRVM_gameedictfloat(ed, frame3 );
103 framegroupblend[3].frame = (int) PRVM_gameedictfloat(ed, frame4 );
104 framegroupblend[0].start = PRVM_gameedictfloat(ed, frame1time);
105 framegroupblend[1].start = PRVM_gameedictfloat(ed, frame2time);
106 framegroupblend[2].start = PRVM_gameedictfloat(ed, frame3time);
107 framegroupblend[3].start = PRVM_gameedictfloat(ed, frame4time);
108 framegroupblend[1].lerp = PRVM_gameedictfloat(ed, lerpfrac );
109 framegroupblend[2].lerp = PRVM_gameedictfloat(ed, lerpfrac3 );
110 framegroupblend[3].lerp = PRVM_gameedictfloat(ed, lerpfrac4 );
111 // assume that the (missing) lerpfrac1 is whatever remains after lerpfrac2+lerpfrac3+lerpfrac4 are summed
112 framegroupblend[0].lerp = 1 - framegroupblend[1].lerp - framegroupblend[2].lerp - framegroupblend[3].lerp;
115 // LadyHavoc: quite tempting to break apart this function to reuse the
116 // duplicated code, but I suspect it is better for performance
118 void VM_FrameBlendFromFrameGroupBlend(frameblend_t *frameblend, const framegroupblend_t *framegroupblend, const model_t *model, double curtime)
120 int sub2, numframes, f, i, k;
121 int isfirstframegroup = true;
123 double sublerp, lerp, d;
124 const animscene_t *scene;
125 const framegroupblend_t *g;
126 frameblend_t *blend = frameblend;
128 memset(blend, 0, MAX_FRAMEBLENDS * sizeof(*blend));
130 // rpolzer: Not testing isanimated here - a model might have
131 // "animations" that move no vertices (but only bones), thus rendering
132 // may assume it's not animated while processing can't.
139 nolerp = ((model->type == mod_sprite) ? !r_lerpsprites.integer : !r_lerpmodels.integer) || (model->nolerp == true);
140 numframes = model->numframes;
141 for (k = 0, g = framegroupblend;k < MAX_FRAMEGROUPBLENDS;k++, g++)
144 if ((unsigned int)f >= (unsigned int)numframes)
146 if (developer_extra.integer)
147 Con_DPrintf("VM_FrameBlendFromFrameGroupBlend: no such frame %d in model %s\n", f, model->name);
155 if (isfirstframegroup)
158 isfirstframegroup = false;
163 if (model->animscenes)
165 scene = model->animscenes + f;
166 f = scene->firstframe;
167 if (scene->framecount > 1)
169 // this code path is only used on .zym models and torches
170 sublerp = scene->framerate * (curtime - g->start);
171 f = (int) floor(sublerp);
174 if (sublerp < (1.0 / 65536.0f))
176 if (sublerp > (65535.0f / 65536.0f))
182 f = (f % scene->framecount);
183 sub2 = (sub2 % scene->framecount);
185 f = bound(0, f, (scene->framecount - 1)) + scene->firstframe;
186 sub2 = bound(0, sub2, (scene->framecount - 1)) + scene->firstframe;
188 // two framelerps produced from one animation
191 for (i = 0;i < MAX_FRAMEBLENDS;i++)
193 if (blend[i].lerp <= 0 || blend[i].subframe == sub2)
195 blend[i].subframe = sub2;
201 d = (1 - sublerp) * lerp;
206 for (i = 0;i < MAX_FRAMEBLENDS;i++)
208 if (blend[i].lerp <= 0 || blend[i].subframe == f)
210 blend[i].subframe = f;
219 void VM_UpdateEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed, const model_t *edmodel, const frameblend_t *frameblend)
221 if (ed->priv.server->skeleton.model != edmodel)
223 VM_RemoveEdictSkeleton(prog, ed);
224 ed->priv.server->skeleton.model = edmodel;
226 if (!ed->priv.server->skeleton.model || !ed->priv.server->skeleton.model->num_bones)
228 if(ed->priv.server->skeleton.relativetransforms)
229 Mem_Free(ed->priv.server->skeleton.relativetransforms);
230 ed->priv.server->skeleton.relativetransforms = NULL;
235 int skeletonindex = -1;
236 skeleton_t *skeleton;
237 skeletonindex = (int)PRVM_gameedictfloat(ed, skeletonindex) - 1;
238 if (skeletonindex >= 0 && skeletonindex < MAX_EDICTS && (skeleton = prog->skeletons[skeletonindex]) && skeleton->model->num_bones == ed->priv.server->skeleton.model->num_bones)
240 // custom skeleton controlled by the game (FTE_CSQC_SKELETONOBJECTS)
241 if (!ed->priv.server->skeleton.relativetransforms)
242 ed->priv.server->skeleton.relativetransforms = (matrix4x4_t *)Mem_Alloc(prog->progs_mempool, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
243 memcpy(ed->priv.server->skeleton.relativetransforms, skeleton->relativetransforms, ed->priv.server->skeleton.model->num_bones * sizeof(matrix4x4_t));
247 if(ed->priv.server->skeleton.relativetransforms)
248 Mem_Free(ed->priv.server->skeleton.relativetransforms);
249 ed->priv.server->skeleton.relativetransforms = NULL;
254 void VM_RemoveEdictSkeleton(prvm_prog_t *prog, prvm_edict_t *ed)
256 if (ed->priv.server->skeleton.relativetransforms)
257 Mem_Free(ed->priv.server->skeleton.relativetransforms);
258 memset(&ed->priv.server->skeleton, 0, sizeof(ed->priv.server->skeleton));
264 //============================================================================
267 void VM_VarString(prvm_prog_t *prog, int first, char *out, int outlength)
273 outend = out + outlength - 1;
274 for (i = first;i < prog->argc && out < outend;i++)
276 s = PRVM_G_STRING((OFS_PARM0+i*3));
277 while (out < outend && *s)
287 returns true if the extension is supported by the server
289 checkextension(extensionname)
293 // kind of helper function
294 static qbool checkextension(prvm_prog_t *prog, const char *name)
298 for (e = prog->extensionstring;*e;e++)
300 if(!strcasecmp(*e, name))
303 // special sheck for ODE
304 if (!strncasecmp("DP_PHYSICS_ODE", name, 14))
306 #ifndef LINK_TO_LIBODE
307 return ode_dll ? true : false;
309 #ifdef LINK_TO_LIBODE
318 // special sheck for d0_blind_id
319 if (!strcasecmp("DP_CRYPTO", name))
320 return Crypto_Available();
321 if (!strcasecmp("DP_QC_DIGEST_SHA256", name))
322 return Crypto_Available();
330 void VM_checkextension(prvm_prog_t *prog)
332 VM_SAFEPARMCOUNT(1,VM_checkextension);
334 PRVM_G_FLOAT(OFS_RETURN) = checkextension(prog, PRVM_G_STRING(OFS_PARM0));
341 This is a TERMINAL error, which will kill off the entire prog.
347 void VM_error(prvm_prog_t *prog)
350 char string[VM_STRINGTEMP_LENGTH];
352 VM_VarString(prog, 0, string, sizeof(string));
353 Con_Printf(CON_ERROR "======%s ERROR in %s:\n%s\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
354 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
355 PRVM_ED_Print(prog, ed, NULL);
357 prog->error_cmd("%s: Program error in function %s:\n%s\nTip: read above for entity information\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
364 Dumps out self, then an error message. The program is aborted and self is
365 removed, but the level can continue.
370 void VM_objerror(prvm_prog_t *prog)
373 char string[VM_STRINGTEMP_LENGTH];
375 VM_VarString(prog, 0, string, sizeof(string));
376 Con_Printf(CON_ERROR "======OBJECT ERROR======\n"); // , prog->name, PRVM_GetString(prog->xfunction->s_name), string); // or include them? FIXME
377 ed = PRVM_PROG_TO_EDICT(PRVM_allglobaledict(self));
378 PRVM_ED_Print(prog, ed, NULL);
379 PRVM_ED_Free (prog, ed);
380 Con_Printf(CON_ERROR "%s OBJECT ERROR in %s:\n%s\nTip: read above for entity information\n", prog->name, PRVM_GetString(prog, prog->xfunction->s_name), string);
392 void VM_print(prvm_prog_t *prog)
394 char string[VM_STRINGTEMP_LENGTH];
396 VM_VarString(prog, 0, string, sizeof(string));
404 broadcast print to everyone on server
409 void VM_bprint(prvm_prog_t *prog)
411 char string[VM_STRINGTEMP_LENGTH];
415 VM_Warning(prog, "VM_bprint: game is not server(%s) !\n", prog->name);
419 VM_VarString(prog, 0, string, sizeof(string));
420 SV_BroadcastPrint(string);
425 VM_sprint (menu & client but only if server.active == true)
427 single print to a specific client
429 sprint(float clientnum,...[string])
432 void VM_sprint(prvm_prog_t *prog)
436 char string[VM_STRINGTEMP_LENGTH];
438 VM_SAFEPARMCOUNTRANGE(1, 8, VM_sprint);
440 //find client for this entity
441 clientnum = (int)PRVM_G_FLOAT(OFS_PARM0);
442 if (!sv.active || clientnum < 0 || clientnum >= svs.maxclients || !svs.clients[clientnum].active)
444 VM_Warning(prog, "VM_sprint: %s: invalid client or server is not active !\n", prog->name);
448 client = svs.clients + clientnum;
449 if (!client->netconnection)
452 VM_VarString(prog, 1, string, sizeof(string));
453 MSG_WriteChar(&client->netconnection->message,svc_print);
454 MSG_WriteString(&client->netconnection->message, string);
461 single print to the screen
466 void VM_centerprint(prvm_prog_t *prog)
468 char string[VM_STRINGTEMP_LENGTH];
470 VM_SAFEPARMCOUNTRANGE(1, 8, VM_centerprint);
471 VM_VarString(prog, 0, string, sizeof(string));
472 SCR_CenterPrint(string);
479 vector normalize(vector)
482 void VM_normalize(prvm_prog_t *prog)
488 VM_SAFEPARMCOUNT(1,VM_normalize);
490 value1 = PRVM_G_VECTOR(OFS_PARM0);
492 f = VectorLength2(value1);
496 VectorScale(value1, f, newvalue);
499 VectorClear(newvalue);
501 VectorCopy (newvalue, PRVM_G_VECTOR(OFS_RETURN));
511 void VM_vlen(prvm_prog_t *prog)
513 VM_SAFEPARMCOUNT(1,VM_vlen);
514 PRVM_G_FLOAT(OFS_RETURN) = VectorLength(PRVM_G_VECTOR(OFS_PARM0));
521 float vectoyaw(vector)
524 void VM_vectoyaw(prvm_prog_t *prog)
529 VM_SAFEPARMCOUNT(1,VM_vectoyaw);
531 value1 = PRVM_G_VECTOR(OFS_PARM0);
533 if (value1[1] == 0 && value1[0] == 0)
537 yaw = (int) (atan2(value1[1], value1[0]) * 180 / M_PI);
542 PRVM_G_FLOAT(OFS_RETURN) = yaw;
550 vector vectoangles(vector[, vector])
553 void VM_vectoangles(prvm_prog_t *prog)
555 vec3_t result, forward, up;
556 VM_SAFEPARMCOUNTRANGE(1, 2,VM_vectoangles);
558 VectorCopy(PRVM_G_VECTOR(OFS_PARM0), forward);
561 VectorCopy(PRVM_G_VECTOR(OFS_PARM1), up);
562 AnglesFromVectors(result, forward, up, true);
565 AnglesFromVectors(result, forward, NULL, true);
566 VectorCopy(result, PRVM_G_VECTOR(OFS_RETURN));
573 Returns a number from 0<= num < 1
578 void VM_random(prvm_prog_t *prog)
580 VM_SAFEPARMCOUNT(0,VM_random);
582 PRVM_G_FLOAT(OFS_RETURN) = lhrandom(0, 1);
589 localsound(string sample)
592 void VM_localsound(prvm_prog_t *prog)
596 VM_SAFEPARMCOUNT(1,VM_localsound);
598 s = PRVM_G_STRING(OFS_PARM0);
600 if(!S_LocalSound (s))
602 PRVM_G_FLOAT(OFS_RETURN) = -4;
603 VM_Warning(prog, "VM_localsound: Failed to play %s for %s !\n", s, prog->name);
607 PRVM_G_FLOAT(OFS_RETURN) = 1;
617 void VM_break(prvm_prog_t *prog)
619 prog->error_cmd("%s: break statement", prog->name);
622 //============================================================================
628 Sends text over to the client's execution buffer
630 [localcmd (string, ...) or]
634 void VM_localcmd_local(prvm_prog_t *prog)
636 char string[VM_STRINGTEMP_LENGTH];
637 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd_local);
638 VM_VarString(prog, 0, string, sizeof(string));
639 Cbuf_AddText(cmd_local, string);
646 Sends text over to the server's execution buffer
648 [localcmd (string, ...) or]
652 void VM_localcmd_server(prvm_prog_t *prog)
654 char string[VM_STRINGTEMP_LENGTH];
655 VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd_server);
656 VM_VarString(prog, 0, string, sizeof(string));
657 Cbuf_AddText(cmd_local, string);
660 static qbool PRVM_Cvar_ReadOk(prvm_prog_t *prog, const char *string)
663 cvar = Cvar_FindVar(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask);
664 return ((cvar) && ((cvar->flags & CF_PRIVATE) == 0));
674 void VM_cvar(prvm_prog_t *prog)
676 char string[VM_STRINGTEMP_LENGTH];
677 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
678 VM_VarString(prog, 0, string, sizeof(string));
679 VM_CheckEmptyString(prog, string);
680 PRVM_G_FLOAT(OFS_RETURN) = PRVM_Cvar_ReadOk(prog, string) ? Cvar_VariableValue(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask) : 0;
687 float cvar_type (string)
688 float CVAR_TYPEFLAG_EXISTS = 1;
689 float CVAR_TYPEFLAG_SAVED = 2;
690 float CVAR_TYPEFLAG_PRIVATE = 4;
691 float CVAR_TYPEFLAG_ENGINE = 8;
692 float CVAR_TYPEFLAG_HASDESCRIPTION = 16;
693 float CVAR_TYPEFLAG_READONLY = 32;
696 void VM_cvar_type(prvm_prog_t *prog)
698 char string[VM_STRINGTEMP_LENGTH];
702 VM_SAFEPARMCOUNTRANGE(1, 8, VM_cvar_type);
703 VM_VarString(prog, 0, string, sizeof(string));
704 VM_CheckEmptyString(prog, string);
705 cvar = Cvar_FindVar(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask);
710 PRVM_G_FLOAT(OFS_RETURN) = 0;
711 return; // CVAR_TYPE_NONE
714 ret = 1; // CVAR_EXISTS
715 if(cvar->flags & CF_ARCHIVE)
716 ret |= 2; // CVAR_TYPE_SAVED
717 if(cvar->flags & CF_PRIVATE)
718 ret |= 4; // CVAR_TYPE_PRIVATE
719 if(!(cvar->flags & CF_ALLOCATED))
720 ret |= 8; // CVAR_TYPE_ENGINE
721 if(cvar->description != cvar_dummy_description)
722 ret |= 16; // CVAR_TYPE_HASDESCRIPTION
723 if(cvar->flags & CF_READONLY)
724 ret |= 32; // CVAR_TYPE_READONLY
726 PRVM_G_FLOAT(OFS_RETURN) = ret;
733 const string VM_cvar_string (string, ...)
736 void VM_cvar_string(prvm_prog_t *prog)
738 char string[VM_STRINGTEMP_LENGTH];
739 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_string);
740 VM_VarString(prog, 0, string, sizeof(string));
741 VM_CheckEmptyString(prog, string);
742 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_Cvar_ReadOk(prog, string) ? Cvar_VariableString(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask) : "");
747 ========================
750 const string VM_cvar_defstring (string, ...)
751 ========================
753 void VM_cvar_defstring(prvm_prog_t *prog)
755 char string[VM_STRINGTEMP_LENGTH];
756 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_defstring);
757 VM_VarString(prog, 0, string, sizeof(string));
758 VM_CheckEmptyString(prog, string);
759 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDefString(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask));
763 ========================
766 const string VM_cvar_description (string, ...)
767 ========================
769 void VM_cvar_description(prvm_prog_t *prog)
771 char string[VM_STRINGTEMP_LENGTH];
772 VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_description);
773 VM_VarString(prog, 0, string, sizeof(string));
774 VM_CheckEmptyString(prog, string);
775 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Cvar_VariableDescription(prog->console_cmd->cvars, string, prog->console_cmd->cvars_flagsmask));
781 void cvar_set (string,string, ...)
784 void VM_cvar_set(prvm_prog_t *prog)
787 char string[VM_STRINGTEMP_LENGTH];
788 VM_SAFEPARMCOUNTRANGE(2,8,VM_cvar_set);
789 VM_VarString(prog, 1, string, sizeof(string));
790 name = PRVM_G_STRING(OFS_PARM0);
791 VM_CheckEmptyString(prog, name);
792 Cvar_Set(prog->console_cmd->cvars, name, string);
802 void VM_dprint(prvm_prog_t *prog)
804 char string[VM_STRINGTEMP_LENGTH];
805 VM_SAFEPARMCOUNTRANGE(1, 8, VM_dprint);
806 VM_VarString(prog, 0, string, sizeof(string));
808 Con_DPrintf("%s", string);
810 Con_DPrintf("%s: %s", prog->name, string);
822 void VM_ftos(prvm_prog_t *prog)
827 VM_SAFEPARMCOUNT(1, VM_ftos);
829 v = PRVM_G_FLOAT(OFS_PARM0);
831 if ((prvm_vec_t)((prvm_int_t)v) == v)
832 dpsnprintf(s, sizeof(s), "%.0f", v);
834 dpsnprintf(s, sizeof(s), "%f", v);
835 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
846 void VM_fabs(prvm_prog_t *prog)
850 VM_SAFEPARMCOUNT(1,VM_fabs);
852 v = PRVM_G_FLOAT(OFS_PARM0);
853 PRVM_G_FLOAT(OFS_RETURN) = fabs(v);
864 void VM_vtos(prvm_prog_t *prog)
868 VM_SAFEPARMCOUNT(1,VM_vtos);
870 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]);
871 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
882 void VM_etos(prvm_prog_t *prog)
886 VM_SAFEPARMCOUNT(1, VM_etos);
888 dpsnprintf (s, sizeof(s), "entity %i", PRVM_G_EDICTNUM(OFS_PARM0));
889 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
896 float stof(...[string])
899 void VM_stof(prvm_prog_t *prog)
901 char string[VM_STRINGTEMP_LENGTH];
902 VM_SAFEPARMCOUNTRANGE(1, 8, VM_stof);
903 VM_VarString(prog, 0, string, sizeof(string));
904 PRVM_G_FLOAT(OFS_RETURN) = atof(string);
908 ========================
912 ========================
914 void VM_itof(prvm_prog_t *prog)
916 VM_SAFEPARMCOUNT(1, VM_itof);
917 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
921 ========================
924 entity ftoe(float num)
925 ========================
927 void VM_ftoe(prvm_prog_t *prog)
930 VM_SAFEPARMCOUNT(1, VM_ftoe);
932 ent = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM0);
933 if (ent < 0 || ent >= prog->max_edicts || PRVM_PROG_TO_EDICT(ent)->free)
934 ent = 0; // return world instead of a free or invalid entity
936 PRVM_G_INT(OFS_RETURN) = ent;
940 ========================
943 float etof(entity ent)
944 ========================
946 void VM_etof(prvm_prog_t *prog)
948 VM_SAFEPARMCOUNT(1, VM_etof);
949 PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICTNUM(OFS_PARM0);
956 string strftime(float uselocaltime, string[, string ...])
959 void VM_strftime(prvm_prog_t *prog)
968 char fmt[VM_STRINGTEMP_LENGTH];
969 char result[VM_STRINGTEMP_LENGTH];
970 VM_SAFEPARMCOUNTRANGE(2, 8, VM_strftime);
971 VM_VarString(prog, 1, fmt, sizeof(fmt));
974 if (PRVM_G_FLOAT(OFS_PARM0))
975 tmresult = localtime_s(&tm, &t);
977 tmresult = gmtime_s(&tm, &t);
980 if (PRVM_G_FLOAT(OFS_PARM0))
987 PRVM_G_INT(OFS_RETURN) = 0;
991 strftime(result, sizeof(result), fmt, &tm);
993 strftime(result, sizeof(result), fmt, tm);
995 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, result);
1006 void VM_spawn(prvm_prog_t *prog)
1009 VM_SAFEPARMCOUNT(0, VM_spawn);
1010 prog->xfunction->builtinsprofile += 20;
1011 ed = PRVM_ED_Alloc(prog);
1012 VM_RETURN_EDICT(ed);
1023 void VM_remove(prvm_prog_t *prog)
1026 prog->xfunction->builtinsprofile += 20;
1028 VM_SAFEPARMCOUNT(1, VM_remove);
1030 ed = PRVM_G_EDICT(OFS_PARM0);
1031 if( PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
1033 if (developer.integer > 0)
1034 VM_Warning(prog, "VM_remove: tried to remove the null entity or a reserved entity!\n" );
1038 if (developer.integer > 0)
1039 VM_Warning(prog, "VM_remove: tried to remove an already freed entity!\n" );
1042 PRVM_ED_Free (prog, ed);
1049 entity find(entity start, .string field, string match)
1053 void VM_find(prvm_prog_t *prog)
1060 VM_SAFEPARMCOUNT(3,VM_find);
1062 e = PRVM_G_EDICTNUM(OFS_PARM0);
1063 f = PRVM_G_INT(OFS_PARM1);
1064 s = PRVM_G_STRING(OFS_PARM2);
1066 // LadyHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1067 // expects it to find all the monsters, so we must be careful to support
1070 for (e++ ; e < prog->num_edicts ; e++)
1072 prog->xfunction->builtinsprofile++;
1073 ed = PRVM_EDICT_NUM(e);
1076 t = PRVM_E_STRING(ed,f);
1081 VM_RETURN_EDICT(ed);
1086 VM_RETURN_EDICT(prog->edicts);
1093 entity findfloat(entity start, .float field, float match)
1094 entity findentity(entity start, .entity field, entity match)
1097 // LadyHavoc: added this for searching float, int, and entity reference fields
1098 void VM_findfloat(prvm_prog_t *prog)
1105 VM_SAFEPARMCOUNT(3,VM_findfloat);
1107 e = PRVM_G_EDICTNUM(OFS_PARM0);
1108 f = PRVM_G_INT(OFS_PARM1);
1109 s = PRVM_G_FLOAT(OFS_PARM2);
1111 for (e++ ; e < prog->num_edicts ; e++)
1113 prog->xfunction->builtinsprofile++;
1114 ed = PRVM_EDICT_NUM(e);
1117 if (PRVM_E_FLOAT(ed,f) == s)
1119 VM_RETURN_EDICT(ed);
1124 VM_RETURN_EDICT(prog->edicts);
1131 entity findchain(.string field, string match)
1134 // chained search for strings in entity fields
1135 // entity(.string field, string match) findchain = #402;
1136 void VM_findchain(prvm_prog_t *prog)
1141 prvm_edict_t *ent, *chain;
1144 VM_SAFEPARMCOUNTRANGE(2,3,VM_findchain);
1147 chainfield = PRVM_G_INT(OFS_PARM2);
1149 chainfield = prog->fieldoffsets.chain;
1151 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1153 chain = prog->edicts;
1155 f = PRVM_G_INT(OFS_PARM0);
1156 s = PRVM_G_STRING(OFS_PARM1);
1158 // LadyHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
1159 // expects it to find all the monsters, so we must be careful to support
1162 ent = PRVM_NEXT_EDICT(prog->edicts);
1163 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1165 prog->xfunction->builtinsprofile++;
1168 t = PRVM_E_STRING(ent,f);
1174 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_NUM_FOR_EDICT(chain);
1178 VM_RETURN_EDICT(chain);
1185 entity findchainfloat(.string field, float match)
1186 entity findchainentity(.string field, entity match)
1189 // LadyHavoc: chained search for float, int, and entity reference fields
1190 // entity(.string field, float match) findchainfloat = #403;
1191 void VM_findchainfloat(prvm_prog_t *prog)
1196 prvm_edict_t *ent, *chain;
1199 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainfloat);
1202 chainfield = PRVM_G_INT(OFS_PARM2);
1204 chainfield = prog->fieldoffsets.chain;
1206 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1208 chain = (prvm_edict_t *)prog->edicts;
1210 f = PRVM_G_INT(OFS_PARM0);
1211 s = PRVM_G_FLOAT(OFS_PARM1);
1213 ent = PRVM_NEXT_EDICT(prog->edicts);
1214 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1216 prog->xfunction->builtinsprofile++;
1219 if (PRVM_E_FLOAT(ent,f) != s)
1222 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1226 VM_RETURN_EDICT(chain);
1230 ========================
1233 entity findflags(entity start, .float field, float match)
1234 ========================
1236 // LadyHavoc: search for flags in float fields
1237 void VM_findflags(prvm_prog_t *prog)
1244 VM_SAFEPARMCOUNT(3, VM_findflags);
1247 e = PRVM_G_EDICTNUM(OFS_PARM0);
1248 f = PRVM_G_INT(OFS_PARM1);
1249 s = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM2);
1251 for (e++ ; e < prog->num_edicts ; e++)
1253 prog->xfunction->builtinsprofile++;
1254 ed = PRVM_EDICT_NUM(e);
1257 if (!PRVM_E_FLOAT(ed,f))
1259 if ((prvm_int_t)PRVM_E_FLOAT(ed,f) & s)
1261 VM_RETURN_EDICT(ed);
1266 VM_RETURN_EDICT(prog->edicts);
1270 ========================
1273 entity findchainflags(.float field, float match)
1274 ========================
1276 // LadyHavoc: chained search for flags in float fields
1277 void VM_findchainflags(prvm_prog_t *prog)
1282 prvm_edict_t *ent, *chain;
1285 VM_SAFEPARMCOUNTRANGE(2, 3, VM_findchainflags);
1288 chainfield = PRVM_G_INT(OFS_PARM2);
1290 chainfield = prog->fieldoffsets.chain;
1292 prog->error_cmd("VM_findchain: %s doesnt have the specified chain field !", prog->name);
1294 chain = (prvm_edict_t *)prog->edicts;
1296 f = PRVM_G_INT(OFS_PARM0);
1297 s = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM1);
1299 ent = PRVM_NEXT_EDICT(prog->edicts);
1300 for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1302 prog->xfunction->builtinsprofile++;
1305 if (!PRVM_E_FLOAT(ent,f))
1307 if (!((prvm_int_t)PRVM_E_FLOAT(ent,f) & s))
1310 PRVM_EDICTFIELDEDICT(ent,chainfield) = PRVM_EDICT_TO_PROG(chain);
1314 VM_RETURN_EDICT(chain);
1321 string precache_sound (string sample)
1324 void VM_precache_sound(prvm_prog_t *prog)
1328 VM_SAFEPARMCOUNT(1, VM_precache_sound);
1330 s = PRVM_G_STRING(OFS_PARM0);
1331 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1332 //VM_CheckEmptyString(prog, s);
1334 if(snd_initialized.integer && !S_PrecacheSound(s, true, true))
1336 VM_Warning(prog, "VM_precache_sound: Failed to load %s for %s\n", s, prog->name);
1345 returns the same string as output
1347 does nothing, only used by qcc to build .pak archives
1350 void VM_precache_file(prvm_prog_t *prog)
1352 VM_SAFEPARMCOUNT(1,VM_precache_file);
1353 // precache_file is only used to copy files with qcc, it does nothing
1354 PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1364 void VM_coredump(prvm_prog_t *prog)
1366 VM_SAFEPARMCOUNT(0,VM_coredump);
1368 Cbuf_AddText(cmd_local, "prvm_edicts ");
1369 Cbuf_AddText(cmd_local, prog->name);
1370 Cbuf_AddText(cmd_local, "\n");
1380 void VM_stackdump(prvm_prog_t *prog)
1382 VM_SAFEPARMCOUNT(0, VM_stackdump);
1384 PRVM_StackTrace(prog);
1395 void VM_crash(prvm_prog_t *prog)
1397 VM_SAFEPARMCOUNT(0, VM_crash);
1399 prog->error_cmd("Crash called by %s",prog->name);
1409 void VM_traceon(prvm_prog_t *prog)
1411 VM_SAFEPARMCOUNT(0,VM_traceon);
1423 void VM_traceoff(prvm_prog_t *prog)
1425 VM_SAFEPARMCOUNT(0,VM_traceoff);
1427 prog->trace = false;
1437 void VM_eprint(prvm_prog_t *prog)
1439 VM_SAFEPARMCOUNT(1,VM_eprint);
1441 PRVM_ED_PrintNum (prog, PRVM_G_EDICTNUM(OFS_PARM0), NULL);
1451 void VM_rint(prvm_prog_t *prog)
1454 VM_SAFEPARMCOUNT(1,VM_rint);
1456 f = PRVM_G_FLOAT(OFS_PARM0);
1458 PRVM_G_FLOAT(OFS_RETURN) = floor(f + 0.5);
1460 PRVM_G_FLOAT(OFS_RETURN) = ceil(f - 0.5);
1470 void VM_floor(prvm_prog_t *prog)
1472 VM_SAFEPARMCOUNT(1,VM_floor);
1474 PRVM_G_FLOAT(OFS_RETURN) = floor(PRVM_G_FLOAT(OFS_PARM0));
1484 void VM_ceil(prvm_prog_t *prog)
1486 VM_SAFEPARMCOUNT(1,VM_ceil);
1488 PRVM_G_FLOAT(OFS_RETURN) = ceil(PRVM_G_FLOAT(OFS_PARM0));
1496 entity nextent(entity)
1499 void VM_nextent(prvm_prog_t *prog)
1504 VM_SAFEPARMCOUNT(1, VM_nextent);
1506 i = PRVM_G_EDICTNUM(OFS_PARM0);
1509 prog->xfunction->builtinsprofile++;
1511 if (i == prog->num_edicts)
1513 VM_RETURN_EDICT(prog->edicts);
1516 ent = PRVM_EDICT_NUM(i);
1519 VM_RETURN_EDICT(ent);
1525 //=============================================================================
1532 changelevel(string map)
1535 void VM_changelevel(prvm_prog_t *prog)
1538 VM_SAFEPARMCOUNT(1, VM_changelevel);
1542 VM_Warning(prog, "VM_changelevel: game is not server (%s)\n", prog->name);
1546 // make sure we don't issue two changelevels
1547 if (svs.changelevel_issued)
1549 svs.changelevel_issued = true;
1551 Cbuf_AddText(cmd_local, va(vabuf, sizeof(vabuf), "changelevel %s\n", PRVM_G_STRING(OFS_PARM0)));
1561 void VM_sin(prvm_prog_t *prog)
1563 VM_SAFEPARMCOUNT(1,VM_sin);
1564 PRVM_G_FLOAT(OFS_RETURN) = sin(PRVM_G_FLOAT(OFS_PARM0));
1573 void VM_cos(prvm_prog_t *prog)
1575 VM_SAFEPARMCOUNT(1,VM_cos);
1576 PRVM_G_FLOAT(OFS_RETURN) = cos(PRVM_G_FLOAT(OFS_PARM0));
1586 void VM_sqrt(prvm_prog_t *prog)
1588 VM_SAFEPARMCOUNT(1,VM_sqrt);
1589 PRVM_G_FLOAT(OFS_RETURN) = sqrt(PRVM_G_FLOAT(OFS_PARM0));
1599 void VM_asin(prvm_prog_t *prog)
1601 VM_SAFEPARMCOUNT(1,VM_asin);
1602 PRVM_G_FLOAT(OFS_RETURN) = asin(PRVM_G_FLOAT(OFS_PARM0));
1611 void VM_acos(prvm_prog_t *prog)
1613 VM_SAFEPARMCOUNT(1,VM_acos);
1614 PRVM_G_FLOAT(OFS_RETURN) = acos(PRVM_G_FLOAT(OFS_PARM0));
1623 void VM_atan(prvm_prog_t *prog)
1625 VM_SAFEPARMCOUNT(1,VM_atan);
1626 PRVM_G_FLOAT(OFS_RETURN) = atan(PRVM_G_FLOAT(OFS_PARM0));
1632 float atan2(float,float)
1635 void VM_atan2(prvm_prog_t *prog)
1637 VM_SAFEPARMCOUNT(2,VM_atan2);
1638 PRVM_G_FLOAT(OFS_RETURN) = atan2(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1647 void VM_tan(prvm_prog_t *prog)
1649 VM_SAFEPARMCOUNT(1,VM_tan);
1650 PRVM_G_FLOAT(OFS_RETURN) = tan(PRVM_G_FLOAT(OFS_PARM0));
1657 Returns a vector of length < 1 and > 0
1662 void VM_randomvec(prvm_prog_t *prog)
1665 VM_SAFEPARMCOUNT(0, VM_randomvec);
1667 VectorCopy(temp, PRVM_G_VECTOR(OFS_RETURN));
1670 //=============================================================================
1676 float registercvar (string name, string value[, float flags])
1679 void VM_registercvar(prvm_prog_t *prog)
1681 const char *name, *value;
1684 VM_SAFEPARMCOUNTRANGE(2, 3, VM_registercvar);
1686 name = PRVM_G_STRING(OFS_PARM0);
1687 value = PRVM_G_STRING(OFS_PARM1);
1688 flags = prog->argc >= 3 ? (int)PRVM_G_FLOAT(OFS_PARM2) : 0;
1689 PRVM_G_FLOAT(OFS_RETURN) = 0;
1691 if(flags > CF_MAXFLAGSVAL)
1694 // first check to see if it has already been defined
1695 if (Cvar_FindVar (prog->console_cmd->cvars, name, prog->console_cmd->cvars_flagsmask))
1698 // check for overlap with a command
1699 if (Cmd_Exists(cmd_local, name))
1701 VM_Warning(prog, "VM_registercvar: %s is a command\n", name);
1705 Cvar_Get(prog->console_cmd->cvars, name, value, prog->console_cmd->cvars_flagsmask | flags, NULL);
1707 PRVM_G_FLOAT(OFS_RETURN) = 1; // success
1715 returns the minimum of two supplied floats
1717 float min(float a, float b, ...[float])
1720 void VM_min(prvm_prog_t *prog)
1722 VM_SAFEPARMCOUNTRANGE(2, 8, VM_min);
1723 // LadyHavoc: 3+ argument enhancement suggested by FrikaC
1724 if (prog->argc >= 3)
1727 float f = PRVM_G_FLOAT(OFS_PARM0);
1728 for (i = 1;i < prog->argc;i++)
1729 if (f > PRVM_G_FLOAT((OFS_PARM0+i*3)))
1730 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1731 PRVM_G_FLOAT(OFS_RETURN) = f;
1734 PRVM_G_FLOAT(OFS_RETURN) = min(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1741 returns the maximum of two supplied floats
1743 float max(float a, float b, ...[float])
1746 void VM_max(prvm_prog_t *prog)
1748 VM_SAFEPARMCOUNTRANGE(2, 8, VM_max);
1749 // LadyHavoc: 3+ argument enhancement suggested by FrikaC
1750 if (prog->argc >= 3)
1753 float f = PRVM_G_FLOAT(OFS_PARM0);
1754 for (i = 1;i < prog->argc;i++)
1755 if (f < PRVM_G_FLOAT((OFS_PARM0+i*3)))
1756 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1757 PRVM_G_FLOAT(OFS_RETURN) = f;
1760 PRVM_G_FLOAT(OFS_RETURN) = max(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1767 returns number bounded by supplied range
1769 float bound(float min, float value, float max)
1772 void VM_bound(prvm_prog_t *prog)
1774 VM_SAFEPARMCOUNT(3,VM_bound);
1775 PRVM_G_FLOAT(OFS_RETURN) = bound(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1), PRVM_G_FLOAT(OFS_PARM2));
1782 returns a raised to power b
1784 float pow(float a, float b)
1787 void VM_pow(prvm_prog_t *prog)
1789 VM_SAFEPARMCOUNT(2,VM_pow);
1790 PRVM_G_FLOAT(OFS_RETURN) = pow(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1793 void VM_log(prvm_prog_t *prog)
1795 VM_SAFEPARMCOUNT(1,VM_log);
1796 PRVM_G_FLOAT(OFS_RETURN) = log(PRVM_G_FLOAT(OFS_PARM0));
1799 void VM_Files_Init(prvm_prog_t *prog)
1802 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1803 prog->openfiles[i] = NULL;
1806 void VM_Files_CloseAll(prvm_prog_t *prog)
1809 for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1811 if (prog->openfiles[i])
1812 FS_Close(prog->openfiles[i]);
1813 prog->openfiles[i] = NULL;
1817 static qfile_t *VM_GetFileHandle(prvm_prog_t *prog, int index)
1819 if (index < 0 || index >= PRVM_MAX_OPENFILES)
1821 Con_Printf("VM_GetFileHandle: invalid file handle %i used in %s\n", index, prog->name);
1824 if (prog->openfiles[index] == NULL)
1826 Con_Printf("VM_GetFileHandle: no such file handle %i (or file has been closed) in %s\n", index, prog->name);
1829 return prog->openfiles[index];
1836 float fopen(string filename, float mode)
1839 // float(string filename, float mode) fopen = #110;
1840 // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE),
1841 // returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason
1842 void VM_fopen(prvm_prog_t *prog)
1845 const char *modestring, *filename;
1848 VM_SAFEPARMCOUNT(2,VM_fopen);
1850 for (filenum = 0;filenum < PRVM_MAX_OPENFILES;filenum++)
1851 if (prog->openfiles[filenum] == NULL)
1853 if (filenum >= PRVM_MAX_OPENFILES)
1855 PRVM_G_FLOAT(OFS_RETURN) = -2;
1856 VM_Warning(prog, "VM_fopen: %s ran out of file handles (%i)\n", prog->name, PRVM_MAX_OPENFILES);
1859 filename = PRVM_G_STRING(OFS_PARM0);
1860 mode = (int)PRVM_G_FLOAT(OFS_PARM1);
1863 case 0: // FILE_READ
1865 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
1866 if (prog->openfiles[filenum] == NULL)
1867 prog->openfiles[filenum] = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
1869 case 1: // FILE_APPEND
1871 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1873 case 2: // FILE_WRITE
1875 prog->openfiles[filenum] = FS_OpenRealFile(va(vabuf, sizeof(vabuf), "data/%s", filename), modestring, false);
1878 PRVM_G_FLOAT(OFS_RETURN) = -3;
1879 VM_Warning(prog, "VM_fopen: %s: no such mode %i (valid: 0 = read, 1 = append, 2 = write)\n", prog->name, mode);
1883 if (prog->openfiles[filenum] == NULL)
1885 PRVM_G_FLOAT(OFS_RETURN) = -1;
1886 if (developer_extra.integer)
1887 VM_Warning(prog, "VM_fopen: %s: %s mode %s failed\n", prog->name, filename, modestring);
1891 PRVM_G_FLOAT(OFS_RETURN) = filenum;
1892 if (developer_extra.integer)
1893 Con_DPrintf("VM_fopen: %s: %s mode %s opened as #%i\n", prog->name, filename, modestring, filenum);
1894 prog->openfiles_origin[filenum] = PRVM_AllocationOrigin(prog);
1902 fclose(float fhandle)
1905 //void(float fhandle) fclose = #111; // closes a file
1906 void VM_fclose(prvm_prog_t *prog)
1910 VM_SAFEPARMCOUNT(1,VM_fclose);
1912 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1913 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1915 VM_Warning(prog, "VM_fclose: invalid file handle %i used in %s\n", filenum, prog->name);
1918 if (prog->openfiles[filenum] == NULL)
1920 VM_Warning(prog, "VM_fclose: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1923 FS_Close(prog->openfiles[filenum]);
1924 prog->openfiles[filenum] = NULL;
1925 if(prog->openfiles_origin[filenum])
1926 PRVM_Free((char *)prog->openfiles_origin[filenum]);
1927 if (developer_extra.integer)
1928 Con_DPrintf("VM_fclose: %s: #%i closed\n", prog->name, filenum);
1935 string fgets(float fhandle)
1938 //string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring
1939 void VM_fgets(prvm_prog_t *prog)
1942 char string[VM_STRINGTEMP_LENGTH];
1945 VM_SAFEPARMCOUNT(1,VM_fgets);
1947 // set the return value regardless of any possible errors
1948 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
1950 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1951 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1953 VM_Warning(prog, "VM_fgets: invalid file handle %i used in %s\n", filenum, prog->name);
1956 if (prog->openfiles[filenum] == NULL)
1958 VM_Warning(prog, "VM_fgets: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
1964 c = FS_Getc(prog->openfiles[filenum]);
1965 if (c == '\r' || c == '\n' || c < 0)
1967 if (end < VM_STRINGTEMP_LENGTH - 1)
1971 // remove \n following \r
1974 c = FS_Getc(prog->openfiles[filenum]);
1976 FS_UnGetc(prog->openfiles[filenum], (unsigned char)c);
1978 if (developer_extra.integer)
1979 Con_DPrintf("fgets: %s: %s\n", prog->name, string);
1981 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
1988 fputs(float fhandle, string s)
1991 //void(float fhandle, string s) fputs = #113; // writes a line of text to the end of the file
1992 void VM_fputs(prvm_prog_t *prog)
1995 char string[VM_STRINGTEMP_LENGTH];
1998 VM_SAFEPARMCOUNT(2,VM_fputs);
2000 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
2001 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
2003 VM_Warning(prog, "VM_fputs: invalid file handle %i used in %s\n", filenum, prog->name);
2006 if (prog->openfiles[filenum] == NULL)
2008 VM_Warning(prog, "VM_fputs: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
2011 VM_VarString(prog, 1, string, sizeof(string));
2012 if ((stringlength = (int)strlen(string)))
2013 FS_Write(prog->openfiles[filenum], string, stringlength);
2014 if (developer_extra.integer)
2015 Con_DPrintf("fputs: %s: %s\n", prog->name, string);
2022 writetofile(float fhandle, entity ent)
2025 void VM_writetofile(prvm_prog_t *prog)
2030 VM_SAFEPARMCOUNT(2, VM_writetofile);
2032 file = VM_GetFileHandle(prog, (int)PRVM_G_FLOAT(OFS_PARM0));
2035 VM_Warning(prog, "VM_writetofile: invalid or closed file handle\n");
2039 ent = PRVM_G_EDICT(OFS_PARM1);
2042 VM_Warning(prog, "VM_writetofile: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2046 PRVM_ED_Write (prog, file, ent);
2049 // KrimZon - DP_QC_ENTITYDATA
2054 float() numentityfields
2055 Return the number of entity fields - NOT offsets
2058 void VM_numentityfields(prvm_prog_t *prog)
2060 PRVM_G_FLOAT(OFS_RETURN) = prog->numfielddefs;
2063 // KrimZon - DP_QC_ENTITYDATA
2068 string(float fieldnum) entityfieldname
2069 Return name of the specified field as a string, or empty if the field is invalid (warning)
2072 void VM_entityfieldname(prvm_prog_t *prog)
2075 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2077 if (i < 0 || i >= prog->numfielddefs)
2079 VM_Warning(prog, "VM_entityfieldname: %s: field index out of bounds\n", prog->name);
2080 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2084 d = &prog->fielddefs[i];
2085 PRVM_G_INT(OFS_RETURN) = d->s_name; // presuming that s_name points to a string already
2088 // KrimZon - DP_QC_ENTITYDATA
2093 float(float fieldnum) entityfieldtype
2096 void VM_entityfieldtype(prvm_prog_t *prog)
2099 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2101 if (i < 0 || i >= prog->numfielddefs)
2103 VM_Warning(prog, "VM_entityfieldtype: %s: field index out of bounds\n", prog->name);
2104 PRVM_G_FLOAT(OFS_RETURN) = -1.0;
2108 d = &prog->fielddefs[i];
2109 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t)d->type;
2112 // KrimZon - DP_QC_ENTITYDATA
2115 VM_getentityfieldstring
2117 string(float fieldnum, entity ent) getentityfieldstring
2120 void VM_getentityfieldstring(prvm_prog_t *prog)
2122 // put the data into a string
2127 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2128 char valuebuf[MAX_INPUTLINE];
2130 if (i < 0 || i >= prog->numfielddefs)
2132 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2133 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2137 d = &prog->fielddefs[i];
2140 ent = PRVM_G_EDICT(OFS_PARM1);
2143 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2144 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2147 val = (prvm_eval_t *)(ent->fields.fp + d->ofs);
2149 // if it's 0 or blank, return an empty string
2150 type = d->type & ~DEF_SAVEGLOBAL;
2151 for (j=0 ; j<prvm_type_size[type] ; j++)
2152 if (val->ivector[j])
2154 if (j == prvm_type_size[type])
2156 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2160 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, PRVM_UglyValueString(prog, (etype_t)d->type, val, valuebuf, sizeof(valuebuf)));
2163 // KrimZon - DP_QC_ENTITYDATA
2166 VM_putentityfieldstring
2168 float(float fieldnum, entity ent, string s) putentityfieldstring
2171 void VM_putentityfieldstring(prvm_prog_t *prog)
2175 int i = (int)PRVM_G_FLOAT(OFS_PARM0);
2177 if (i < 0 || i >= prog->numfielddefs)
2179 VM_Warning(prog, "VM_entityfielddata: %s: field index out of bounds\n", prog->name);
2180 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2184 d = &prog->fielddefs[i];
2187 ent = PRVM_G_EDICT(OFS_PARM1);
2190 VM_Warning(prog, "VM_entityfielddata: %s: entity %i is free !\n", prog->name, PRVM_NUM_FOR_EDICT(ent));
2191 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
2195 // parse the string into the value
2196 PRVM_G_FLOAT(OFS_RETURN) = ( PRVM_ED_ParseEpair(prog, ent, d, PRVM_G_STRING(OFS_PARM2), false) ) ? 1.0f : 0.0f;
2203 float strlen(string s)
2206 //float(string s) strlen = #114; // returns how many characters are in a string
2207 void VM_strlen(prvm_prog_t *prog)
2209 VM_SAFEPARMCOUNT(1,VM_strlen);
2211 //PRVM_G_FLOAT(OFS_RETURN) = strlen(PRVM_G_STRING(OFS_PARM0));
2212 PRVM_G_FLOAT(OFS_RETURN) = u8_strlen(PRVM_G_STRING(OFS_PARM0));
2215 // DRESK - Decolorized String
2220 string strdecolorize(string s)
2223 // string (string s) strdecolorize = #472; // returns the passed in string with color codes stripped
2224 void VM_strdecolorize(prvm_prog_t *prog)
2226 char szNewString[VM_STRINGTEMP_LENGTH];
2227 const char *szString;
2230 VM_SAFEPARMCOUNT(1,VM_strdecolorize);
2231 szString = PRVM_G_STRING(OFS_PARM0);
2232 COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), true);
2233 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2236 // DRESK - String Length (not counting color codes)
2241 float strlennocol(string s)
2244 // float(string s) strlennocol = #471; // returns how many characters are in a string not including color codes
2245 // For example, ^2Dresk returns a length of 5
2246 void VM_strlennocol(prvm_prog_t *prog)
2248 const char *szString;
2251 VM_SAFEPARMCOUNT(1,VM_strlennocol);
2253 szString = PRVM_G_STRING(OFS_PARM0);
2255 //nCnt = (int)COM_StringLengthNoColors(szString, 0, NULL);
2256 nCnt = (int)u8_COM_StringLengthNoColors(szString, 0, NULL);
2258 PRVM_G_FLOAT(OFS_RETURN) = nCnt;
2261 // DRESK - String to Uppercase and Lowercase
2266 string strtolower(string s)
2269 // string (string s) strtolower = #480; // returns passed in string in lowercase form
2270 void VM_strtolower(prvm_prog_t *prog)
2272 char szNewString[VM_STRINGTEMP_LENGTH];
2273 const char *szString;
2276 VM_SAFEPARMCOUNT(1,VM_strtolower);
2277 szString = PRVM_G_STRING(OFS_PARM0);
2279 COM_ToLowerString(szString, szNewString, sizeof(szNewString) );
2281 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2288 string strtoupper(string s)
2291 // string (string s) strtoupper = #481; // returns passed in string in uppercase form
2292 void VM_strtoupper(prvm_prog_t *prog)
2294 char szNewString[VM_STRINGTEMP_LENGTH];
2295 const char *szString;
2298 VM_SAFEPARMCOUNT(1,VM_strtoupper);
2299 szString = PRVM_G_STRING(OFS_PARM0);
2301 COM_ToUpperString(szString, szNewString, sizeof(szNewString) );
2303 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, szNewString);
2310 string strcat(string,string,...[string])
2313 //string(string s1, string s2) strcat = #115;
2314 // concatenates two strings (for example "abc", "def" would return "abcdef")
2315 // and returns as a tempstring
2316 void VM_strcat(prvm_prog_t *prog)
2318 char s[VM_STRINGTEMP_LENGTH];
2319 VM_SAFEPARMCOUNTRANGE(1, 8, VM_strcat);
2321 VM_VarString(prog, 0, s, sizeof(s));
2322 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, s);
2329 string substring(string s, float start, float length)
2332 // string(string s, float start, float length) substring = #116;
2333 // returns a section of a string as a tempstring
2334 void VM_substring(prvm_prog_t *prog)
2337 int u_slength = 0, u_start;
2340 char string[VM_STRINGTEMP_LENGTH];
2342 VM_SAFEPARMCOUNT(3,VM_substring);
2345 s = PRVM_G_STRING(OFS_PARM0);
2346 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2347 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2348 slength = strlen(s);
2350 if (start < 0) // FTE_STRINGS feature
2352 start = bound(0, start, slength);
2354 if (length < 0) // FTE_STRINGS feature
2355 length += slength - start + 1;
2356 maxlen = min((int)sizeof(string) - 1, slength - start);
2357 length = bound(0, length, maxlen);
2359 memcpy(string, s + start, length);
2361 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2364 s = PRVM_G_STRING(OFS_PARM0);
2365 start = (int)PRVM_G_FLOAT(OFS_PARM1);
2366 length = (int)PRVM_G_FLOAT(OFS_PARM2);
2368 if (start < 0) // FTE_STRINGS feature
2370 u_slength = (int)u8_strlen(s);
2372 start = bound(0, start, u_slength);
2375 if (length < 0) // FTE_STRINGS feature
2377 if (!u_slength) // it's not calculated when it's not needed above
2378 u_slength = (int)u8_strlen(s);
2379 length += u_slength - start + 1;
2382 // positive start, positive length
2383 u_start = u8_byteofs(s, start, NULL);
2386 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, "");
2389 u_length = u8_bytelen(s + u_start, length);
2390 if (u_length >= sizeof(string)-1)
2391 u_length = sizeof(string)-1;
2393 memcpy(string, s + u_start, u_length);
2394 string[u_length] = 0;
2395 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2402 string(string search, string replace, string subject) strreplace = #484;
2405 // replaces all occurrences of search with replace in the string subject, and returns the result
2406 void VM_strreplace(prvm_prog_t *prog)
2409 const char *search, *replace, *subject;
2410 char string[VM_STRINGTEMP_LENGTH];
2411 int search_len, replace_len, subject_len;
2413 VM_SAFEPARMCOUNT(3,VM_strreplace);
2415 search = PRVM_G_STRING(OFS_PARM0);
2416 replace = PRVM_G_STRING(OFS_PARM1);
2417 subject = PRVM_G_STRING(OFS_PARM2);
2419 search_len = (int)strlen(search);
2420 replace_len = (int)strlen(replace);
2421 subject_len = (int)strlen(subject);
2424 for (i = 0; i <= subject_len - search_len; i++)
2426 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2427 if (subject[i+j] != search[j])
2429 if (j == search_len)
2431 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2432 // found it at offset 'i'
2433 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2434 string[si++] = replace[j];
2437 i += search_len - 1;
2441 // the above would subtract 1 from i... so we
2442 // don't do that, but instead output the next
2444 if (si < (int)sizeof(string) - 1)
2445 string[si++] = subject[i];
2450 // in THIS case, we know search_len > 0, thus i < subject_len
2452 if (si < (int)sizeof(string) - 1)
2453 string[si++] = subject[i];
2456 // remaining chars (these cannot match)
2457 for (; i < subject_len; i++)
2458 if (si < (int)sizeof(string) - 1)
2459 string[si++] = subject[i];
2462 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2469 string(string search, string replace, string subject) strireplace = #485;
2472 // case-insensitive version of strreplace
2473 void VM_strireplace(prvm_prog_t *prog)
2476 const char *search, *replace, *subject;
2477 char string[VM_STRINGTEMP_LENGTH];
2478 int search_len, replace_len, subject_len;
2480 VM_SAFEPARMCOUNT(3, VM_strireplace);
2482 search = PRVM_G_STRING(OFS_PARM0);
2483 replace = PRVM_G_STRING(OFS_PARM1);
2484 subject = PRVM_G_STRING(OFS_PARM2);
2486 search_len = (int)strlen(search);
2487 replace_len = (int)strlen(replace);
2488 subject_len = (int)strlen(subject);
2491 for (i = 0; i <= subject_len - search_len; i++)
2493 for (j = 0; j < search_len; j++) // thus, i+j < subject_len
2494 if (tolower(subject[i+j]) != tolower(search[j]))
2496 if (j == search_len)
2498 // NOTE: if search_len == 0, we always hit THIS case, and never the other
2499 // found it at offset 'i'
2500 for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2501 string[si++] = replace[j];
2504 i += search_len - 1;
2508 // the above would subtract 1 from i... so we
2509 // don't do that, but instead output the next
2511 if (si < (int)sizeof(string) - 1)
2512 string[si++] = subject[i];
2517 // in THIS case, we know search_len > 0, thus i < subject_len
2519 if (si < (int)sizeof(string) - 1)
2520 string[si++] = subject[i];
2523 // remaining chars (these cannot match)
2524 for (; i < subject_len; i++)
2525 if (si < (int)sizeof(string) - 1)
2526 string[si++] = subject[i];
2529 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, string);
2536 vector stov(string s)
2539 //vector(string s) stov = #117; // returns vector value from a string
2540 void VM_stov(prvm_prog_t *prog)
2542 char string[VM_STRINGTEMP_LENGTH];
2544 VM_SAFEPARMCOUNT(1,VM_stov);
2546 VM_VarString(prog, 0, string, sizeof(string));
2547 Math_atov(string, PRVM_G_VECTOR(OFS_RETURN));
2554 string strzone(string s)
2557 //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)
2558 void VM_strzone(prvm_prog_t *prog)
2561 char string[VM_STRINGTEMP_LENGTH];
2564 VM_SAFEPARMCOUNT(1,VM_strzone);
2566 VM_VarString(prog, 0, string, sizeof(string));
2567 alloclen = strlen(string) + 1;
2568 PRVM_G_INT(OFS_RETURN) = PRVM_AllocString(prog, alloclen, &out);
2569 memcpy(out, string, alloclen);
2579 //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!!!)
2580 void VM_strunzone(prvm_prog_t *prog)
2582 VM_SAFEPARMCOUNT(1,VM_strunzone);
2583 PRVM_FreeString(prog, PRVM_G_INT(OFS_PARM0));
2590 float tokenize(string s)
2593 //float(string s) tokenize = #441; // takes apart a string into individal words (access them with argv), returns how many
2594 //this function originally written by KrimZon, made shorter by LadyHavoc
2595 //20040203: rewritten by LadyHavoc (no longer uses allocations)
2596 static int num_tokens = 0;
2597 static int tokens[VM_STRINGTEMP_LENGTH / 2];
2598 static int tokens_startpos[VM_STRINGTEMP_LENGTH / 2];
2599 static int tokens_endpos[VM_STRINGTEMP_LENGTH / 2];
2600 static char tokenize_string[VM_STRINGTEMP_LENGTH];
2601 void VM_tokenize (prvm_prog_t *prog)
2605 VM_SAFEPARMCOUNT(1,VM_tokenize);
2607 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2608 p = tokenize_string;
2613 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2616 // skip whitespace here to find token start pos
2617 while(*p && ISWHITESPACE(*p))
2620 tokens_startpos[num_tokens] = p - tokenize_string;
2621 if(!COM_ParseToken_VM_Tokenize(&p, false))
2623 tokens_endpos[num_tokens] = p - tokenize_string;
2624 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2628 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2631 //float(string s) tokenize = #514; // takes apart a string into individal words (access them with argv), returns how many
2632 void VM_tokenize_console (prvm_prog_t *prog)
2636 VM_SAFEPARMCOUNT(1, VM_tokenize_console);
2638 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2639 p = tokenize_string;
2644 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2647 // skip whitespace here to find token start pos
2648 while(*p && ISWHITESPACE(*p))
2651 tokens_startpos[num_tokens] = p - tokenize_string;
2652 if(!COM_ParseToken_Console(&p))
2654 tokens_endpos[num_tokens] = p - tokenize_string;
2655 tokens[num_tokens] = PRVM_SetTempString(prog, com_token);
2659 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2664 VM_tokenizebyseparator
2666 float tokenizebyseparator(string s, string separator1, ...)
2669 //float(string s, string separator1, ...) tokenizebyseparator = #479; // takes apart a string into individal words (access them with argv), returns how many
2670 //this function returns the token preceding each instance of a separator (of
2671 //which there can be multiple), and the text following the last separator
2672 //useful for parsing certain kinds of data like IP addresses
2674 //numnumbers = tokenizebyseparator("10.1.2.3", ".");
2675 //returns 4 and the tokens "10" "1" "2" "3".
2676 void VM_tokenizebyseparator (prvm_prog_t *prog)
2680 int separatorlen[7];
2681 const char *separators[7];
2684 char tokentext[MAX_INPUTLINE];
2686 VM_SAFEPARMCOUNTRANGE(2, 8,VM_tokenizebyseparator);
2688 strlcpy(tokenize_string, PRVM_G_STRING(OFS_PARM0), sizeof(tokenize_string));
2689 p = tokenize_string;
2692 for (j = 1;j < prog->argc;j++)
2694 // skip any blank separator strings
2695 const char *s = PRVM_G_STRING(OFS_PARM0+j*3);
2698 separators[numseparators] = s;
2699 separatorlen[numseparators] = (int)strlen(s);
2706 while (num_tokens < (int)(sizeof(tokens)/sizeof(tokens[0])))
2708 token = tokentext + j;
2709 tokens_startpos[num_tokens] = p - tokenize_string;
2713 for (k = 0;k < numseparators;k++)
2715 if (!strncmp(p, separators[k], separatorlen[k]))
2717 p += separatorlen[k];
2721 if (k < numseparators)
2723 if (j < (int)sizeof(tokentext)-1)
2724 tokentext[j++] = *p;
2728 tokens_endpos[num_tokens] = p0 - tokenize_string;
2729 if (j >= (int)sizeof(tokentext))
2732 tokens[num_tokens++] = PRVM_SetTempString(prog, token);
2737 PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2740 //string(float n) argv = #442; // returns a word from the tokenized string (returns nothing for an invalid index)
2741 //this function originally written by KrimZon, made shorter by LadyHavoc
2742 void VM_argv (prvm_prog_t *prog)
2746 VM_SAFEPARMCOUNT(1,VM_argv);
2748 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2751 token_num += num_tokens;
2753 if (token_num >= 0 && token_num < num_tokens)
2754 PRVM_G_INT(OFS_RETURN) = tokens[token_num];
2756 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2759 //float(float n) argv_start_index = #515; // returns the start index of a token
2760 void VM_argv_start_index (prvm_prog_t *prog)
2764 VM_SAFEPARMCOUNT(1,VM_argv);
2766 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2769 token_num += num_tokens;
2771 if (token_num >= 0 && token_num < num_tokens)
2772 PRVM_G_FLOAT(OFS_RETURN) = tokens_startpos[token_num];
2774 PRVM_G_FLOAT(OFS_RETURN) = -1;
2777 //float(float n) argv_end_index = #516; // returns the end index of a token
2778 void VM_argv_end_index (prvm_prog_t *prog)
2782 VM_SAFEPARMCOUNT(1,VM_argv);
2784 token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2787 token_num += num_tokens;
2789 if (token_num >= 0 && token_num < num_tokens)
2790 PRVM_G_FLOAT(OFS_RETURN) = tokens_endpos[token_num];
2792 PRVM_G_FLOAT(OFS_RETURN) = -1;
2802 void VM_isserver(prvm_prog_t *prog)
2804 VM_SAFEPARMCOUNT(0, VM_isserver);
2806 PRVM_G_FLOAT(OFS_RETURN) = sv.active;
2816 void VM_clientcount(prvm_prog_t *prog)
2818 VM_SAFEPARMCOUNT(0,VM_clientcount);
2820 PRVM_G_FLOAT(OFS_RETURN) = svs.maxclients;
2830 void VM_clientstate(prvm_prog_t *prog)
2832 VM_SAFEPARMCOUNT(0,VM_clientstate);
2835 switch( cls.state ) {
2836 case ca_uninitialized:
2838 PRVM_G_FLOAT(OFS_RETURN) = 0;
2840 case ca_disconnected:
2841 PRVM_G_FLOAT(OFS_RETURN) = 1;
2844 PRVM_G_FLOAT(OFS_RETURN) = 2;
2847 // should never be reached!
2856 float getostype(prvm_prog_t *prog)
2858 */ // not used at the moment -> not included in the common list
2859 void VM_getostype(prvm_prog_t *prog)
2861 VM_SAFEPARMCOUNT(0,VM_getostype);
2866 OS_MAC - not supported
2870 PRVM_G_FLOAT(OFS_RETURN) = 0;
2871 #elif defined(MACOSX)
2872 PRVM_G_FLOAT(OFS_RETURN) = 2;
2874 PRVM_G_FLOAT(OFS_RETURN) = 1;
2882 float gettime(prvm_prog_t *prog)
2885 float CDAudio_GetPosition(void);
2886 void VM_gettime(prvm_prog_t *prog)
2890 VM_SAFEPARMCOUNTRANGE(0,1,VM_gettime);
2894 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t) host.realtime;
2898 timer_index = (int) PRVM_G_FLOAT(OFS_PARM0);
2901 case 0: // GETTIME_FRAMESTART
2902 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2904 case 1: // GETTIME_REALTIME
2905 PRVM_G_FLOAT(OFS_RETURN) = Sys_DirtyTime();
2907 case 2: // GETTIME_HIRES
2908 PRVM_G_FLOAT(OFS_RETURN) = (Sys_DirtyTime() - host.dirtytime);
2910 case 3: // GETTIME_UPTIME
2911 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2913 case 4: // GETTIME_CDTRACK
2914 PRVM_G_FLOAT(OFS_RETURN) = CDAudio_GetPosition();
2917 VM_Warning(prog, "VM_gettime: %s: unsupported timer specified, returning realtime\n", prog->name);
2918 PRVM_G_FLOAT(OFS_RETURN) = host.realtime;
2928 float getsoundtime(prvm_prog_t *prog)
2932 void VM_getsoundtime (prvm_prog_t *prog)
2934 int entnum, entchannel;
2935 VM_SAFEPARMCOUNT(2,VM_getsoundtime);
2937 if (prog == SVVM_prog)
2938 entnum = PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2939 else if (prog == CLVM_prog)
2940 entnum = MAX_EDICTS + PRVM_NUM_FOR_EDICT(PRVM_G_EDICT(OFS_PARM0));
2943 VM_Warning(prog, "VM_getsoundtime: %s: not supported on this progs\n", prog->name);
2944 PRVM_G_FLOAT(OFS_RETURN) = -1;
2947 entchannel = (int)PRVM_G_FLOAT(OFS_PARM1);
2948 entchannel = CHAN_USER2ENGINE(entchannel);
2949 if (!IS_CHAN(entchannel))
2950 VM_Warning(prog, "VM_getsoundtime: %s: bad channel %i\n", prog->name, entchannel);
2951 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t)S_GetEntChannelPosition(entnum, entchannel);
2958 string soundlength (string sample)
2961 void VM_soundlength (prvm_prog_t *prog)
2965 VM_SAFEPARMCOUNT(1, VM_soundlength);
2967 s = PRVM_G_STRING(OFS_PARM0);
2968 PRVM_G_FLOAT(OFS_RETURN) = S_SoundLength(s);
2975 loadfromdata(string data)
2978 void VM_loadfromdata(prvm_prog_t *prog)
2980 VM_SAFEPARMCOUNT(1, VM_loadfromdata);
2982 PRVM_ED_LoadFromFile(prog, PRVM_G_STRING(OFS_PARM0));
2986 ========================
2989 parseentitydata(entity ent, string data)
2990 ========================
2992 void VM_parseentitydata(prvm_prog_t *prog)
2997 VM_SAFEPARMCOUNT(2, VM_parseentitydata);
2999 // get edict and test it
3000 ent = PRVM_G_EDICT(OFS_PARM0);
3002 prog->error_cmd("VM_parseentitydata: %s: Can only set already spawned entities (entity %i is free)!", prog->name, PRVM_NUM_FOR_EDICT(ent));
3004 data = PRVM_G_STRING(OFS_PARM1);
3006 // parse the opening brace
3007 if (!COM_ParseToken_Simple(&data, false, false, true) || com_token[0] != '{' )
3008 prog->error_cmd("VM_parseentitydata: %s: Couldn't parse entity data:\n%s", prog->name, data );
3010 PRVM_ED_ParseEdict (prog, data, ent);
3017 loadfromfile(string file)
3020 void VM_loadfromfile(prvm_prog_t *prog)
3022 const char *filename;
3025 VM_SAFEPARMCOUNT(1,VM_loadfromfile);
3027 filename = PRVM_G_STRING(OFS_PARM0);
3028 if (FS_CheckNastyPath(filename, false))
3030 PRVM_G_FLOAT(OFS_RETURN) = -4;
3031 VM_Warning(prog, "VM_loadfromfile: %s dangerous or non-portable filename \"%s\" not allowed. (contains : or \\ or begins with .. or /)\n", prog->name, filename);
3035 // not conform with VM_fopen
3036 data = (char *)FS_LoadFile(filename, tempmempool, false, NULL);
3038 PRVM_G_FLOAT(OFS_RETURN) = -1;
3040 PRVM_ED_LoadFromFile(prog, data);
3051 float mod(float val, float m)
3054 void VM_modulo(prvm_prog_t *prog)
3057 VM_SAFEPARMCOUNT(2, VM_modulo);
3059 val = (prvm_int_t) PRVM_G_FLOAT(OFS_PARM0);
3060 m = (prvm_int_t) PRVM_G_FLOAT(OFS_PARM1);
3062 PRVM_G_FLOAT(OFS_RETURN) = (prvm_vec_t) (val % m);
3065 static void VM_Search_Init(prvm_prog_t *prog)
3068 for (i = 0;i < PRVM_MAX_OPENSEARCHES;i++)
3069 prog->opensearches[i] = NULL;
3072 static void VM_Search_Reset(prvm_prog_t *prog)
3075 // reset the fssearch list
3076 for(i = 0; i < PRVM_MAX_OPENSEARCHES; i++)
3078 if(prog->opensearches[i])
3079 FS_FreeSearch(prog->opensearches[i]);
3080 prog->opensearches[i] = NULL;
3088 float search_begin(string pattern, float caseinsensitive, float quiet[, string packfile])
3091 void VM_search_begin(prvm_prog_t *prog)
3094 const char *packfile = NULL, *pattern;
3095 int caseinsens, quiet;
3097 VM_SAFEPARMCOUNTRANGE(3, 4, VM_search_begin);
3099 pattern = PRVM_G_STRING(OFS_PARM0);
3101 VM_CheckEmptyString(prog, pattern);
3103 caseinsens = (int)PRVM_G_FLOAT(OFS_PARM1);
3104 quiet = (int)PRVM_G_FLOAT(OFS_PARM2);
3106 // optional packfile parameter (DP_QC_FS_SEARCH_PACKFILE)
3108 packfile = PRVM_G_STRING(OFS_PARM3);
3110 for(handle = 0; handle < PRVM_MAX_OPENSEARCHES; handle++)
3111 if(!prog->opensearches[handle])
3114 if(handle >= PRVM_MAX_OPENSEARCHES)
3116 PRVM_G_FLOAT(OFS_RETURN) = -2;
3117 VM_Warning(prog, "VM_search_begin: %s ran out of search handles (%i)\n", prog->name, PRVM_MAX_OPENSEARCHES);
3121 if(!(prog->opensearches[handle] = FS_Search(pattern,caseinsens, quiet, packfile)))
3122 PRVM_G_FLOAT(OFS_RETURN) = -1;
3125 prog->opensearches_origin[handle] = PRVM_AllocationOrigin(prog);
3126 PRVM_G_FLOAT(OFS_RETURN) = handle;
3134 void search_end(float handle)
3137 void VM_search_end(prvm_prog_t *prog)
3140 VM_SAFEPARMCOUNT(1, VM_search_end);
3142 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3144 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3146 VM_Warning(prog, "VM_search_end: invalid handle %i used in %s\n", handle, prog->name);
3149 if(prog->opensearches[handle] == NULL)
3151 VM_Warning(prog, "VM_search_end: no such handle %i in %s\n", handle, prog->name);
3155 FS_FreeSearch(prog->opensearches[handle]);
3156 prog->opensearches[handle] = NULL;
3157 if(prog->opensearches_origin[handle])
3158 PRVM_Free((char *)prog->opensearches_origin[handle]);
3165 float search_getsize(float handle)
3168 void VM_search_getsize(prvm_prog_t *prog)
3171 VM_SAFEPARMCOUNT(1, VM_search_getsize);
3173 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3175 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3177 VM_Warning(prog, "VM_search_getsize: invalid handle %i used in %s\n", handle, prog->name);
3180 if(prog->opensearches[handle] == NULL)
3182 VM_Warning(prog, "VM_search_getsize: no such handle %i in %s\n", handle, prog->name);
3186 PRVM_G_FLOAT(OFS_RETURN) = prog->opensearches[handle]->numfilenames;
3191 VM_search_getfilename
3193 string search_getfilename(float handle, float num)
3196 void VM_search_getfilename(prvm_prog_t *prog)
3198 int handle, filenum;
3199 VM_SAFEPARMCOUNT(2, VM_search_getfilename);
3201 handle = (int)PRVM_G_FLOAT(OFS_PARM0);
3202 filenum = (int)PRVM_G_FLOAT(OFS_PARM1);
3204 if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
3206 VM_Warning(prog, "VM_search_getfilename: invalid handle %i used in %s\n", handle, prog->name);
3209 if(prog->opensearches[handle] == NULL)
3211 VM_Warning(prog, "VM_search_getfilename: no such handle %i in %s\n", handle, prog->name);
3214 if(filenum < 0 || filenum >= prog->opensearches[handle]->numfilenames)
3216 VM_Warning(prog, "VM_search_getfilename: invalid filenum %i in %s\n", filenum, prog->name);
3220 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, prog->opensearches[handle]->filenames[filenum]);
3227 string chr(float ascii)
3230 void VM_chr(prvm_prog_t *prog)
3234 VM_SAFEPARMCOUNT(1, VM_chr);
3236 tmp[0] = (unsigned char) PRVM_G_FLOAT(OFS_PARM0);
3239 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3244 VM_SAFEPARMCOUNT(1, VM_chr);
3246 len = u8_fromchar((Uchar)PRVM_G_FLOAT(OFS_PARM0), tmp, sizeof(tmp));
3248 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, tmp);
3255 string keynumtostring(float keynum)
3258 void VM_keynumtostring (prvm_prog_t *prog)
3261 VM_SAFEPARMCOUNT(1, VM_keynumtostring);
3263 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_KeynumToString((int)PRVM_G_FLOAT(OFS_PARM0), tinystr, sizeof(tinystr)));
3268 VM_findkeysforcommand
3270 string findkeysforcommand(string command, float bindmap)
3272 the returned string is an altstring
3275 #define FKFC_NUMKEYS 5
3276 void M_FindKeysForCommand(const char *command, int *keys);
3277 void VM_findkeysforcommand(prvm_prog_t *prog)
3280 char ret[VM_STRINGTEMP_LENGTH];
3281 int keys[FKFC_NUMKEYS];
3286 VM_SAFEPARMCOUNTRANGE(1, 2, VM_findkeysforcommand);
3288 cmd = PRVM_G_STRING(OFS_PARM0);
3290 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
3292 bindmap = 0; // consistent to "bind"
3294 VM_CheckEmptyString(prog, cmd);
3296 Key_FindKeysForCommand(cmd, keys, FKFC_NUMKEYS, bindmap);
3299 for(i = 0; i < FKFC_NUMKEYS; i++)
3300 strlcat(ret, va(vabuf, sizeof(vabuf), " \'%i\'", keys[i]), sizeof(ret));
3302 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, ret);
3309 float stringtokeynum(string key)
3312 void VM_stringtokeynum (prvm_prog_t *prog)
3314 VM_SAFEPARMCOUNT( 1, VM_stringtokeynum );
3316 PRVM_G_FLOAT(OFS_RETURN) = Key_StringToKeynum(PRVM_G_STRING(OFS_PARM0));
3323 string getkeybind(float key, float bindmap)
3326 void VM_getkeybind (prvm_prog_t *prog)
3329 VM_SAFEPARMCOUNTRANGE(1, 2, VM_getkeybind);
3331 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM1), MAX_BINDMAPS-1);
3333 bindmap = 0; // consistent to "bind"
3335 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, Key_GetBind((int)PRVM_G_FLOAT(OFS_PARM0), bindmap));
3342 float setkeybind(float key, string cmd, float bindmap)
3345 void VM_setkeybind (prvm_prog_t *prog)
3348 VM_SAFEPARMCOUNTRANGE(2, 3, VM_setkeybind);
3350 bindmap = bound(-1, PRVM_G_FLOAT(OFS_PARM2), MAX_BINDMAPS-1);
3352 bindmap = 0; // consistent to "bind"
3354 PRVM_G_FLOAT(OFS_RETURN) = 0;
3355 if(Key_SetBinding((int)PRVM_G_FLOAT(OFS_PARM0), bindmap, PRVM_G_STRING(OFS_PARM1)))
3356 PRVM_G_FLOAT(OFS_RETURN) = 1;
3363 vector getbindmaps()
3366 void VM_getbindmaps (prvm_prog_t *prog)
3369 VM_SAFEPARMCOUNT(0, VM_getbindmaps);
3370 Key_GetBindMap(&fg, &bg);
3371 PRVM_G_VECTOR(OFS_RETURN)[0] = fg;
3372 PRVM_G_VECTOR(OFS_RETURN)[1] = bg;
3373 PRVM_G_VECTOR(OFS_RETURN)[2] = 0;
3380 float setbindmaps(vector bindmap)
3383 void VM_setbindmaps (prvm_prog_t *prog)
3385 VM_SAFEPARMCOUNT(1, VM_setbindmaps);
3386 PRVM_G_FLOAT(OFS_RETURN) = 0;
3387 if(PRVM_G_VECTOR(OFS_PARM0)[2] == 0)
3388 if(Key_SetBindMap((int)PRVM_G_VECTOR(OFS_PARM0)[0], (int)PRVM_G_VECTOR(OFS_PARM0)[1]))
3389 PRVM_G_FLOAT(OFS_RETURN) = 1;
3393 ========================
3396 float[bool] gecko_create( string name )
3397 ========================
3399 void VM_gecko_create(prvm_prog_t *prog) {
3401 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3405 ========================
3408 void gecko_destroy( string name )
3409 ========================
3411 void VM_gecko_destroy(prvm_prog_t *prog) {
3416 ========================
3419 void gecko_navigate( string name, string URI )
3420 ========================
3422 void VM_gecko_navigate(prvm_prog_t *prog) {
3427 ========================
3430 float[bool] gecko_keyevent( string name, float key, float eventtype )
3431 ========================
3433 void VM_gecko_keyevent(prvm_prog_t *prog) {
3435 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3439 ========================
3442 void gecko_mousemove( string name, float x, float y )
3443 ========================
3445 void VM_gecko_movemouse(prvm_prog_t *prog) {
3451 ========================
3454 void gecko_resize( string name, float w, float h )
3455 ========================
3457 void VM_gecko_resize(prvm_prog_t *prog) {
3463 ========================
3464 VM_gecko_get_texture_extent
3466 vector gecko_get_texture_extent( string name )
3467 ========================
3469 void VM_gecko_get_texture_extent(prvm_prog_t *prog) {
3471 PRVM_G_VECTOR(OFS_RETURN)[0] = 0;
3472 PRVM_G_VECTOR(OFS_RETURN)[1] = 0;
3481 Writes new values for v_forward, v_up, and v_right based on angles
3482 void makevectors(vector angle)
3485 void VM_makevectors (prvm_prog_t *prog)
3487 vec3_t angles, forward, right, up;
3488 VM_SAFEPARMCOUNT(1, VM_makevectors);
3489 VectorCopy(PRVM_G_VECTOR(OFS_PARM0), angles);
3490 AngleVectors(angles, forward, right, up);
3491 VectorCopy(forward, PRVM_gameglobalvector(v_forward));
3492 VectorCopy(right, PRVM_gameglobalvector(v_right));
3493 VectorCopy(up, PRVM_gameglobalvector(v_up));
3500 Writes new values for v_forward, v_up, and v_right based on the given forward vector
3501 vectorvectors(vector)
3504 void VM_vectorvectors (prvm_prog_t *prog)
3506 vec3_t forward, right, up;
3507 VM_SAFEPARMCOUNT(1, VM_vectorvectors);
3508 VectorNormalize2(PRVM_G_VECTOR(OFS_PARM0), forward);
3509 VectorVectors(forward, right, up);
3510 VectorCopy(forward, PRVM_gameglobalvector(v_forward));
3511 VectorCopy(right, PRVM_gameglobalvector(v_right));
3512 VectorCopy(up, PRVM_gameglobalvector(v_up));
3515 // float(float number, float quantity) bitshift (EXT_BITSHIFT)
3516 void VM_bitshift (prvm_prog_t *prog)
3519 VM_SAFEPARMCOUNT(2, VM_bitshift);
3521 n1 = (prvm_int_t)fabs((prvm_vec_t)((prvm_int_t)PRVM_G_FLOAT(OFS_PARM0)));
3522 n2 = (prvm_int_t)PRVM_G_FLOAT(OFS_PARM1);
3524 PRVM_G_FLOAT(OFS_RETURN) = n1;
3527 PRVM_G_FLOAT(OFS_RETURN) = (n1 >> -n2);
3529 PRVM_G_FLOAT(OFS_RETURN) = (n1 << n2);
3532 ////////////////////////////////////////
3533 // AltString functions
3534 ////////////////////////////////////////
3537 ========================
3540 float altstr_count(string)
3541 ========================
3543 void VM_altstr_count(prvm_prog_t *prog)
3545 const char *altstr, *pos;
3548 VM_SAFEPARMCOUNT( 1, VM_altstr_count );
3550 altstr = PRVM_G_STRING( OFS_PARM0 );
3551 //VM_CheckEmptyString(prog, altstr );
3553 for( count = 0, pos = altstr ; *pos ; pos++ ) {
3554 if( *pos == '\\' ) {
3558 } else if( *pos == '\'' ) {
3563 PRVM_G_FLOAT( OFS_RETURN ) = (prvm_vec_t) (count / 2);
3567 ========================
3570 string altstr_prepare(string)
3571 ========================
3573 void VM_altstr_prepare(prvm_prog_t *prog)
3575 const char *instr, *in;
3576 char outstr[VM_STRINGTEMP_LENGTH];
3579 VM_SAFEPARMCOUNT( 1, VM_altstr_prepare );
3581 instr = PRVM_G_STRING( OFS_PARM0 );
3583 for (in = instr, outpos = 0; *in && outpos < sizeof(outstr) - 1; ++in)
3585 if (*in == '\'' && outpos < sizeof(outstr) - 2)
3587 outstr[outpos++] = '\\';
3588 outstr[outpos++] = '\'';
3591 outstr[outpos++] = *in;
3595 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3599 ========================
3602 string altstr_get(string, float)
3603 ========================
3605 void VM_altstr_get(prvm_prog_t *prog)
3607 const char *altstr, *pos;
3610 char outstr[VM_STRINGTEMP_LENGTH];
3612 VM_SAFEPARMCOUNT( 2, VM_altstr_get );
3614 altstr = PRVM_G_STRING( OFS_PARM0 );
3616 count = (int)PRVM_G_FLOAT( OFS_PARM1 );
3617 count = count * 2 + 1;
3619 for( pos = altstr ; *pos && count ; pos++ )
3620 if( *pos == '\\' ) {
3623 } else if( *pos == '\'' )
3627 PRVM_G_INT( OFS_RETURN ) = 0;
3631 for( out = outstr, size = sizeof(outstr) - 1 ; size && *pos ; size--, pos++, out++ )
3632 if( *pos == '\\' ) {
3637 } else if( *pos == '\'' )
3643 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3647 ========================
3650 string altstr_set(string altstr, float num, string set)
3651 ========================
3653 void VM_altstr_set(prvm_prog_t *prog)
3656 const char *altstr, *str;
3659 char outstr[VM_STRINGTEMP_LENGTH];
3661 VM_SAFEPARMCOUNT( 3, VM_altstr_set );
3663 altstr = PRVM_G_STRING( OFS_PARM0 );
3665 num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3667 str = PRVM_G_STRING( OFS_PARM2 );
3670 for( num = num * 2 + 1, in = altstr; *in && num; *out++ = *in++ )
3675 } else if( *in == '\'' ) {
3680 for( ; *str; *out++ = *str++ );
3681 // now jump over the old content
3683 if( *in == '\'' || (*in == '\\' && !*++in) )
3686 strlcpy(out, in, outstr + sizeof(outstr) - out);
3687 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3691 ========================
3694 string altstr_ins(string altstr, float num, string set)
3695 ========================
3697 void VM_altstr_ins(prvm_prog_t *prog)
3703 char outstr[VM_STRINGTEMP_LENGTH];
3705 VM_SAFEPARMCOUNT(3, VM_altstr_ins);
3707 in = PRVM_G_STRING( OFS_PARM0 );
3708 num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3709 set = PRVM_G_STRING( OFS_PARM2 );
3712 for( num = num * 2 + 2 ; *in && num > 0 ; *out++ = *in++ )
3717 } else if( *in == '\'' ) {
3722 for( ; *set ; *out++ = *set++ );
3725 strlcpy(out, in, outstr + sizeof(outstr) - out);
3726 PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString(prog, outstr );
3730 ////////////////////////////////////////
3731 // BufString functions
3732 ////////////////////////////////////////
3733 //[515]: string buffers support
3735 static size_t stringbuffers_sortlength;
3737 static void BufStr_Expand(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer, int strindex)
3739 if (stringbuffer->max_strings <= strindex)
3741 char **oldstrings = stringbuffer->strings;
3742 stringbuffer->max_strings = max(stringbuffer->max_strings * 2, 128);
3743 while (stringbuffer->max_strings <= strindex)
3744 stringbuffer->max_strings *= 2;
3745 stringbuffer->strings = (char **) Mem_Alloc(prog->progs_mempool, stringbuffer->max_strings * sizeof(stringbuffer->strings[0]));
3746 if (stringbuffer->num_strings > 0)
3747 memcpy(stringbuffer->strings, oldstrings, stringbuffer->num_strings * sizeof(stringbuffer->strings[0]));
3749 Mem_Free(oldstrings);
3753 static void BufStr_Shrink(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer)
3755 // reduce num_strings if there are empty string slots at the end
3756 while (stringbuffer->num_strings > 0 && stringbuffer->strings[stringbuffer->num_strings - 1] == NULL)
3757 stringbuffer->num_strings--;
3759 // if empty, free the string pointer array
3760 if (stringbuffer->num_strings == 0)
3762 stringbuffer->max_strings = 0;
3763 if (stringbuffer->strings)
3764 Mem_Free(stringbuffer->strings);
3765 stringbuffer->strings = NULL;
3769 static int BufStr_SortStringsUP (const void *in1, const void *in2)
3772 a = *((const char **) in1);
3773 b = *((const char **) in2);
3774 if(!a || !a[0]) return 1;
3775 if(!b || !b[0]) return -1;
3776 return strncmp(a, b, stringbuffers_sortlength);
3779 static int BufStr_SortStringsDOWN (const void *in1, const void *in2)
3782 a = *((const char **) in1);
3783 b = *((const char **) in2);
3784 if(!a || !a[0]) return 1;
3785 if(!b || !b[0]) return -1;
3786 return strncmp(b, a, stringbuffers_sortlength);
3789 prvm_stringbuffer_t *BufStr_FindCreateReplace (prvm_prog_t *prog, int bufindex, int flags, const char *format)
3791 prvm_stringbuffer_t *stringbuffer;
3797 // find buffer with wanted index
3798 if (bufindex < (int)Mem_ExpandableArray_IndexRange(&prog->stringbuffersarray))
3800 if ( (stringbuffer = (prvm_stringbuffer_t*) Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, bufindex)) )
3802 if (stringbuffer->flags & STRINGBUFFER_TEMP)
3803 stringbuffer->flags = flags; // created but has not been used yet
3804 return stringbuffer;
3809 // allocate new buffer with wanted index
3812 stringbuffer = (prvm_stringbuffer_t *) Mem_ExpandableArray_AllocRecord(&prog->stringbuffersarray);
3813 stringbuffer->flags = STRINGBUFFER_TEMP;
3814 for (i = 0;stringbuffer != Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i);i++);
3817 stringbuffer->flags = flags; // mark as used
3821 return stringbuffer;
3824 void BufStr_Set(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer, int strindex, const char *str)
3828 if (!stringbuffer || strindex < 0)
3831 BufStr_Expand(prog, stringbuffer, strindex);
3832 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
3833 if (stringbuffer->strings[strindex])
3834 Mem_Free(stringbuffer->strings[strindex]);
3835 stringbuffer->strings[strindex] = NULL;
3839 // not the NULL string!
3840 alloclen = strlen(str) + 1;
3841 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
3842 memcpy(stringbuffer->strings[strindex], str, alloclen);
3845 BufStr_Shrink(prog, stringbuffer);
3848 void BufStr_Del(prvm_prog_t *prog, prvm_stringbuffer_t *stringbuffer)
3855 for (i = 0;i < stringbuffer->num_strings;i++)
3856 if (stringbuffer->strings[i])
3857 Mem_Free(stringbuffer->strings[i]);
3858 if (stringbuffer->strings)
3859 Mem_Free(stringbuffer->strings);
3860 if(stringbuffer->origin)
3861 PRVM_Free((char *)stringbuffer->origin);
3862 Mem_ExpandableArray_FreeRecord(&prog->stringbuffersarray, stringbuffer);
3865 void BufStr_Flush(prvm_prog_t *prog)
3867 prvm_stringbuffer_t *stringbuffer;
3870 numbuffers = (int)Mem_ExpandableArray_IndexRange(&prog->stringbuffersarray);
3871 for (i = 0; i < numbuffers; i++)
3872 if ( (stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i)) )
3873 BufStr_Del(prog, stringbuffer);
3874 Mem_ExpandableArray_NewArray(&prog->stringbuffersarray, prog->progs_mempool, sizeof(prvm_stringbuffer_t), 64);
3878 ========================
3880 creates new buffer, and returns it's index, returns -1 if failed
3881 float buf_create(prvm_prog_t *prog) = #460;
3882 float newbuf(string format, float flags) = #460;
3883 ========================
3886 void VM_buf_create (prvm_prog_t *prog)
3888 prvm_stringbuffer_t *stringbuffer;
3891 VM_SAFEPARMCOUNTRANGE(0, 2, VM_buf_create);
3893 // VorteX: optional parm1 (buffer format) is unfinished, to keep intact with future databuffers extension must be set to "string"
3894 if(prog->argc >= 1 && strcmp(PRVM_G_STRING(OFS_PARM0), "string"))
3896 PRVM_G_FLOAT(OFS_RETURN) = -1;
3899 stringbuffer = (prvm_stringbuffer_t *) Mem_ExpandableArray_AllocRecord(&prog->stringbuffersarray);
3900 for (i = 0;stringbuffer != Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i);i++);
3901 stringbuffer->origin = PRVM_AllocationOrigin(prog);
3902 // optional flags parm
3903 if (prog->argc >= 2)
3904 stringbuffer->flags = (int)PRVM_G_FLOAT(OFS_PARM1) & STRINGBUFFER_QCFLAGS;
3905 PRVM_G_FLOAT(OFS_RETURN) = i;
3911 ========================
3913 deletes buffer and all strings in it
3914 void buf_del(float bufhandle) = #461;
3915 ========================
3917 void VM_buf_del (prvm_prog_t *prog)
3919 prvm_stringbuffer_t *stringbuffer;
3920 VM_SAFEPARMCOUNT(1, VM_buf_del);
3921 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3923 BufStr_Del(prog, stringbuffer);
3926 VM_Warning(prog, "VM_buf_del: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3932 ========================
3934 how many strings are stored in buffer
3935 float buf_getsize(float bufhandle) = #462;
3936 ========================
3938 void VM_buf_getsize (prvm_prog_t *prog)
3940 prvm_stringbuffer_t *stringbuffer;
3941 VM_SAFEPARMCOUNT(1, VM_buf_getsize);
3943 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3946 PRVM_G_FLOAT(OFS_RETURN) = -1;
3947 VM_Warning(prog, "VM_buf_getsize: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3951 PRVM_G_FLOAT(OFS_RETURN) = stringbuffer->num_strings;
3955 ========================
3957 copy all content from one buffer to another, make sure it exists
3958 void buf_copy(float bufhandle_from, float bufhandle_to) = #463;
3959 ========================
3961 void VM_buf_copy (prvm_prog_t *prog)
3963 prvm_stringbuffer_t *srcstringbuffer, *dststringbuffer;
3965 VM_SAFEPARMCOUNT(2, VM_buf_copy);
3967 srcstringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3968 if(!srcstringbuffer)
3970 VM_Warning(prog, "VM_buf_copy: invalid source buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
3973 i = (int)PRVM_G_FLOAT(OFS_PARM1);
3974 if(i == (int)PRVM_G_FLOAT(OFS_PARM0))
3976 VM_Warning(prog, "VM_buf_copy: source == destination (%i) in %s\n", i, prog->name);
3979 dststringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3980 if(!dststringbuffer)
3982 VM_Warning(prog, "VM_buf_copy: invalid destination buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
3986 for (i = 0;i < dststringbuffer->num_strings;i++)
3987 if (dststringbuffer->strings[i])
3988 Mem_Free(dststringbuffer->strings[i]);
3989 if (dststringbuffer->strings)
3990 Mem_Free(dststringbuffer->strings);
3991 *dststringbuffer = *srcstringbuffer;
3992 if (dststringbuffer->max_strings)
3993 dststringbuffer->strings = (char **)Mem_Alloc(prog->progs_mempool, sizeof(dststringbuffer->strings[0]) * dststringbuffer->max_strings);
3995 for (i = 0;i < dststringbuffer->num_strings;i++)
3997 if (srcstringbuffer->strings[i])
4000 stringlen = strlen(srcstringbuffer->strings[i]) + 1;
4001 dststringbuffer->strings[i] = (char *)Mem_Alloc(prog->progs_mempool, stringlen);
4002 memcpy(dststringbuffer->strings[i], srcstringbuffer->strings[i], stringlen);
4008 ========================
4010 sort buffer by beginnings of strings (cmplength defaults it's length)
4011 "backward == true" means that sorting goes upside-down
4012 void buf_sort(float bufhandle, float cmplength, float backward) = #464;
4013 ========================
4015 void VM_buf_sort (prvm_prog_t *prog)
4017 prvm_stringbuffer_t *stringbuffer;
4018 VM_SAFEPARMCOUNT(3, VM_buf_sort);
4020 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4023 VM_Warning(prog, "VM_buf_sort: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4026 if(stringbuffer->num_strings <= 0)
4028 VM_Warning(prog, "VM_buf_sort: tried to sort empty buffer %i in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4031 stringbuffers_sortlength = (int)PRVM_G_FLOAT(OFS_PARM1);
4032 if(stringbuffers_sortlength <= 0)
4033 stringbuffers_sortlength = 0x7FFFFFFF;
4035 if(!PRVM_G_FLOAT(OFS_PARM2))
4036 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsUP);
4038 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsDOWN);
4040 BufStr_Shrink(prog, stringbuffer);
4044 ========================
4046 concantenates all buffer string into one with "glue" separator and returns it as tempstring
4047 string buf_implode(float bufhandle, string glue) = #465;
4048 ========================
4050 void VM_buf_implode (prvm_prog_t *prog)
4052 prvm_stringbuffer_t *stringbuffer;
4053 char k[VM_STRINGTEMP_LENGTH];
4057 VM_SAFEPARMCOUNT(2, VM_buf_implode);
4059 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4060 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4063 VM_Warning(prog, "VM_buf_implode: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4066 if(!stringbuffer->num_strings)
4068 sep = PRVM_G_STRING(OFS_PARM1);
4070 for(l = i = 0;i < stringbuffer->num_strings;i++)
4072 if(stringbuffer->strings[i])
4074 l += (i > 0 ? strlen(sep) : 0) + strlen(stringbuffer->strings[i]);
4075 if (l >= sizeof(k) - 1)
4077 strlcat(k, sep, sizeof(k));
4078 strlcat(k, stringbuffer->strings[i], sizeof(k));
4081 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, k);
4085 ========================
4087 get a string from buffer, returns tempstring, dont str_unzone it!
4088 string bufstr_get(float bufhandle, float string_index) = #465;
4089 ========================
4091 void VM_bufstr_get (prvm_prog_t *prog)
4093 prvm_stringbuffer_t *stringbuffer;
4095 VM_SAFEPARMCOUNT(2, VM_bufstr_get);
4097 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4098 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4101 VM_Warning(prog, "VM_bufstr_get: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4104 strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4107 // VM_Warning(prog, "VM_bufstr_get: invalid string index %i used in %s\n", strindex, prog->name);
4110 if (strindex < stringbuffer->num_strings && stringbuffer->strings[strindex])
4111 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog, stringbuffer->strings[strindex]);
4115 ========================
4117 copies a string into selected slot of buffer
4118 void bufstr_set(float bufhandle, float string_index, string str) = #466;
4119 ========================
4121 void VM_bufstr_set (prvm_prog_t *prog)
4124 prvm_stringbuffer_t *stringbuffer;
4127 VM_SAFEPARMCOUNT(3, VM_bufstr_set);
4129 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4132 VM_Warning(prog, "VM_bufstr_set: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4135 strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4136 if(strindex < 0 || strindex >= 1000000) // huge number of strings
4138 VM_Warning(prog, "VM_bufstr_set: invalid string index %i used in %s\n", strindex, prog->name);
4142 news = PRVM_G_STRING(OFS_PARM2);
4143 BufStr_Set(prog, stringbuffer, strindex, news);
4147 ========================
4149 adds string to buffer in first free slot and returns its index
4150 "order == true" means that string will be added after last "full" slot
4151 float bufstr_add(float bufhandle, string str, float order) = #467;
4152 ========================
4154 void VM_bufstr_add (prvm_prog_t *prog)
4156 int order, strindex;
4157 prvm_stringbuffer_t *stringbuffer;
4161 VM_SAFEPARMCOUNT(3, VM_bufstr_add);
4163 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4164 PRVM_G_FLOAT(OFS_RETURN) = -1;
4167 VM_Warning(prog, "VM_bufstr_add: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4170 if(!PRVM_G_INT(OFS_PARM1)) // NULL string
4172 VM_Warning(prog, "VM_bufstr_add: can not add an empty string to buffer %i in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4175 string = PRVM_G_STRING(OFS_PARM1);
4176 order = (int)PRVM_G_FLOAT(OFS_PARM2);
4178 strindex = stringbuffer->num_strings;
4180 for (strindex = 0;strindex < stringbuffer->num_strings;strindex++)
4181 if (stringbuffer->strings[strindex] == NULL)
4184 BufStr_Expand(prog, stringbuffer, strindex);
4186 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4187 alloclen = strlen(string) + 1;
4188 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4189 memcpy(stringbuffer->strings[strindex], string, alloclen);
4191 PRVM_G_FLOAT(OFS_RETURN) = strindex;
4195 ========================
4197 delete string from buffer
4198 void bufstr_free(float bufhandle, float string_index) = #468;
4199 ========================
4201 void VM_bufstr_free (prvm_prog_t *prog)
4204 prvm_stringbuffer_t *stringbuffer;
4205 VM_SAFEPARMCOUNT(2, VM_bufstr_free);
4207 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4210 VM_Warning(prog, "VM_bufstr_free: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), prog->name);
4213 i = (int)PRVM_G_FLOAT(OFS_PARM1);
4216 VM_Warning(prog, "VM_bufstr_free: invalid string index %i used in %s\n", i, prog->name);
4220 if (i < stringbuffer->num_strings)
4222 if(stringbuffer->strings[i])
4223 Mem_Free(stringbuffer->strings[i]);
4224 stringbuffer->strings[i] = NULL;
4227 BufStr_Shrink(prog, stringbuffer);
4231 ========================
4233 load a file into string buffer, return 0 or 1
4234 float buf_loadfile(string filename, float bufhandle) = #535;
4235 ========================
4237 void VM_buf_loadfile(prvm_prog_t *prog)
4240 prvm_stringbuffer_t *stringbuffer;
4241 char string[VM_STRINGTEMP_LENGTH];
4242 int strindex, c, end;
4243 const char *filename;
4247 VM_SAFEPARMCOUNT(2, VM_buf_loadfile);
4250 filename = PRVM_G_STRING(OFS_PARM0);
4251 file = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "data/%s", filename), false);
4253 file = FS_OpenVirtualFile(va(vabuf, sizeof(vabuf), "%s", filename), false);
4256 if (developer_extra.integer)
4257 VM_Warning(prog, "VM_buf_loadfile: failed to open file %s in %s\n", filename, prog->name);
4258 PRVM_G_FLOAT(OFS_RETURN) = 0;
4262 // get string buffer
4263 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM1));
4266 VM_Warning(prog, "VM_buf_loadfile: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4267 PRVM_G_FLOAT(OFS_RETURN) = 0;
4271 // read file (append to the end of buffer)
4272 strindex = stringbuffer->num_strings;
4280 if (c == '\r' || c == '\n' || c < 0)
4282 if (end < VM_STRINGTEMP_LENGTH - 1)
4286 // remove \n following \r
4291 FS_UnGetc(file, (unsigned char)c);
4296 BufStr_Expand(prog, stringbuffer, strindex);
4297 stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4298 alloclen = strlen(string) + 1;
4299 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4300 memcpy(stringbuffer->strings[strindex], string, alloclen);
4301 strindex = stringbuffer->num_strings;
4309 PRVM_G_FLOAT(OFS_RETURN) = 1;
4313 ========================
4315 writes stringbuffer to a file, returns 0 or 1
4316 float buf_writefile(float filehandle, float bufhandle, [, float startpos, float numstrings]) = #468;
4317 ========================
4320 void VM_buf_writefile(prvm_prog_t *prog)
4322 int filenum, strindex, strnum, strlength;
4323 prvm_stringbuffer_t *stringbuffer;
4325 VM_SAFEPARMCOUNTRANGE(2, 4, VM_buf_writefile);
4328 filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
4329 if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
4331 VM_Warning(prog, "VM_buf_writefile: invalid file handle %i used in %s\n", filenum, prog->name);
4334 if (prog->openfiles[filenum] == NULL)
4336 VM_Warning(prog, "VM_buf_writefile: no such file handle %i (or file has been closed) in %s\n", filenum, prog->name);
4340 // get string buffer
4341 stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM1));
4344 VM_Warning(prog, "VM_buf_writefile: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), prog->name);
4345 PRVM_G_FLOAT(OFS_RETURN) = 0;
4349 // get start and end parms
4352 strindex = (int)PRVM_G_FLOAT(OFS_PARM2);
4353 strnum = (int)PRVM_G_FLOAT(OFS_PARM3);
4355 else if (prog->argc > 2)
4357 strindex = (int)PRVM_G_FLOAT(OFS_PARM2);
4358 strnum = stringbuffer->num_strings - strindex;
4363 strnum = stringbuffer->num_strings;
4365 if (strindex < 0 || strindex >= stringbuffer->num_strings)
4367 VM_Warning(prog, "VM_buf_writefile: wrong start string index %i used in %s\n", strindex, prog->name);
4368 PRVM_G_FLOAT(OFS_RETURN) = 0;
4373 VM_Warning(prog, "VM_buf_writefile: wrong strings count %i used in %s\n", strnum, prog->name);
4374 PRVM_G_FLOAT(OFS_RETURN) = 0;
4379 while(strindex < stringbuffer->num_strings && strnum)
4381 if (stringbuffer->strings[strindex])
4383 if ((strlength = (int)strlen(stringbuffer->strings[strindex])))
4384 FS_Write(prog->openfiles[filenum], stringbuffer->strings[strindex], strlength);
4385 FS_Write(prog->openfiles[filenum], "\n", 1);
4391 PRVM_G_FLOAT(OFS_RETURN) = 1;
4394 #define MATCH_AUTO 0
4395 #define MATCH_WHOLE 1
4396 #define MATCH_LEFT 2
4397 #define MATCH_RIGHT 3
4398 #define MATCH_MIDDLE 4
4399 #define MATCH_PATTERN 5
4401 static const char *detect_match_rule(char *pattern, int *matchrule)
4406 patternlength = (int)strlen(pattern);
4407 ppos = strchr(pattern, '*');
4408 qpos = strchr(pattern, '?');
4412 *matchrule = MATCH_PATTERN;
4415 // has * - left, mid, right or pattern
4418 // starts with * - may be right/mid or pattern
4419 if ((ppos - pattern) == 0)
4421 ppos = strchr(pattern+1, '*');
4425 *matchrule = MATCH_RIGHT;
4429 if ((ppos - pattern) == patternlength)
4431 *matchrule = MATCH_MIDDLE;
4436 *matchrule = MATCH_PATTERN;
4439 // end with * - left
4440 if ((ppos - pattern) == patternlength)
4442 *matchrule = MATCH_LEFT;
4447 *matchrule = MATCH_PATTERN;
4450 // have no wildcards - whole string
4451 *matchrule = MATCH_WHOLE;
4455 // todo: support UTF8
4456 static qbool match_rule(const char *string, int max_string, const char *pattern, int patternlength, int rule)