fix some format string errors, and return value of read() ignored warnings
[divverent/darkplaces.git] / prvm_cmds.c
1 // AK
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
5 // also applies here
6
7 #include "quakedef.h"
8
9 #include "prvm_cmds.h"
10 #include "libcurl.h"
11 #include <time.h>
12
13 extern cvar_t prvm_backtraceforwarnings;
14
15 // LordHavoc: changed this to NOT use a return statement, so that it can be used in functions that must return a value
16 void VM_Warning(const char *fmt, ...)
17 {
18         va_list argptr;
19         char msg[MAX_INPUTLINE];
20         static double recursive = -1;
21
22         va_start(argptr,fmt);
23         dpvsnprintf(msg,sizeof(msg),fmt,argptr);
24         va_end(argptr);
25
26         Con_Print(msg);
27
28         // TODO: either add a cvar/cmd to control the state dumping or replace some of the calls with Con_Printf [9/13/2006 Black]
29         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
30         {
31                 recursive = realtime;
32                 PRVM_PrintState();
33                 recursive = -1;
34         }
35 }
36
37
38 //============================================================================
39 // Common
40
41 // TODO DONE: move vm_files and vm_fssearchlist to prvm_prog_t struct
42 // TODO: move vm_files and vm_fssearchlist back [9/13/2006 Black]
43 // TODO: (move vm_files and vm_fssearchlist to prvm_prog_t struct again) [2007-01-23 LordHavoc]
44 // TODO: will this war ever end? [2007-01-23 LordHavoc]
45
46 void VM_CheckEmptyString (const char *s)
47 {
48         if (s[0] <= ' ')
49                 PRVM_ERROR ("%s: Bad string", PRVM_NAME);
50 }
51
52 //============================================================================
53 //BUILT-IN FUNCTIONS
54
55 void VM_VarString(int first, char *out, int outlength)
56 {
57         int i;
58         const char *s;
59         char *outend;
60
61         outend = out + outlength - 1;
62         for (i = first;i < prog->argc && out < outend;i++)
63         {
64                 s = PRVM_G_STRING((OFS_PARM0+i*3));
65                 while (out < outend && *s)
66                         *out++ = *s++;
67         }
68         *out++ = 0;
69 }
70
71 /*
72 =================
73 VM_checkextension
74
75 returns true if the extension is supported by the server
76
77 checkextension(extensionname)
78 =================
79 */
80
81 // kind of helper function
82 static qboolean checkextension(const char *name)
83 {
84         int len;
85         char *e, *start;
86         len = (int)strlen(name);
87
88         for (e = prog->extensionstring;*e;e++)
89         {
90                 while (*e == ' ')
91                         e++;
92                 if (!*e)
93                         break;
94                 start = e;
95                 while (*e && *e != ' ')
96                         e++;
97                 if ((e - start) == len && !strncasecmp(start, name, len))
98                         return true;
99         }
100         return false;
101 }
102
103 void VM_checkextension (void)
104 {
105         VM_SAFEPARMCOUNT(1,VM_checkextension);
106
107         PRVM_G_FLOAT(OFS_RETURN) = checkextension(PRVM_G_STRING(OFS_PARM0));
108 }
109
110 /*
111 =================
112 VM_error
113
114 This is a TERMINAL error, which will kill off the entire prog.
115 Dumps self.
116
117 error(value)
118 =================
119 */
120 void VM_error (void)
121 {
122         prvm_edict_t    *ed;
123         char string[VM_STRINGTEMP_LENGTH];
124
125         VM_VarString(0, string, sizeof(string));
126         Con_Printf("======%s ERROR in %s:\n%s\n", PRVM_NAME, PRVM_GetString(prog->xfunction->s_name), string);
127         if (prog->globaloffsets.self >= 0)
128         {
129                 ed = PRVM_PROG_TO_EDICT(PRVM_GLOBALFIELDVALUE(prog->globaloffsets.self)->edict);
130                 PRVM_ED_Print(ed, NULL);
131         }
132
133         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);
134 }
135
136 /*
137 =================
138 VM_objerror
139
140 Dumps out self, then an error message.  The program is aborted and self is
141 removed, but the level can continue.
142
143 objerror(value)
144 =================
145 */
146 void VM_objerror (void)
147 {
148         prvm_edict_t    *ed;
149         char string[VM_STRINGTEMP_LENGTH];
150
151         VM_VarString(0, string, sizeof(string));
152         Con_Printf("======OBJECT ERROR======\n"); // , PRVM_NAME, PRVM_GetString(prog->xfunction->s_name), string); // or include them? FIXME
153         if (prog->globaloffsets.self >= 0)
154         {
155                 ed = PRVM_PROG_TO_EDICT(PRVM_GLOBALFIELDVALUE(prog->globaloffsets.self)->edict);
156                 PRVM_ED_Print(ed, NULL);
157
158                 PRVM_ED_Free (ed);
159         }
160         else
161                 // objerror has to display the object fields -> else call
162                 PRVM_ERROR ("VM_objecterror: self not defined !");
163         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);
164 }
165
166 /*
167 =================
168 VM_print
169
170 print to console
171
172 print(...[string])
173 =================
174 */
175 void VM_print (void)
176 {
177         char string[VM_STRINGTEMP_LENGTH];
178
179         VM_VarString(0, string, sizeof(string));
180         Con_Print(string);
181 }
182
183 /*
184 =================
185 VM_bprint
186
187 broadcast print to everyone on server
188
189 bprint(...[string])
190 =================
191 */
192 void VM_bprint (void)
193 {
194         char string[VM_STRINGTEMP_LENGTH];
195
196         if(!sv.active)
197         {
198                 VM_Warning("VM_bprint: game is not server(%s) !\n", PRVM_NAME);
199                 return;
200         }
201
202         VM_VarString(0, string, sizeof(string));
203         SV_BroadcastPrint(string);
204 }
205
206 /*
207 =================
208 VM_sprint (menu & client but only if server.active == true)
209
210 single print to a specific client
211
212 sprint(float clientnum,...[string])
213 =================
214 */
215 void VM_sprint (void)
216 {
217         client_t        *client;
218         int                     clientnum;
219         char string[VM_STRINGTEMP_LENGTH];
220
221         VM_SAFEPARMCOUNTRANGE(1, 8, VM_sprint);
222
223         //find client for this entity
224         clientnum = (int)PRVM_G_FLOAT(OFS_PARM0);
225         if (!sv.active  || clientnum < 0 || clientnum >= svs.maxclients || !svs.clients[clientnum].active)
226         {
227                 VM_Warning("VM_sprint: %s: invalid client or server is not active !\n", PRVM_NAME);
228                 return;
229         }
230
231         client = svs.clients + clientnum;
232         if (!client->netconnection)
233                 return;
234
235         VM_VarString(1, string, sizeof(string));
236         MSG_WriteChar(&client->netconnection->message,svc_print);
237         MSG_WriteString(&client->netconnection->message, string);
238 }
239
240 /*
241 =================
242 VM_centerprint
243
244 single print to the screen
245
246 centerprint(value)
247 =================
248 */
249 void VM_centerprint (void)
250 {
251         char string[VM_STRINGTEMP_LENGTH];
252
253         VM_SAFEPARMCOUNTRANGE(1, 8, VM_centerprint);
254         VM_VarString(0, string, sizeof(string));
255         SCR_CenterPrint(string);
256 }
257
258 /*
259 =================
260 VM_normalize
261
262 vector normalize(vector)
263 =================
264 */
265 void VM_normalize (void)
266 {
267         float   *value1;
268         vec3_t  newvalue;
269         double  f;
270
271         VM_SAFEPARMCOUNT(1,VM_normalize);
272
273         value1 = PRVM_G_VECTOR(OFS_PARM0);
274
275         f = VectorLength2(value1);
276         if (f)
277         {
278                 f = 1.0 / sqrt(f);
279                 VectorScale(value1, f, newvalue);
280         }
281         else
282                 VectorClear(newvalue);
283
284         VectorCopy (newvalue, PRVM_G_VECTOR(OFS_RETURN));
285 }
286
287 /*
288 =================
289 VM_vlen
290
291 scalar vlen(vector)
292 =================
293 */
294 void VM_vlen (void)
295 {
296         VM_SAFEPARMCOUNT(1,VM_vlen);
297         PRVM_G_FLOAT(OFS_RETURN) = VectorLength(PRVM_G_VECTOR(OFS_PARM0));
298 }
299
300 /*
301 =================
302 VM_vectoyaw
303
304 float vectoyaw(vector)
305 =================
306 */
307 void VM_vectoyaw (void)
308 {
309         float   *value1;
310         float   yaw;
311
312         VM_SAFEPARMCOUNT(1,VM_vectoyaw);
313
314         value1 = PRVM_G_VECTOR(OFS_PARM0);
315
316         if (value1[1] == 0 && value1[0] == 0)
317                 yaw = 0;
318         else
319         {
320                 yaw = (int) (atan2(value1[1], value1[0]) * 180 / M_PI);
321                 if (yaw < 0)
322                         yaw += 360;
323         }
324
325         PRVM_G_FLOAT(OFS_RETURN) = yaw;
326 }
327
328
329 /*
330 =================
331 VM_vectoangles
332
333 vector vectoangles(vector[, vector])
334 =================
335 */
336 void VM_vectoangles (void)
337 {
338         VM_SAFEPARMCOUNTRANGE(1, 2,VM_vectoangles);
339
340         AnglesFromVectors(PRVM_G_VECTOR(OFS_RETURN), PRVM_G_VECTOR(OFS_PARM0), prog->argc >= 2 ? PRVM_G_VECTOR(OFS_PARM1) : NULL, true);
341 }
342
343 /*
344 =================
345 VM_random
346
347 Returns a number from 0<= num < 1
348
349 float random()
350 =================
351 */
352 void VM_random (void)
353 {
354         VM_SAFEPARMCOUNT(0,VM_random);
355
356         PRVM_G_FLOAT(OFS_RETURN) = lhrandom(0, 1);
357 }
358
359 /*
360 =========
361 VM_localsound
362
363 localsound(string sample)
364 =========
365 */
366 void VM_localsound(void)
367 {
368         const char *s;
369
370         VM_SAFEPARMCOUNT(1,VM_localsound);
371
372         s = PRVM_G_STRING(OFS_PARM0);
373
374         if(!S_LocalSound (s))
375         {
376                 PRVM_G_FLOAT(OFS_RETURN) = -4;
377                 VM_Warning("VM_localsound: Failed to play %s for %s !\n", s, PRVM_NAME);
378                 return;
379         }
380
381         PRVM_G_FLOAT(OFS_RETURN) = 1;
382 }
383
384 /*
385 =================
386 VM_break
387
388 break()
389 =================
390 */
391 void VM_break (void)
392 {
393         PRVM_ERROR ("%s: break statement", PRVM_NAME);
394 }
395
396 //============================================================================
397
398 /*
399 =================
400 VM_localcmd
401
402 Sends text over to the client's execution buffer
403
404 [localcmd (string, ...) or]
405 cmd (string, ...)
406 =================
407 */
408 void VM_localcmd (void)
409 {
410         char string[VM_STRINGTEMP_LENGTH];
411         VM_SAFEPARMCOUNTRANGE(1, 8, VM_localcmd);
412         VM_VarString(0, string, sizeof(string));
413         Cbuf_AddText(string);
414 }
415
416 /*
417 =================
418 VM_cvar
419
420 float cvar (string)
421 =================
422 */
423 void VM_cvar (void)
424 {
425         char string[VM_STRINGTEMP_LENGTH];
426         VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
427         VM_VarString(0, string, sizeof(string));
428         VM_CheckEmptyString(string);
429         PRVM_G_FLOAT(OFS_RETURN) = Cvar_VariableValue(string);
430 }
431
432 /*
433 =================
434 VM_cvar
435
436 float cvar_type (string)
437 float CVAR_TYPEFLAG_EXISTS = 1;
438 float CVAR_TYPEFLAG_SAVED = 2;
439 float CVAR_TYPEFLAG_PRIVATE = 4;
440 float CVAR_TYPEFLAG_ENGINE = 8;
441 float CVAR_TYPEFLAG_HASDESCRIPTION = 16;
442 =================
443 */
444 void VM_cvar_type (void)
445 {
446         char string[VM_STRINGTEMP_LENGTH];
447         cvar_t *cvar;
448         int ret;
449
450         VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar);
451         VM_VarString(0, string, sizeof(string));
452         VM_CheckEmptyString(string);
453         cvar = Cvar_FindVar(string);
454
455
456         if(!cvar)
457         {
458                 PRVM_G_FLOAT(OFS_RETURN) = 0;
459                 return; // CVAR_TYPE_NONE
460         }
461
462         ret = 1; // CVAR_EXISTS
463         if(cvar->flags & CVAR_SAVE)
464                 ret |= 2; // CVAR_TYPE_SAVED
465         if(cvar->flags & CVAR_PRIVATE)
466                 ret |= 4; // CVAR_TYPE_PRIVATE
467         if(!(cvar->flags & CVAR_ALLOCATED))
468                 ret |= 8; // CVAR_TYPE_ENGINE
469         if(strcmp(cvar->description, "custom cvar")) // has to match Cvar_Get's placeholder string
470                 ret |= 16; // CVAR_TYPE_HASDESCRIPTION
471         
472         PRVM_G_FLOAT(OFS_RETURN) = ret;
473 }
474
475 /*
476 =================
477 VM_cvar_string
478
479 const string    VM_cvar_string (string, ...)
480 =================
481 */
482 void VM_cvar_string(void)
483 {
484         char string[VM_STRINGTEMP_LENGTH];
485         VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_string);
486         VM_VarString(0, string, sizeof(string));
487         VM_CheckEmptyString(string);
488         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(Cvar_VariableString(string));
489 }
490
491
492 /*
493 ========================
494 VM_cvar_defstring
495
496 const string    VM_cvar_defstring (string, ...)
497 ========================
498 */
499 void VM_cvar_defstring (void)
500 {
501         char string[VM_STRINGTEMP_LENGTH];
502         VM_SAFEPARMCOUNTRANGE(1,8,VM_cvar_defstring);
503         VM_VarString(0, string, sizeof(string));
504         VM_CheckEmptyString(string);
505         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(Cvar_VariableDefString(string));
506 }
507 /*
508 =================
509 VM_cvar_set
510
511 void cvar_set (string,string, ...)
512 =================
513 */
514 void VM_cvar_set (void)
515 {
516         const char *name;
517         char string[VM_STRINGTEMP_LENGTH];
518         VM_SAFEPARMCOUNTRANGE(2,8,VM_cvar_set);
519         VM_VarString(1, string, sizeof(string));
520         name = PRVM_G_STRING(OFS_PARM0);
521         VM_CheckEmptyString(name);
522         Cvar_Set(name, string);
523 }
524
525 /*
526 =========
527 VM_dprint
528
529 dprint(...[string])
530 =========
531 */
532 void VM_dprint (void)
533 {
534         char string[VM_STRINGTEMP_LENGTH];
535         VM_SAFEPARMCOUNTRANGE(1, 8, VM_dprint);
536         if (developer.integer)
537         {
538                 VM_VarString(0, string, sizeof(string));
539 #if 1
540                 Con_Printf("%s", string);
541 #else
542                 Con_Printf("%s: %s", PRVM_NAME, string);
543 #endif
544         }
545 }
546
547 /*
548 =========
549 VM_ftos
550
551 string  ftos(float)
552 =========
553 */
554
555 void VM_ftos (void)
556 {
557         float v;
558         char s[128];
559
560         VM_SAFEPARMCOUNT(1, VM_ftos);
561
562         v = PRVM_G_FLOAT(OFS_PARM0);
563
564         if ((float)((int)v) == v)
565                 dpsnprintf(s, sizeof(s), "%i", (int)v);
566         else
567                 dpsnprintf(s, sizeof(s), "%f", v);
568         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
569 }
570
571 /*
572 =========
573 VM_fabs
574
575 float   fabs(float)
576 =========
577 */
578
579 void VM_fabs (void)
580 {
581         float   v;
582
583         VM_SAFEPARMCOUNT(1,VM_fabs);
584
585         v = PRVM_G_FLOAT(OFS_PARM0);
586         PRVM_G_FLOAT(OFS_RETURN) = fabs(v);
587 }
588
589 /*
590 =========
591 VM_vtos
592
593 string  vtos(vector)
594 =========
595 */
596
597 void VM_vtos (void)
598 {
599         char s[512];
600
601         VM_SAFEPARMCOUNT(1,VM_vtos);
602
603         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]);
604         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
605 }
606
607 /*
608 =========
609 VM_etos
610
611 string  etos(entity)
612 =========
613 */
614
615 void VM_etos (void)
616 {
617         char s[128];
618
619         VM_SAFEPARMCOUNT(1, VM_etos);
620
621         dpsnprintf (s, sizeof(s), "entity %i", PRVM_G_EDICTNUM(OFS_PARM0));
622         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
623 }
624
625 /*
626 =========
627 VM_stof
628
629 float stof(...[string])
630 =========
631 */
632 void VM_stof(void)
633 {
634         char string[VM_STRINGTEMP_LENGTH];
635         VM_SAFEPARMCOUNTRANGE(1, 8, VM_stof);
636         VM_VarString(0, string, sizeof(string));
637         PRVM_G_FLOAT(OFS_RETURN) = atof(string);
638 }
639
640 /*
641 ========================
642 VM_itof
643
644 float itof(intt ent)
645 ========================
646 */
647 void VM_itof(void)
648 {
649         VM_SAFEPARMCOUNT(1, VM_itof);
650         PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
651 }
652
653 /*
654 ========================
655 VM_ftoe
656
657 entity ftoe(float num)
658 ========================
659 */
660 void VM_ftoe(void)
661 {
662         int ent;
663         VM_SAFEPARMCOUNT(1, VM_ftoe);
664
665         ent = (int)PRVM_G_FLOAT(OFS_PARM0);
666         if (ent < 0 || ent >= MAX_EDICTS || PRVM_PROG_TO_EDICT(ent)->priv.required->free)
667                 ent = 0; // return world instead of a free or invalid entity
668
669         PRVM_G_INT(OFS_RETURN) = ent;
670 }
671
672 /*
673 ========================
674 VM_etof
675
676 float etof(entity ent)
677 ========================
678 */
679 void VM_etof(void)
680 {
681         VM_SAFEPARMCOUNT(1, VM_etof);
682         PRVM_G_FLOAT(OFS_RETURN) = PRVM_G_EDICTNUM(OFS_PARM0);
683 }
684
685 /*
686 =========
687 VM_strftime
688
689 string strftime(float uselocaltime, string[, string ...])
690 =========
691 */
692 void VM_strftime(void)
693 {
694         time_t t;
695 #if _MSC_VER >= 1400
696         struct tm tm;
697         int tmresult;
698 #else
699         struct tm *tm;
700 #endif
701         char fmt[VM_STRINGTEMP_LENGTH];
702         char result[VM_STRINGTEMP_LENGTH];
703         VM_SAFEPARMCOUNTRANGE(2, 8, VM_strftime);
704         VM_VarString(1, fmt, sizeof(fmt));
705         t = time(NULL);
706 #if _MSC_VER >= 1400
707         if (PRVM_G_FLOAT(OFS_PARM0))
708                 tmresult = localtime_s(&tm, &t);
709         else
710                 tmresult = gmtime_s(&tm, &t);
711         if (!tmresult)
712 #else
713         if (PRVM_G_FLOAT(OFS_PARM0))
714                 tm = localtime(&t);
715         else
716                 tm = gmtime(&t);
717         if (!tm)
718 #endif
719         {
720                 PRVM_G_INT(OFS_RETURN) = 0;
721                 return;
722         }
723 #if _MSC_VER >= 1400
724         strftime(result, sizeof(result), fmt, &tm);
725 #else
726         strftime(result, sizeof(result), fmt, tm);
727 #endif
728         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(result);
729 }
730
731 /*
732 =========
733 VM_spawn
734
735 entity spawn()
736 =========
737 */
738
739 void VM_spawn (void)
740 {
741         prvm_edict_t    *ed;
742         VM_SAFEPARMCOUNT(0, VM_spawn);
743         prog->xfunction->builtinsprofile += 20;
744         ed = PRVM_ED_Alloc();
745         VM_RETURN_EDICT(ed);
746 }
747
748 /*
749 =========
750 VM_remove
751
752 remove(entity e)
753 =========
754 */
755
756 void VM_remove (void)
757 {
758         prvm_edict_t    *ed;
759         prog->xfunction->builtinsprofile += 20;
760
761         VM_SAFEPARMCOUNT(1, VM_remove);
762
763         ed = PRVM_G_EDICT(OFS_PARM0);
764         if( PRVM_NUM_FOR_EDICT(ed) <= prog->reserved_edicts )
765         {
766                 if (developer.integer >= 1)
767                         VM_Warning( "VM_remove: tried to remove the null entity or a reserved entity!\n" );
768         }
769         else if( ed->priv.required->free )
770         {
771                 if (developer.integer >= 1)
772                         VM_Warning( "VM_remove: tried to remove an already freed entity!\n" );
773         }
774         else
775                 PRVM_ED_Free (ed);
776 }
777
778 /*
779 =========
780 VM_find
781
782 entity  find(entity start, .string field, string match)
783 =========
784 */
785
786 void VM_find (void)
787 {
788         int             e;
789         int             f;
790         const char      *s, *t;
791         prvm_edict_t    *ed;
792
793         VM_SAFEPARMCOUNT(3,VM_find);
794
795         e = PRVM_G_EDICTNUM(OFS_PARM0);
796         f = PRVM_G_INT(OFS_PARM1);
797         s = PRVM_G_STRING(OFS_PARM2);
798
799         // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
800         // expects it to find all the monsters, so we must be careful to support
801         // searching for ""
802
803         for (e++ ; e < prog->num_edicts ; e++)
804         {
805                 prog->xfunction->builtinsprofile++;
806                 ed = PRVM_EDICT_NUM(e);
807                 if (ed->priv.required->free)
808                         continue;
809                 t = PRVM_E_STRING(ed,f);
810                 if (!t)
811                         t = "";
812                 if (!strcmp(t,s))
813                 {
814                         VM_RETURN_EDICT(ed);
815                         return;
816                 }
817         }
818
819         VM_RETURN_EDICT(prog->edicts);
820 }
821
822 /*
823 =========
824 VM_findfloat
825
826   entity        findfloat(entity start, .float field, float match)
827   entity        findentity(entity start, .entity field, entity match)
828 =========
829 */
830 // LordHavoc: added this for searching float, int, and entity reference fields
831 void VM_findfloat (void)
832 {
833         int             e;
834         int             f;
835         float   s;
836         prvm_edict_t    *ed;
837
838         VM_SAFEPARMCOUNT(3,VM_findfloat);
839
840         e = PRVM_G_EDICTNUM(OFS_PARM0);
841         f = PRVM_G_INT(OFS_PARM1);
842         s = PRVM_G_FLOAT(OFS_PARM2);
843
844         for (e++ ; e < prog->num_edicts ; e++)
845         {
846                 prog->xfunction->builtinsprofile++;
847                 ed = PRVM_EDICT_NUM(e);
848                 if (ed->priv.required->free)
849                         continue;
850                 if (PRVM_E_FLOAT(ed,f) == s)
851                 {
852                         VM_RETURN_EDICT(ed);
853                         return;
854                 }
855         }
856
857         VM_RETURN_EDICT(prog->edicts);
858 }
859
860 /*
861 =========
862 VM_findchain
863
864 entity  findchain(.string field, string match)
865 =========
866 */
867 // chained search for strings in entity fields
868 // entity(.string field, string match) findchain = #402;
869 void VM_findchain (void)
870 {
871         int             i;
872         int             f;
873         const char      *s, *t;
874         prvm_edict_t    *ent, *chain;
875
876         VM_SAFEPARMCOUNT(2,VM_findchain);
877
878         if (prog->fieldoffsets.chain < 0)
879                 PRVM_ERROR("VM_findchain: %s doesnt have a chain field !", PRVM_NAME);
880
881         chain = prog->edicts;
882
883         f = PRVM_G_INT(OFS_PARM0);
884         s = PRVM_G_STRING(OFS_PARM1);
885
886         // LordHavoc: apparently BloodMage does a find(world, weaponmodel, "") and
887         // expects it to find all the monsters, so we must be careful to support
888         // searching for ""
889
890         ent = PRVM_NEXT_EDICT(prog->edicts);
891         for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
892         {
893                 prog->xfunction->builtinsprofile++;
894                 if (ent->priv.required->free)
895                         continue;
896                 t = PRVM_E_STRING(ent,f);
897                 if (!t)
898                         t = "";
899                 if (strcmp(t,s))
900                         continue;
901
902                 PRVM_EDICTFIELDVALUE(ent,prog->fieldoffsets.chain)->edict = PRVM_NUM_FOR_EDICT(chain);
903                 chain = ent;
904         }
905
906         VM_RETURN_EDICT(chain);
907 }
908
909 /*
910 =========
911 VM_findchainfloat
912
913 entity  findchainfloat(.string field, float match)
914 entity  findchainentity(.string field, entity match)
915 =========
916 */
917 // LordHavoc: chained search for float, int, and entity reference fields
918 // entity(.string field, float match) findchainfloat = #403;
919 void VM_findchainfloat (void)
920 {
921         int             i;
922         int             f;
923         float   s;
924         prvm_edict_t    *ent, *chain;
925
926         VM_SAFEPARMCOUNT(2, VM_findchainfloat);
927
928         if (prog->fieldoffsets.chain < 0)
929                 PRVM_ERROR("VM_findchainfloat: %s doesnt have a chain field !", PRVM_NAME);
930
931         chain = (prvm_edict_t *)prog->edicts;
932
933         f = PRVM_G_INT(OFS_PARM0);
934         s = PRVM_G_FLOAT(OFS_PARM1);
935
936         ent = PRVM_NEXT_EDICT(prog->edicts);
937         for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
938         {
939                 prog->xfunction->builtinsprofile++;
940                 if (ent->priv.required->free)
941                         continue;
942                 if (PRVM_E_FLOAT(ent,f) != s)
943                         continue;
944
945                 PRVM_EDICTFIELDVALUE(ent,prog->fieldoffsets.chain)->edict = PRVM_EDICT_TO_PROG(chain);
946                 chain = ent;
947         }
948
949         VM_RETURN_EDICT(chain);
950 }
951
952 /*
953 ========================
954 VM_findflags
955
956 entity  findflags(entity start, .float field, float match)
957 ========================
958 */
959 // LordHavoc: search for flags in float fields
960 void VM_findflags (void)
961 {
962         int             e;
963         int             f;
964         int             s;
965         prvm_edict_t    *ed;
966
967         VM_SAFEPARMCOUNT(3, VM_findflags);
968
969
970         e = PRVM_G_EDICTNUM(OFS_PARM0);
971         f = PRVM_G_INT(OFS_PARM1);
972         s = (int)PRVM_G_FLOAT(OFS_PARM2);
973
974         for (e++ ; e < prog->num_edicts ; e++)
975         {
976                 prog->xfunction->builtinsprofile++;
977                 ed = PRVM_EDICT_NUM(e);
978                 if (ed->priv.required->free)
979                         continue;
980                 if (!PRVM_E_FLOAT(ed,f))
981                         continue;
982                 if ((int)PRVM_E_FLOAT(ed,f) & s)
983                 {
984                         VM_RETURN_EDICT(ed);
985                         return;
986                 }
987         }
988
989         VM_RETURN_EDICT(prog->edicts);
990 }
991
992 /*
993 ========================
994 VM_findchainflags
995
996 entity  findchainflags(.float field, float match)
997 ========================
998 */
999 // LordHavoc: chained search for flags in float fields
1000 void VM_findchainflags (void)
1001 {
1002         int             i;
1003         int             f;
1004         int             s;
1005         prvm_edict_t    *ent, *chain;
1006
1007         VM_SAFEPARMCOUNT(2, VM_findchainflags);
1008
1009         if (prog->fieldoffsets.chain < 0)
1010                 PRVM_ERROR("VM_findchainflags: %s doesnt have a chain field !", PRVM_NAME);
1011
1012         chain = (prvm_edict_t *)prog->edicts;
1013
1014         f = PRVM_G_INT(OFS_PARM0);
1015         s = (int)PRVM_G_FLOAT(OFS_PARM1);
1016
1017         ent = PRVM_NEXT_EDICT(prog->edicts);
1018         for (i = 1;i < prog->num_edicts;i++, ent = PRVM_NEXT_EDICT(ent))
1019         {
1020                 prog->xfunction->builtinsprofile++;
1021                 if (ent->priv.required->free)
1022                         continue;
1023                 if (!PRVM_E_FLOAT(ent,f))
1024                         continue;
1025                 if (!((int)PRVM_E_FLOAT(ent,f) & s))
1026                         continue;
1027
1028                 PRVM_EDICTFIELDVALUE(ent,prog->fieldoffsets.chain)->edict = PRVM_EDICT_TO_PROG(chain);
1029                 chain = ent;
1030         }
1031
1032         VM_RETURN_EDICT(chain);
1033 }
1034
1035 /*
1036 =========
1037 VM_precache_sound
1038
1039 string  precache_sound (string sample)
1040 =========
1041 */
1042 void VM_precache_sound (void)
1043 {
1044         const char *s;
1045
1046         VM_SAFEPARMCOUNT(1, VM_precache_sound);
1047
1048         s = PRVM_G_STRING(OFS_PARM0);
1049         PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1050         VM_CheckEmptyString(s);
1051
1052         if(snd_initialized.integer && !S_PrecacheSound(s, true, false))
1053         {
1054                 VM_Warning("VM_precache_sound: Failed to load %s for %s\n", s, PRVM_NAME);
1055                 return;
1056         }
1057 }
1058
1059 /*
1060 =================
1061 VM_precache_file
1062
1063 returns the same string as output
1064
1065 does nothing, only used by qcc to build .pak archives
1066 =================
1067 */
1068 void VM_precache_file (void)
1069 {
1070         VM_SAFEPARMCOUNT(1,VM_precache_file);
1071         // precache_file is only used to copy files with qcc, it does nothing
1072         PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
1073 }
1074
1075 /*
1076 =========
1077 VM_coredump
1078
1079 coredump()
1080 =========
1081 */
1082 void VM_coredump (void)
1083 {
1084         VM_SAFEPARMCOUNT(0,VM_coredump);
1085
1086         Cbuf_AddText("prvm_edicts ");
1087         Cbuf_AddText(PRVM_NAME);
1088         Cbuf_AddText("\n");
1089 }
1090
1091 /*
1092 =========
1093 VM_stackdump
1094
1095 stackdump()
1096 =========
1097 */
1098 void PRVM_StackTrace(void);
1099 void VM_stackdump (void)
1100 {
1101         VM_SAFEPARMCOUNT(0, VM_stackdump);
1102
1103         PRVM_StackTrace();
1104 }
1105
1106 /*
1107 =========
1108 VM_crash
1109
1110 crash()
1111 =========
1112 */
1113
1114 void VM_crash(void)
1115 {
1116         VM_SAFEPARMCOUNT(0, VM_crash);
1117
1118         PRVM_ERROR("Crash called by %s",PRVM_NAME);
1119 }
1120
1121 /*
1122 =========
1123 VM_traceon
1124
1125 traceon()
1126 =========
1127 */
1128 void VM_traceon (void)
1129 {
1130         VM_SAFEPARMCOUNT(0,VM_traceon);
1131
1132         prog->trace = true;
1133 }
1134
1135 /*
1136 =========
1137 VM_traceoff
1138
1139 traceoff()
1140 =========
1141 */
1142 void VM_traceoff (void)
1143 {
1144         VM_SAFEPARMCOUNT(0,VM_traceoff);
1145
1146         prog->trace = false;
1147 }
1148
1149 /*
1150 =========
1151 VM_eprint
1152
1153 eprint(entity e)
1154 =========
1155 */
1156 void VM_eprint (void)
1157 {
1158         VM_SAFEPARMCOUNT(1,VM_eprint);
1159
1160         PRVM_ED_PrintNum (PRVM_G_EDICTNUM(OFS_PARM0), NULL);
1161 }
1162
1163 /*
1164 =========
1165 VM_rint
1166
1167 float   rint(float)
1168 =========
1169 */
1170 void VM_rint (void)
1171 {
1172         float f;
1173         VM_SAFEPARMCOUNT(1,VM_rint);
1174
1175         f = PRVM_G_FLOAT(OFS_PARM0);
1176         if (f > 0)
1177                 PRVM_G_FLOAT(OFS_RETURN) = floor(f + 0.5);
1178         else
1179                 PRVM_G_FLOAT(OFS_RETURN) = ceil(f - 0.5);
1180 }
1181
1182 /*
1183 =========
1184 VM_floor
1185
1186 float   floor(float)
1187 =========
1188 */
1189 void VM_floor (void)
1190 {
1191         VM_SAFEPARMCOUNT(1,VM_floor);
1192
1193         PRVM_G_FLOAT(OFS_RETURN) = floor(PRVM_G_FLOAT(OFS_PARM0));
1194 }
1195
1196 /*
1197 =========
1198 VM_ceil
1199
1200 float   ceil(float)
1201 =========
1202 */
1203 void VM_ceil (void)
1204 {
1205         VM_SAFEPARMCOUNT(1,VM_ceil);
1206
1207         PRVM_G_FLOAT(OFS_RETURN) = ceil(PRVM_G_FLOAT(OFS_PARM0));
1208 }
1209
1210
1211 /*
1212 =============
1213 VM_nextent
1214
1215 entity  nextent(entity)
1216 =============
1217 */
1218 void VM_nextent (void)
1219 {
1220         int             i;
1221         prvm_edict_t    *ent;
1222
1223         VM_SAFEPARMCOUNT(1, VM_nextent);
1224
1225         i = PRVM_G_EDICTNUM(OFS_PARM0);
1226         while (1)
1227         {
1228                 prog->xfunction->builtinsprofile++;
1229                 i++;
1230                 if (i == prog->num_edicts)
1231                 {
1232                         VM_RETURN_EDICT(prog->edicts);
1233                         return;
1234                 }
1235                 ent = PRVM_EDICT_NUM(i);
1236                 if (!ent->priv.required->free)
1237                 {
1238                         VM_RETURN_EDICT(ent);
1239                         return;
1240                 }
1241         }
1242 }
1243
1244 //=============================================================================
1245
1246 /*
1247 ==============
1248 VM_changelevel
1249 server and menu
1250
1251 changelevel(string map)
1252 ==============
1253 */
1254 void VM_changelevel (void)
1255 {
1256         VM_SAFEPARMCOUNT(1, VM_changelevel);
1257
1258         if(!sv.active)
1259         {
1260                 VM_Warning("VM_changelevel: game is not server (%s)\n", PRVM_NAME);
1261                 return;
1262         }
1263
1264 // make sure we don't issue two changelevels
1265         if (svs.changelevel_issued)
1266                 return;
1267         svs.changelevel_issued = true;
1268
1269         Cbuf_AddText (va("changelevel %s\n",PRVM_G_STRING(OFS_PARM0)));
1270 }
1271
1272 /*
1273 =========
1274 VM_sin
1275
1276 float   sin(float)
1277 =========
1278 */
1279 void VM_sin (void)
1280 {
1281         VM_SAFEPARMCOUNT(1,VM_sin);
1282         PRVM_G_FLOAT(OFS_RETURN) = sin(PRVM_G_FLOAT(OFS_PARM0));
1283 }
1284
1285 /*
1286 =========
1287 VM_cos
1288 float   cos(float)
1289 =========
1290 */
1291 void VM_cos (void)
1292 {
1293         VM_SAFEPARMCOUNT(1,VM_cos);
1294         PRVM_G_FLOAT(OFS_RETURN) = cos(PRVM_G_FLOAT(OFS_PARM0));
1295 }
1296
1297 /*
1298 =========
1299 VM_sqrt
1300
1301 float   sqrt(float)
1302 =========
1303 */
1304 void VM_sqrt (void)
1305 {
1306         VM_SAFEPARMCOUNT(1,VM_sqrt);
1307         PRVM_G_FLOAT(OFS_RETURN) = sqrt(PRVM_G_FLOAT(OFS_PARM0));
1308 }
1309
1310 /*
1311 =========
1312 VM_asin
1313
1314 float   asin(float)
1315 =========
1316 */
1317 void VM_asin (void)
1318 {
1319         VM_SAFEPARMCOUNT(1,VM_asin);
1320         PRVM_G_FLOAT(OFS_RETURN) = asin(PRVM_G_FLOAT(OFS_PARM0));
1321 }
1322
1323 /*
1324 =========
1325 VM_acos
1326 float   acos(float)
1327 =========
1328 */
1329 void VM_acos (void)
1330 {
1331         VM_SAFEPARMCOUNT(1,VM_acos);
1332         PRVM_G_FLOAT(OFS_RETURN) = acos(PRVM_G_FLOAT(OFS_PARM0));
1333 }
1334
1335 /*
1336 =========
1337 VM_atan
1338 float   atan(float)
1339 =========
1340 */
1341 void VM_atan (void)
1342 {
1343         VM_SAFEPARMCOUNT(1,VM_atan);
1344         PRVM_G_FLOAT(OFS_RETURN) = atan(PRVM_G_FLOAT(OFS_PARM0));
1345 }
1346
1347 /*
1348 =========
1349 VM_atan2
1350 float   atan2(float,float)
1351 =========
1352 */
1353 void VM_atan2 (void)
1354 {
1355         VM_SAFEPARMCOUNT(2,VM_atan2);
1356         PRVM_G_FLOAT(OFS_RETURN) = atan2(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1357 }
1358
1359 /*
1360 =========
1361 VM_tan
1362 float   tan(float)
1363 =========
1364 */
1365 void VM_tan (void)
1366 {
1367         VM_SAFEPARMCOUNT(1,VM_tan);
1368         PRVM_G_FLOAT(OFS_RETURN) = tan(PRVM_G_FLOAT(OFS_PARM0));
1369 }
1370
1371 /*
1372 =================
1373 VM_randomvec
1374
1375 Returns a vector of length < 1 and > 0
1376
1377 vector randomvec()
1378 =================
1379 */
1380 void VM_randomvec (void)
1381 {
1382         vec3_t          temp;
1383         //float         length;
1384
1385         VM_SAFEPARMCOUNT(0, VM_randomvec);
1386
1387         //// WTF ??
1388         do
1389         {
1390                 temp[0] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1391                 temp[1] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1392                 temp[2] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1393         }
1394         while (DotProduct(temp, temp) >= 1);
1395         VectorCopy (temp, PRVM_G_VECTOR(OFS_RETURN));
1396
1397         /*
1398         temp[0] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1399         temp[1] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1400         temp[2] = (rand()&32767) * (2.0 / 32767.0) - 1.0;
1401         // length returned always > 0
1402         length = (rand()&32766 + 1) * (1.0 / 32767.0) / VectorLength(temp);
1403         VectorScale(temp,length, temp);*/
1404         //VectorCopy(temp, PRVM_G_VECTOR(OFS_RETURN));
1405 }
1406
1407 //=============================================================================
1408
1409 /*
1410 =========
1411 VM_registercvar
1412
1413 float   registercvar (string name, string value[, float flags])
1414 =========
1415 */
1416 void VM_registercvar (void)
1417 {
1418         const char *name, *value;
1419         int     flags;
1420
1421         VM_SAFEPARMCOUNTRANGE(2, 3, VM_registercvar);
1422
1423         name = PRVM_G_STRING(OFS_PARM0);
1424         value = PRVM_G_STRING(OFS_PARM1);
1425         flags = prog->argc >= 3 ? (int)PRVM_G_FLOAT(OFS_PARM2) : 0;
1426         PRVM_G_FLOAT(OFS_RETURN) = 0;
1427
1428         if(flags > CVAR_MAXFLAGSVAL)
1429                 return;
1430
1431 // first check to see if it has already been defined
1432         if (Cvar_FindVar (name))
1433                 return;
1434
1435 // check for overlap with a command
1436         if (Cmd_Exists (name))
1437         {
1438                 VM_Warning("VM_registercvar: %s is a command\n", name);
1439                 return;
1440         }
1441
1442         Cvar_Get(name, value, flags);
1443
1444         PRVM_G_FLOAT(OFS_RETURN) = 1; // success
1445 }
1446
1447
1448 /*
1449 =================
1450 VM_min
1451
1452 returns the minimum of two supplied floats
1453
1454 float min(float a, float b, ...[float])
1455 =================
1456 */
1457 void VM_min (void)
1458 {
1459         VM_SAFEPARMCOUNTRANGE(2, 8, VM_min);
1460         // LordHavoc: 3+ argument enhancement suggested by FrikaC
1461         if (prog->argc >= 3)
1462         {
1463                 int i;
1464                 float f = PRVM_G_FLOAT(OFS_PARM0);
1465                 for (i = 1;i < prog->argc;i++)
1466                         if (f > PRVM_G_FLOAT((OFS_PARM0+i*3)))
1467                                 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1468                 PRVM_G_FLOAT(OFS_RETURN) = f;
1469         }
1470         else
1471                 PRVM_G_FLOAT(OFS_RETURN) = min(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1472 }
1473
1474 /*
1475 =================
1476 VM_max
1477
1478 returns the maximum of two supplied floats
1479
1480 float   max(float a, float b, ...[float])
1481 =================
1482 */
1483 void VM_max (void)
1484 {
1485         VM_SAFEPARMCOUNTRANGE(2, 8, VM_max);
1486         // LordHavoc: 3+ argument enhancement suggested by FrikaC
1487         if (prog->argc >= 3)
1488         {
1489                 int i;
1490                 float f = PRVM_G_FLOAT(OFS_PARM0);
1491                 for (i = 1;i < prog->argc;i++)
1492                         if (f < PRVM_G_FLOAT((OFS_PARM0+i*3)))
1493                                 f = PRVM_G_FLOAT((OFS_PARM0+i*3));
1494                 PRVM_G_FLOAT(OFS_RETURN) = f;
1495         }
1496         else
1497                 PRVM_G_FLOAT(OFS_RETURN) = max(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1498 }
1499
1500 /*
1501 =================
1502 VM_bound
1503
1504 returns number bounded by supplied range
1505
1506 float   bound(float min, float value, float max)
1507 =================
1508 */
1509 void VM_bound (void)
1510 {
1511         VM_SAFEPARMCOUNT(3,VM_bound);
1512         PRVM_G_FLOAT(OFS_RETURN) = bound(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1), PRVM_G_FLOAT(OFS_PARM2));
1513 }
1514
1515 /*
1516 =================
1517 VM_pow
1518
1519 returns a raised to power b
1520
1521 float   pow(float a, float b)
1522 =================
1523 */
1524 void VM_pow (void)
1525 {
1526         VM_SAFEPARMCOUNT(2,VM_pow);
1527         PRVM_G_FLOAT(OFS_RETURN) = pow(PRVM_G_FLOAT(OFS_PARM0), PRVM_G_FLOAT(OFS_PARM1));
1528 }
1529
1530 void VM_Files_Init(void)
1531 {
1532         int i;
1533         for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1534                 prog->openfiles[i] = NULL;
1535 }
1536
1537 void VM_Files_CloseAll(void)
1538 {
1539         int i;
1540         for (i = 0;i < PRVM_MAX_OPENFILES;i++)
1541         {
1542                 if (prog->openfiles[i])
1543                         FS_Close(prog->openfiles[i]);
1544                 prog->openfiles[i] = NULL;
1545         }
1546 }
1547
1548 static qfile_t *VM_GetFileHandle( int index )
1549 {
1550         if (index < 0 || index >= PRVM_MAX_OPENFILES)
1551         {
1552                 Con_Printf("VM_GetFileHandle: invalid file handle %i used in %s\n", index, PRVM_NAME);
1553                 return NULL;
1554         }
1555         if (prog->openfiles[index] == NULL)
1556         {
1557                 Con_Printf("VM_GetFileHandle: no such file handle %i (or file has been closed) in %s\n", index, PRVM_NAME);
1558                 return NULL;
1559         }
1560         return prog->openfiles[index];
1561 }
1562
1563 /*
1564 =========
1565 VM_fopen
1566
1567 float   fopen(string filename, float mode)
1568 =========
1569 */
1570 // float(string filename, float mode) fopen = #110;
1571 // opens a file inside quake/gamedir/data/ (mode is FILE_READ, FILE_APPEND, or FILE_WRITE),
1572 // returns fhandle >= 0 if successful, or fhandle < 0 if unable to open file for any reason
1573 void VM_fopen(void)
1574 {
1575         int filenum, mode;
1576         const char *modestring, *filename;
1577
1578         VM_SAFEPARMCOUNT(2,VM_fopen);
1579
1580         for (filenum = 0;filenum < PRVM_MAX_OPENFILES;filenum++)
1581                 if (prog->openfiles[filenum] == NULL)
1582                         break;
1583         if (filenum >= PRVM_MAX_OPENFILES)
1584         {
1585                 PRVM_G_FLOAT(OFS_RETURN) = -2;
1586                 VM_Warning("VM_fopen: %s ran out of file handles (%i)\n", PRVM_NAME, PRVM_MAX_OPENFILES);
1587                 return;
1588         }
1589         filename = PRVM_G_STRING(OFS_PARM0);
1590         mode = (int)PRVM_G_FLOAT(OFS_PARM1);
1591         switch(mode)
1592         {
1593         case 0: // FILE_READ
1594                 modestring = "rb";
1595                 prog->openfiles[filenum] = FS_OpenVirtualFile(va("data/%s", filename), false);
1596                 if (prog->openfiles[filenum] == NULL)
1597                         prog->openfiles[filenum] = FS_OpenVirtualFile(va("%s", filename), false);
1598                 break;
1599         case 1: // FILE_APPEND
1600                 modestring = "a";
1601                 prog->openfiles[filenum] = FS_OpenRealFile(va("data/%s", filename), modestring, false);
1602                 break;
1603         case 2: // FILE_WRITE
1604                 modestring = "w";
1605                 prog->openfiles[filenum] = FS_OpenRealFile(va("data/%s", filename), modestring, false);
1606                 break;
1607         default:
1608                 PRVM_G_FLOAT(OFS_RETURN) = -3;
1609                 VM_Warning("VM_fopen: %s: no such mode %i (valid: 0 = read, 1 = append, 2 = write)\n", PRVM_NAME, mode);
1610                 return;
1611         }
1612
1613         if (prog->openfiles[filenum] == NULL)
1614         {
1615                 PRVM_G_FLOAT(OFS_RETURN) = -1;
1616                 if (developer.integer >= 100)
1617                         VM_Warning("VM_fopen: %s: %s mode %s failed\n", PRVM_NAME, filename, modestring);
1618         }
1619         else
1620         {
1621                 PRVM_G_FLOAT(OFS_RETURN) = filenum;
1622                 if (developer.integer >= 100)
1623                         Con_Printf("VM_fopen: %s: %s mode %s opened as #%i\n", PRVM_NAME, filename, modestring, filenum);
1624                 prog->openfiles_origin[filenum] = PRVM_AllocationOrigin();
1625         }
1626 }
1627
1628 /*
1629 =========
1630 VM_fclose
1631
1632 fclose(float fhandle)
1633 =========
1634 */
1635 //void(float fhandle) fclose = #111; // closes a file
1636 void VM_fclose(void)
1637 {
1638         int filenum;
1639
1640         VM_SAFEPARMCOUNT(1,VM_fclose);
1641
1642         filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1643         if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1644         {
1645                 VM_Warning("VM_fclose: invalid file handle %i used in %s\n", filenum, PRVM_NAME);
1646                 return;
1647         }
1648         if (prog->openfiles[filenum] == NULL)
1649         {
1650                 VM_Warning("VM_fclose: no such file handle %i (or file has been closed) in %s\n", filenum, PRVM_NAME);
1651                 return;
1652         }
1653         FS_Close(prog->openfiles[filenum]);
1654         prog->openfiles[filenum] = NULL;
1655         if(prog->openfiles_origin[filenum])
1656                 PRVM_Free((char *)prog->openfiles_origin[filenum]);
1657         if (developer.integer >= 100)
1658                 Con_Printf("VM_fclose: %s: #%i closed\n", PRVM_NAME, filenum);
1659 }
1660
1661 /*
1662 =========
1663 VM_fgets
1664
1665 string  fgets(float fhandle)
1666 =========
1667 */
1668 //string(float fhandle) fgets = #112; // reads a line of text from the file and returns as a tempstring
1669 void VM_fgets(void)
1670 {
1671         int c, end;
1672         char string[VM_STRINGTEMP_LENGTH];
1673         int filenum;
1674
1675         VM_SAFEPARMCOUNT(1,VM_fgets);
1676
1677         // set the return value regardless of any possible errors
1678         PRVM_G_INT(OFS_RETURN) = OFS_NULL;
1679
1680         filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1681         if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1682         {
1683                 VM_Warning("VM_fgets: invalid file handle %i used in %s\n", filenum, PRVM_NAME);
1684                 return;
1685         }
1686         if (prog->openfiles[filenum] == NULL)
1687         {
1688                 VM_Warning("VM_fgets: no such file handle %i (or file has been closed) in %s\n", filenum, PRVM_NAME);
1689                 return;
1690         }
1691         end = 0;
1692         for (;;)
1693         {
1694                 c = FS_Getc(prog->openfiles[filenum]);
1695                 if (c == '\r' || c == '\n' || c < 0)
1696                         break;
1697                 if (end < VM_STRINGTEMP_LENGTH - 1)
1698                         string[end++] = c;
1699         }
1700         string[end] = 0;
1701         // remove \n following \r
1702         if (c == '\r')
1703         {
1704                 c = FS_Getc(prog->openfiles[filenum]);
1705                 if (c != '\n')
1706                         FS_UnGetc(prog->openfiles[filenum], (unsigned char)c);
1707         }
1708         if (developer.integer >= 100)
1709                 Con_Printf("fgets: %s: %s\n", PRVM_NAME, string);
1710         if (c >= 0 || end)
1711                 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
1712 }
1713
1714 /*
1715 =========
1716 VM_fputs
1717
1718 fputs(float fhandle, string s)
1719 =========
1720 */
1721 //void(float fhandle, string s) fputs = #113; // writes a line of text to the end of the file
1722 void VM_fputs(void)
1723 {
1724         int stringlength;
1725         char string[VM_STRINGTEMP_LENGTH];
1726         int filenum;
1727
1728         VM_SAFEPARMCOUNT(2,VM_fputs);
1729
1730         filenum = (int)PRVM_G_FLOAT(OFS_PARM0);
1731         if (filenum < 0 || filenum >= PRVM_MAX_OPENFILES)
1732         {
1733                 VM_Warning("VM_fputs: invalid file handle %i used in %s\n", filenum, PRVM_NAME);
1734                 return;
1735         }
1736         if (prog->openfiles[filenum] == NULL)
1737         {
1738                 VM_Warning("VM_fputs: no such file handle %i (or file has been closed) in %s\n", filenum, PRVM_NAME);
1739                 return;
1740         }
1741         VM_VarString(1, string, sizeof(string));
1742         if ((stringlength = (int)strlen(string)))
1743                 FS_Write(prog->openfiles[filenum], string, stringlength);
1744         if (developer.integer >= 100)
1745                 Con_Printf("fputs: %s: %s\n", PRVM_NAME, string);
1746 }
1747
1748 /*
1749 =========
1750 VM_writetofile
1751
1752         writetofile(float fhandle, entity ent)
1753 =========
1754 */
1755 void VM_writetofile(void)
1756 {
1757         prvm_edict_t * ent;
1758         qfile_t *file;
1759
1760         VM_SAFEPARMCOUNT(2, VM_writetofile);
1761
1762         file = VM_GetFileHandle( (int)PRVM_G_FLOAT(OFS_PARM0) );
1763         if( !file )
1764         {
1765                 VM_Warning("VM_writetofile: invalid or closed file handle\n");
1766                 return;
1767         }
1768
1769         ent = PRVM_G_EDICT(OFS_PARM1);
1770         if(ent->priv.required->free)
1771         {
1772                 VM_Warning("VM_writetofile: %s: entity %i is free !\n", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
1773                 return;
1774         }
1775
1776         PRVM_ED_Write (file, ent);
1777 }
1778
1779 // KrimZon - DP_QC_ENTITYDATA
1780 /*
1781 =========
1782 VM_numentityfields
1783
1784 float() numentityfields
1785 Return the number of entity fields - NOT offsets
1786 =========
1787 */
1788 void VM_numentityfields(void)
1789 {
1790         PRVM_G_FLOAT(OFS_RETURN) = prog->progs->numfielddefs;
1791 }
1792
1793 // KrimZon - DP_QC_ENTITYDATA
1794 /*
1795 =========
1796 VM_entityfieldname
1797
1798 string(float fieldnum) entityfieldname
1799 Return name of the specified field as a string, or empty if the field is invalid (warning)
1800 =========
1801 */
1802 void VM_entityfieldname(void)
1803 {
1804         ddef_t *d;
1805         int i = (int)PRVM_G_FLOAT(OFS_PARM0);
1806         
1807         if (i < 0 || i >= prog->progs->numfielddefs)
1808         {
1809         VM_Warning("VM_entityfieldname: %s: field index out of bounds\n", PRVM_NAME);
1810         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
1811                 return;
1812         }
1813         
1814         d = &prog->fielddefs[i];
1815         PRVM_G_INT(OFS_RETURN) = d->s_name; // presuming that s_name points to a string already
1816 }
1817
1818 // KrimZon - DP_QC_ENTITYDATA
1819 /*
1820 =========
1821 VM_entityfieldtype
1822
1823 float(float fieldnum) entityfieldtype
1824 =========
1825 */
1826 void VM_entityfieldtype(void)
1827 {
1828         ddef_t *d;
1829         int i = (int)PRVM_G_FLOAT(OFS_PARM0);
1830         
1831         if (i < 0 || i >= prog->progs->numfielddefs)
1832         {
1833                 VM_Warning("VM_entityfieldtype: %s: field index out of bounds\n", PRVM_NAME);
1834                 PRVM_G_FLOAT(OFS_RETURN) = -1.0;
1835                 return;
1836         }
1837         
1838         d = &prog->fielddefs[i];
1839         PRVM_G_FLOAT(OFS_RETURN) = (float)d->type;
1840 }
1841
1842 // KrimZon - DP_QC_ENTITYDATA
1843 /*
1844 =========
1845 VM_getentityfieldstring
1846
1847 string(float fieldnum, entity ent) getentityfieldstring
1848 =========
1849 */
1850 void VM_getentityfieldstring(void)
1851 {
1852         // put the data into a string
1853         ddef_t *d;
1854         int type, j;
1855         int *v;
1856         prvm_edict_t * ent;
1857         int i = (int)PRVM_G_FLOAT(OFS_PARM0);
1858         
1859         if (i < 0 || i >= prog->progs->numfielddefs)
1860         {
1861         VM_Warning("VM_entityfielddata: %s: field index out of bounds\n", PRVM_NAME);
1862                 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
1863                 return;
1864         }
1865         
1866         d = &prog->fielddefs[i];
1867         
1868         // get the entity
1869         ent = PRVM_G_EDICT(OFS_PARM1);
1870         if(ent->priv.required->free)
1871         {
1872                 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
1873                 VM_Warning("VM_entityfielddata: %s: entity %i is free !\n", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
1874                 return;
1875         }
1876         v = (int *)((char *)ent->fields.vp + d->ofs*4);
1877         
1878         // if it's 0 or blank, return an empty string
1879         type = d->type & ~DEF_SAVEGLOBAL;
1880         for (j=0 ; j<prvm_type_size[type] ; j++)
1881                 if (v[j])
1882                         break;
1883         if (j == prvm_type_size[type])
1884         {
1885                 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString("");
1886                 return;
1887         }
1888                 
1889         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(PRVM_UglyValueString((etype_t)d->type, (prvm_eval_t *)v));
1890 }
1891
1892 // KrimZon - DP_QC_ENTITYDATA
1893 /*
1894 =========
1895 VM_putentityfieldstring
1896
1897 float(float fieldnum, entity ent, string s) putentityfieldstring
1898 =========
1899 */
1900 void VM_putentityfieldstring(void)
1901 {
1902         ddef_t *d;
1903         prvm_edict_t * ent;
1904         int i = (int)PRVM_G_FLOAT(OFS_PARM0);
1905
1906         if (i < 0 || i >= prog->progs->numfielddefs)
1907         {
1908         VM_Warning("VM_entityfielddata: %s: field index out of bounds\n", PRVM_NAME);
1909                 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
1910                 return;
1911         }
1912
1913         d = &prog->fielddefs[i];
1914
1915         // get the entity
1916         ent = PRVM_G_EDICT(OFS_PARM1);
1917         if(ent->priv.required->free)
1918         {
1919                 VM_Warning("VM_entityfielddata: %s: entity %i is free !\n", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
1920                 PRVM_G_FLOAT(OFS_RETURN) = 0.0f;
1921                 return;
1922         }
1923
1924         // parse the string into the value
1925         PRVM_G_FLOAT(OFS_RETURN) = ( PRVM_ED_ParseEpair(ent, d, PRVM_G_STRING(OFS_PARM2)) ) ? 1.0f : 0.0f;
1926 }
1927
1928 /*
1929 =========
1930 VM_strlen
1931
1932 float   strlen(string s)
1933 =========
1934 */
1935 //float(string s) strlen = #114; // returns how many characters are in a string
1936 void VM_strlen(void)
1937 {
1938         VM_SAFEPARMCOUNT(1,VM_strlen);
1939
1940         PRVM_G_FLOAT(OFS_RETURN) = strlen(PRVM_G_STRING(OFS_PARM0));
1941 }
1942
1943 // DRESK - Decolorized String
1944 /*
1945 =========
1946 VM_strdecolorize
1947
1948 string  strdecolorize(string s)
1949 =========
1950 */
1951 // string (string s) strdecolorize = #472; // returns the passed in string with color codes stripped
1952 void VM_strdecolorize(void)
1953 {
1954         char szNewString[VM_STRINGTEMP_LENGTH];
1955         const char *szString;
1956
1957         // Prepare Strings
1958         VM_SAFEPARMCOUNT(1,VM_strdecolorize);
1959         szString = PRVM_G_STRING(OFS_PARM0);
1960
1961         COM_StringDecolorize(szString, 0, szNewString, sizeof(szNewString), TRUE);
1962
1963         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(szNewString);
1964 }
1965
1966 // DRESK - String Length (not counting color codes)
1967 /*
1968 =========
1969 VM_strlennocol
1970
1971 float   strlennocol(string s)
1972 =========
1973 */
1974 // float(string s) strlennocol = #471; // returns how many characters are in a string not including color codes
1975 // For example, ^2Dresk returns a length of 5
1976 void VM_strlennocol(void)
1977 {
1978         const char *szString;
1979         int nCnt;
1980
1981         VM_SAFEPARMCOUNT(1,VM_strlennocol);
1982
1983         szString = PRVM_G_STRING(OFS_PARM0);
1984
1985         nCnt = COM_StringLengthNoColors(szString, 0, NULL);
1986
1987         PRVM_G_FLOAT(OFS_RETURN) = nCnt;
1988 }
1989
1990 // DRESK - String to Uppercase and Lowercase
1991 /*
1992 =========
1993 VM_strtolower
1994
1995 string  strtolower(string s)
1996 =========
1997 */
1998 // string (string s) strtolower = #480; // returns passed in string in lowercase form
1999 void VM_strtolower(void)
2000 {
2001         char szNewString[VM_STRINGTEMP_LENGTH];
2002         const char *szString;
2003
2004         // Prepare Strings
2005         VM_SAFEPARMCOUNT(1,VM_strtolower);
2006         szString = PRVM_G_STRING(OFS_PARM0);
2007
2008         COM_ToLowerString(szString, szNewString, sizeof(szNewString) );
2009
2010         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(szNewString);
2011 }
2012
2013 /*
2014 =========
2015 VM_strtoupper
2016
2017 string  strtoupper(string s)
2018 =========
2019 */
2020 // string (string s) strtoupper = #481; // returns passed in string in uppercase form
2021 void VM_strtoupper(void)
2022 {
2023         char szNewString[VM_STRINGTEMP_LENGTH];
2024         const char *szString;
2025
2026         // Prepare Strings
2027         VM_SAFEPARMCOUNT(1,VM_strtoupper);
2028         szString = PRVM_G_STRING(OFS_PARM0);
2029
2030         COM_ToUpperString(szString, szNewString, sizeof(szNewString) );
2031
2032         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(szNewString);
2033 }
2034
2035 /*
2036 =========
2037 VM_strcat
2038
2039 string strcat(string,string,...[string])
2040 =========
2041 */
2042 //string(string s1, string s2) strcat = #115;
2043 // concatenates two strings (for example "abc", "def" would return "abcdef")
2044 // and returns as a tempstring
2045 void VM_strcat(void)
2046 {
2047         char s[VM_STRINGTEMP_LENGTH];
2048         VM_SAFEPARMCOUNTRANGE(1, 8, VM_strcat);
2049
2050         VM_VarString(0, s, sizeof(s));
2051         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(s);
2052 }
2053
2054 /*
2055 =========
2056 VM_substring
2057
2058 string  substring(string s, float start, float length)
2059 =========
2060 */
2061 // string(string s, float start, float length) substring = #116;
2062 // returns a section of a string as a tempstring
2063 void VM_substring(void)
2064 {
2065         int i, start, length;
2066         const char *s;
2067         char string[VM_STRINGTEMP_LENGTH];
2068
2069         VM_SAFEPARMCOUNT(3,VM_substring);
2070
2071         s = PRVM_G_STRING(OFS_PARM0);
2072         start = (int)PRVM_G_FLOAT(OFS_PARM1);
2073         length = (int)PRVM_G_FLOAT(OFS_PARM2);
2074         for (i = 0;i < start && *s;i++, s++);
2075         for (i = 0;i < (int)sizeof(string) - 1 && *s && i < length;i++, s++)
2076                 string[i] = *s;
2077         string[i] = 0;
2078         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
2079 }
2080
2081 /*
2082 =========
2083 VM_strreplace
2084
2085 string(string search, string replace, string subject) strreplace = #484;
2086 =========
2087 */
2088 // replaces all occurrences of search with replace in the string subject, and returns the result
2089 void VM_strreplace(void)
2090 {
2091         int i, j, si;
2092         const char *search, *replace, *subject;
2093         char string[VM_STRINGTEMP_LENGTH];
2094         int search_len, replace_len, subject_len;
2095
2096         VM_SAFEPARMCOUNT(3,VM_strreplace);
2097
2098         search = PRVM_G_STRING(OFS_PARM0);
2099         replace = PRVM_G_STRING(OFS_PARM1);
2100         subject = PRVM_G_STRING(OFS_PARM2);
2101
2102         search_len = (int)strlen(search);
2103         replace_len = (int)strlen(replace);
2104         subject_len = (int)strlen(subject);
2105
2106         si = 0;
2107         for (i = 0; i < subject_len; i++)
2108         {
2109                 for (j = 0; j < search_len && i+j < subject_len; j++)
2110                         if (subject[i+j] != search[j])
2111                                 break;
2112                 if (j == search_len || i+j == subject_len)
2113                 {
2114                 // found it at offset 'i'
2115                         for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2116                                 string[si++] = replace[j];
2117                         i += search_len - 1;
2118                 }
2119                 else
2120                 {
2121                 // not found
2122                         if (si < (int)sizeof(string) - 1)
2123                                 string[si++] = subject[i];
2124                 }
2125         }
2126         string[si] = '\0';
2127
2128         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
2129 }
2130
2131 /*
2132 =========
2133 VM_strireplace
2134
2135 string(string search, string replace, string subject) strireplace = #485;
2136 =========
2137 */
2138 // case-insensitive version of strreplace
2139 void VM_strireplace(void)
2140 {
2141         int i, j, si;
2142         const char *search, *replace, *subject;
2143         char string[VM_STRINGTEMP_LENGTH];
2144         int search_len, replace_len, subject_len;
2145
2146         VM_SAFEPARMCOUNT(3,VM_strreplace);
2147
2148         search = PRVM_G_STRING(OFS_PARM0);
2149         replace = PRVM_G_STRING(OFS_PARM1);
2150         subject = PRVM_G_STRING(OFS_PARM2);
2151
2152         search_len = (int)strlen(search);
2153         replace_len = (int)strlen(replace);
2154         subject_len = (int)strlen(subject);
2155
2156         si = 0;
2157         for (i = 0; i < subject_len; i++)
2158         {
2159                 for (j = 0; j < search_len && i+j < subject_len; j++)
2160                         if (tolower(subject[i+j]) != tolower(search[j]))
2161                                 break;
2162                 if (j == search_len || i+j == subject_len)
2163                 {
2164                 // found it at offset 'i'
2165                         for (j = 0; j < replace_len && si < (int)sizeof(string) - 1; j++)
2166                                 string[si++] = replace[j];
2167                         i += search_len - 1;
2168                 }
2169                 else
2170                 {
2171                 // not found
2172                         if (si < (int)sizeof(string) - 1)
2173                                 string[si++] = subject[i];
2174                 }
2175         }
2176         string[si] = '\0';
2177
2178         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(string);
2179 }
2180
2181 /*
2182 =========
2183 VM_stov
2184
2185 vector  stov(string s)
2186 =========
2187 */
2188 //vector(string s) stov = #117; // returns vector value from a string
2189 void VM_stov(void)
2190 {
2191         char string[VM_STRINGTEMP_LENGTH];
2192
2193         VM_SAFEPARMCOUNT(1,VM_stov);
2194
2195         VM_VarString(0, string, sizeof(string));
2196         Math_atov(string, PRVM_G_VECTOR(OFS_RETURN));
2197 }
2198
2199 /*
2200 =========
2201 VM_strzone
2202
2203 string  strzone(string s)
2204 =========
2205 */
2206 //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)
2207 void VM_strzone(void)
2208 {
2209         char *out;
2210         char string[VM_STRINGTEMP_LENGTH];
2211         size_t alloclen;
2212
2213         VM_SAFEPARMCOUNT(1,VM_strzone);
2214
2215         VM_VarString(0, string, sizeof(string));
2216         alloclen = strlen(string) + 1;
2217         PRVM_G_INT(OFS_RETURN) = PRVM_AllocString(alloclen, &out);
2218         memcpy(out, string, alloclen);
2219 }
2220
2221 /*
2222 =========
2223 VM_strunzone
2224
2225 strunzone(string s)
2226 =========
2227 */
2228 //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!!!)
2229 void VM_strunzone(void)
2230 {
2231         VM_SAFEPARMCOUNT(1,VM_strunzone);
2232         PRVM_FreeString(PRVM_G_INT(OFS_PARM0));
2233 }
2234
2235 /*
2236 =========
2237 VM_command (used by client and menu)
2238
2239 clientcommand(float client, string s) (for client and menu)
2240 =========
2241 */
2242 //void(entity e, string s) clientcommand = #440; // executes a command string as if it came from the specified client
2243 //this function originally written by KrimZon, made shorter by LordHavoc
2244 void VM_clcommand (void)
2245 {
2246         client_t *temp_client;
2247         int i;
2248
2249         VM_SAFEPARMCOUNT(2,VM_clcommand);
2250
2251         i = (int)PRVM_G_FLOAT(OFS_PARM0);
2252         if (!sv.active  || i < 0 || i >= svs.maxclients || !svs.clients[i].active)
2253         {
2254                 VM_Warning("VM_clientcommand: %s: invalid client/server is not active !\n", PRVM_NAME);
2255                 return;
2256         }
2257
2258         temp_client = host_client;
2259         host_client = svs.clients + i;
2260         Cmd_ExecuteString (PRVM_G_STRING(OFS_PARM1), src_client);
2261         host_client = temp_client;
2262 }
2263
2264
2265 /*
2266 =========
2267 VM_tokenize
2268
2269 float tokenize(string s)
2270 =========
2271 */
2272 //float(string s) tokenize = #441; // takes apart a string into individal words (access them with argv), returns how many
2273 //this function originally written by KrimZon, made shorter by LordHavoc
2274 //20040203: rewritten by LordHavoc (no longer uses allocations)
2275 int num_tokens = 0;
2276 int tokens[256];
2277 void VM_tokenize (void)
2278 {
2279         const char *p;
2280         static char string[VM_STRINGTEMP_LENGTH]; // static, because it's big
2281
2282         VM_SAFEPARMCOUNT(1,VM_tokenize);
2283
2284         strlcpy(string, PRVM_G_STRING(OFS_PARM0), sizeof(string));
2285         p = string;
2286
2287         num_tokens = 0;
2288         while(COM_ParseToken_VM_Tokenize(&p, false))
2289         {
2290                 if (num_tokens >= (int)(sizeof(tokens)/sizeof(tokens[0])))
2291                         break;
2292                 tokens[num_tokens++] = PRVM_SetTempString(com_token);
2293         }
2294
2295         PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2296 }
2297
2298 /*
2299 =========
2300 VM_tokenizebyseparator
2301
2302 float tokenizebyseparator(string s, string separator1, ...)
2303 =========
2304 */
2305 //float(string s, string separator1, ...) tokenizebyseparator = #479; // takes apart a string into individal words (access them with argv), returns how many
2306 //this function returns the token preceding each instance of a separator (of
2307 //which there can be multiple), and the text following the last separator
2308 //useful for parsing certain kinds of data like IP addresses
2309 //example:
2310 //numnumbers = tokenizebyseparator("10.1.2.3", ".");
2311 //returns 4 and the tokens "10" "1" "2" "3".
2312 void VM_tokenizebyseparator (void)
2313 {
2314         int j, k;
2315         int numseparators;
2316         int separatorlen[7];
2317         const char *separators[7];
2318         const char *p;
2319         const char *token;
2320         char tokentext[MAX_INPUTLINE];
2321         static char string[VM_STRINGTEMP_LENGTH]; // static, because it's big
2322
2323         VM_SAFEPARMCOUNTRANGE(2, 8,VM_tokenizebyseparator);
2324
2325         strlcpy(string, PRVM_G_STRING(OFS_PARM0), sizeof(string));
2326         p = string;
2327
2328         numseparators = 0;
2329         for (j = 1;j < prog->argc;j++)
2330         {
2331                 // skip any blank separator strings
2332                 const char *s = PRVM_G_STRING(OFS_PARM0+j*3);
2333                 if (!s[0])
2334                         continue;
2335                 separators[numseparators] = s;
2336                 separatorlen[numseparators] = strlen(s);
2337                 numseparators++;
2338         }
2339
2340         num_tokens = 0;
2341         j = 0;
2342
2343         while (num_tokens < (int)(sizeof(tokens)/sizeof(tokens[0])))
2344         {
2345                 token = tokentext + j;
2346                 while (*p)
2347                 {
2348                         for (k = 0;k < numseparators;k++)
2349                         {
2350                                 if (!strncmp(p, separators[k], separatorlen[k]))
2351                                 {
2352                                         p += separatorlen[k];
2353                                         break;
2354                                 }
2355                         }
2356                         if (k < numseparators)
2357                                 break;
2358                         if (j < (int)sizeof(tokentext)-1)
2359                                 tokentext[j++] = *p;
2360                         p++;
2361                 }
2362                 if (j >= (int)sizeof(tokentext))
2363                         break;
2364                 tokentext[j++] = 0;
2365                 tokens[num_tokens++] = PRVM_SetTempString(token);
2366                 if (!*p)
2367                         break;
2368         }
2369
2370         PRVM_G_FLOAT(OFS_RETURN) = num_tokens;
2371 }
2372
2373 //string(float n) argv = #442; // returns a word from the tokenized string (returns nothing for an invalid index)
2374 //this function originally written by KrimZon, made shorter by LordHavoc
2375 void VM_argv (void)
2376 {
2377         int token_num;
2378
2379         VM_SAFEPARMCOUNT(1,VM_argv);
2380
2381         token_num = (int)PRVM_G_FLOAT(OFS_PARM0);
2382
2383         if (token_num >= 0 && token_num < num_tokens)
2384                 PRVM_G_INT(OFS_RETURN) = tokens[token_num];
2385         else
2386                 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2387 }
2388
2389 /*
2390 =========
2391 VM_isserver
2392
2393 float   isserver()
2394 =========
2395 */
2396 void VM_isserver(void)
2397 {
2398         VM_SAFEPARMCOUNT(0,VM_serverstate);
2399
2400         PRVM_G_FLOAT(OFS_RETURN) = sv.active && (svs.maxclients > 1 || cls.state == ca_dedicated);
2401 }
2402
2403 /*
2404 =========
2405 VM_clientcount
2406
2407 float   clientcount()
2408 =========
2409 */
2410 void VM_clientcount(void)
2411 {
2412         VM_SAFEPARMCOUNT(0,VM_clientcount);
2413
2414         PRVM_G_FLOAT(OFS_RETURN) = svs.maxclients;
2415 }
2416
2417 /*
2418 =========
2419 VM_clientstate
2420
2421 float   clientstate()
2422 =========
2423 */
2424 void VM_clientstate(void)
2425 {
2426         VM_SAFEPARMCOUNT(0,VM_clientstate);
2427
2428
2429         switch( cls.state ) {
2430                 case ca_uninitialized:
2431                 case ca_dedicated:
2432                         PRVM_G_FLOAT(OFS_RETURN) = 0;
2433                         break;
2434                 case ca_disconnected:
2435                         PRVM_G_FLOAT(OFS_RETURN) = 1;
2436                         break;
2437                 case ca_connected:
2438                         PRVM_G_FLOAT(OFS_RETURN) = 2;
2439                         break;
2440                 default:
2441                         // should never be reached!
2442                         break;
2443         }
2444 }
2445
2446 /*
2447 =========
2448 VM_getostype
2449
2450 float   getostype(void)
2451 =========
2452 */ // not used at the moment -> not included in the common list
2453 void VM_getostype(void)
2454 {
2455         VM_SAFEPARMCOUNT(0,VM_getostype);
2456
2457         /*
2458         OS_WINDOWS
2459         OS_LINUX
2460         OS_MAC - not supported
2461         */
2462
2463 #ifdef WIN32
2464         PRVM_G_FLOAT(OFS_RETURN) = 0;
2465 #elif defined(MACOSX)
2466         PRVM_G_FLOAT(OFS_RETURN) = 2;
2467 #else
2468         PRVM_G_FLOAT(OFS_RETURN) = 1;
2469 #endif
2470 }
2471
2472 /*
2473 =========
2474 VM_gettime
2475
2476 float   gettime(void)
2477 =========
2478 */
2479 void VM_gettime(void)
2480 {
2481         VM_SAFEPARMCOUNT(0,VM_gettime);
2482
2483         PRVM_G_FLOAT(OFS_RETURN) = (float) realtime;
2484 }
2485
2486 /*
2487 =========
2488 VM_loadfromdata
2489
2490 loadfromdata(string data)
2491 =========
2492 */
2493 void VM_loadfromdata(void)
2494 {
2495         VM_SAFEPARMCOUNT(1,VM_loadentsfromfile);
2496
2497         PRVM_ED_LoadFromFile(PRVM_G_STRING(OFS_PARM0));
2498 }
2499
2500 /*
2501 ========================
2502 VM_parseentitydata
2503
2504 parseentitydata(entity ent, string data)
2505 ========================
2506 */
2507 void VM_parseentitydata(void)
2508 {
2509         prvm_edict_t *ent;
2510         const char *data;
2511
2512         VM_SAFEPARMCOUNT(2, VM_parseentitydata);
2513
2514         // get edict and test it
2515         ent = PRVM_G_EDICT(OFS_PARM0);
2516         if (ent->priv.required->free)
2517                 PRVM_ERROR ("VM_parseentitydata: %s: Can only set already spawned entities (entity %i is free)!", PRVM_NAME, PRVM_NUM_FOR_EDICT(ent));
2518
2519         data = PRVM_G_STRING(OFS_PARM1);
2520
2521         // parse the opening brace
2522         if (!COM_ParseToken_Simple(&data, false, false) || com_token[0] != '{' )
2523                 PRVM_ERROR ("VM_parseentitydata: %s: Couldn't parse entity data:\n%s", PRVM_NAME, data );
2524
2525         PRVM_ED_ParseEdict (data, ent);
2526 }
2527
2528 /*
2529 =========
2530 VM_loadfromfile
2531
2532 loadfromfile(string file)
2533 =========
2534 */
2535 void VM_loadfromfile(void)
2536 {
2537         const char *filename;
2538         char *data;
2539
2540         VM_SAFEPARMCOUNT(1,VM_loadfromfile);
2541
2542         filename = PRVM_G_STRING(OFS_PARM0);
2543         if (FS_CheckNastyPath(filename, false))
2544         {
2545                 PRVM_G_FLOAT(OFS_RETURN) = -4;
2546                 VM_Warning("VM_loadfromfile: %s dangerous or non-portable filename \"%s\" not allowed. (contains : or \\ or begins with .. or /)\n", PRVM_NAME, filename);
2547                 return;
2548         }
2549
2550         // not conform with VM_fopen
2551         data = (char *)FS_LoadFile(filename, tempmempool, false, NULL);
2552         if (data == NULL)
2553                 PRVM_G_FLOAT(OFS_RETURN) = -1;
2554
2555         PRVM_ED_LoadFromFile(data);
2556
2557         if(data)
2558                 Mem_Free(data);
2559 }
2560
2561
2562 /*
2563 =========
2564 VM_modulo
2565
2566 float   mod(float val, float m)
2567 =========
2568 */
2569 void VM_modulo(void)
2570 {
2571         int val, m;
2572         VM_SAFEPARMCOUNT(2,VM_module);
2573
2574         val = (int) PRVM_G_FLOAT(OFS_PARM0);
2575         m       = (int) PRVM_G_FLOAT(OFS_PARM1);
2576
2577         PRVM_G_FLOAT(OFS_RETURN) = (float) (val % m);
2578 }
2579
2580 void VM_Search_Init(void)
2581 {
2582         int i;
2583         for (i = 0;i < PRVM_MAX_OPENSEARCHES;i++)
2584                 prog->opensearches[i] = NULL;
2585 }
2586
2587 void VM_Search_Reset(void)
2588 {
2589         int i;
2590         // reset the fssearch list
2591         for(i = 0; i < PRVM_MAX_OPENSEARCHES; i++)
2592         {
2593                 if(prog->opensearches[i])
2594                         FS_FreeSearch(prog->opensearches[i]);
2595                 prog->opensearches[i] = NULL;
2596         }
2597 }
2598
2599 /*
2600 =========
2601 VM_search_begin
2602
2603 float search_begin(string pattern, float caseinsensitive, float quiet)
2604 =========
2605 */
2606 void VM_search_begin(void)
2607 {
2608         int handle;
2609         const char *pattern;
2610         int caseinsens, quiet;
2611
2612         VM_SAFEPARMCOUNT(3, VM_search_begin);
2613
2614         pattern = PRVM_G_STRING(OFS_PARM0);
2615
2616         VM_CheckEmptyString(pattern);
2617
2618         caseinsens = (int)PRVM_G_FLOAT(OFS_PARM1);
2619         quiet = (int)PRVM_G_FLOAT(OFS_PARM2);
2620
2621         for(handle = 0; handle < PRVM_MAX_OPENSEARCHES; handle++)
2622                 if(!prog->opensearches[handle])
2623                         break;
2624
2625         if(handle >= PRVM_MAX_OPENSEARCHES)
2626         {
2627                 PRVM_G_FLOAT(OFS_RETURN) = -2;
2628                 VM_Warning("VM_search_begin: %s ran out of search handles (%i)\n", PRVM_NAME, PRVM_MAX_OPENSEARCHES);
2629                 return;
2630         }
2631
2632         if(!(prog->opensearches[handle] = FS_Search(pattern,caseinsens, quiet)))
2633                 PRVM_G_FLOAT(OFS_RETURN) = -1;
2634         else
2635         {
2636                 prog->opensearches_origin[handle] = PRVM_AllocationOrigin();
2637                 PRVM_G_FLOAT(OFS_RETURN) = handle;
2638         }
2639 }
2640
2641 /*
2642 =========
2643 VM_search_end
2644
2645 void    search_end(float handle)
2646 =========
2647 */
2648 void VM_search_end(void)
2649 {
2650         int handle;
2651         VM_SAFEPARMCOUNT(1, VM_search_end);
2652
2653         handle = (int)PRVM_G_FLOAT(OFS_PARM0);
2654
2655         if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
2656         {
2657                 VM_Warning("VM_search_end: invalid handle %i used in %s\n", handle, PRVM_NAME);
2658                 return;
2659         }
2660         if(prog->opensearches[handle] == NULL)
2661         {
2662                 VM_Warning("VM_search_end: no such handle %i in %s\n", handle, PRVM_NAME);
2663                 return;
2664         }
2665
2666         FS_FreeSearch(prog->opensearches[handle]);
2667         prog->opensearches[handle] = NULL;
2668         if(prog->opensearches_origin[handle])
2669                 PRVM_Free((char *)prog->opensearches_origin[handle]);
2670 }
2671
2672 /*
2673 =========
2674 VM_search_getsize
2675
2676 float   search_getsize(float handle)
2677 =========
2678 */
2679 void VM_search_getsize(void)
2680 {
2681         int handle;
2682         VM_SAFEPARMCOUNT(1, VM_M_search_getsize);
2683
2684         handle = (int)PRVM_G_FLOAT(OFS_PARM0);
2685
2686         if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
2687         {
2688                 VM_Warning("VM_search_getsize: invalid handle %i used in %s\n", handle, PRVM_NAME);
2689                 return;
2690         }
2691         if(prog->opensearches[handle] == NULL)
2692         {
2693                 VM_Warning("VM_search_getsize: no such handle %i in %s\n", handle, PRVM_NAME);
2694                 return;
2695         }
2696
2697         PRVM_G_FLOAT(OFS_RETURN) = prog->opensearches[handle]->numfilenames;
2698 }
2699
2700 /*
2701 =========
2702 VM_search_getfilename
2703
2704 string  search_getfilename(float handle, float num)
2705 =========
2706 */
2707 void VM_search_getfilename(void)
2708 {
2709         int handle, filenum;
2710         VM_SAFEPARMCOUNT(2, VM_search_getfilename);
2711
2712         handle = (int)PRVM_G_FLOAT(OFS_PARM0);
2713         filenum = (int)PRVM_G_FLOAT(OFS_PARM1);
2714
2715         if(handle < 0 || handle >= PRVM_MAX_OPENSEARCHES)
2716         {
2717                 VM_Warning("VM_search_getfilename: invalid handle %i used in %s\n", handle, PRVM_NAME);
2718                 return;
2719         }
2720         if(prog->opensearches[handle] == NULL)
2721         {
2722                 VM_Warning("VM_search_getfilename: no such handle %i in %s\n", handle, PRVM_NAME);
2723                 return;
2724         }
2725         if(filenum < 0 || filenum >= prog->opensearches[handle]->numfilenames)
2726         {
2727                 VM_Warning("VM_search_getfilename: invalid filenum %i in %s\n", filenum, PRVM_NAME);
2728                 return;
2729         }
2730
2731         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(prog->opensearches[handle]->filenames[filenum]);
2732 }
2733
2734 /*
2735 =========
2736 VM_chr
2737
2738 string  chr(float ascii)
2739 =========
2740 */
2741 void VM_chr(void)
2742 {
2743         char tmp[2];
2744         VM_SAFEPARMCOUNT(1, VM_chr);
2745
2746         tmp[0] = (unsigned char) PRVM_G_FLOAT(OFS_PARM0);
2747         tmp[1] = 0;
2748
2749         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(tmp);
2750 }
2751
2752 //=============================================================================
2753 // Draw builtins (client & menu)
2754
2755 /*
2756 =========
2757 VM_iscachedpic
2758
2759 float   iscachedpic(string pic)
2760 =========
2761 */
2762 void VM_iscachedpic(void)
2763 {
2764         VM_SAFEPARMCOUNT(1,VM_iscachedpic);
2765
2766         // drawq hasnt such a function, thus always return true
2767         PRVM_G_FLOAT(OFS_RETURN) = false;
2768 }
2769
2770 /*
2771 =========
2772 VM_precache_pic
2773
2774 string  precache_pic(string pic)
2775 =========
2776 */
2777 void VM_precache_pic(void)
2778 {
2779         const char      *s;
2780
2781         VM_SAFEPARMCOUNT(1, VM_precache_pic);
2782
2783         s = PRVM_G_STRING(OFS_PARM0);
2784         PRVM_G_INT(OFS_RETURN) = PRVM_G_INT(OFS_PARM0);
2785         VM_CheckEmptyString (s);
2786
2787         // AK Draw_CachePic is supposed to always return a valid pointer
2788         if( Draw_CachePic_Flags(s, CACHEPICFLAG_NOTPERSISTENT)->tex == r_texture_notexture )
2789                 PRVM_G_INT(OFS_RETURN) = OFS_NULL;
2790 }
2791
2792 /*
2793 =========
2794 VM_freepic
2795
2796 freepic(string s)
2797 =========
2798 */
2799 void VM_freepic(void)
2800 {
2801         const char *s;
2802
2803         VM_SAFEPARMCOUNT(1,VM_freepic);
2804
2805         s = PRVM_G_STRING(OFS_PARM0);
2806         VM_CheckEmptyString (s);
2807
2808         Draw_FreePic(s);
2809 }
2810
2811 dp_font_t *getdrawfont()
2812 {
2813         if(prog->globaloffsets.drawfont >= 0)
2814         {
2815                 int f = PRVM_G_FLOAT(prog->globaloffsets.drawfont);
2816                 if(f < 0 || f >= MAX_FONTS)
2817                         return FONT_DEFAULT;
2818                 return &dp_fonts[f];
2819         }
2820         else
2821                 return FONT_DEFAULT;
2822 }
2823
2824 /*
2825 =========
2826 VM_drawcharacter
2827
2828 float   drawcharacter(vector position, float character, vector scale, vector rgb, float alpha, float flag)
2829 =========
2830 */
2831 void VM_drawcharacter(void)
2832 {
2833         float *pos,*scale,*rgb;
2834         char   character;
2835         int flag;
2836         VM_SAFEPARMCOUNT(6,VM_drawcharacter);
2837
2838         character = (char) PRVM_G_FLOAT(OFS_PARM1);
2839         if(character == 0)
2840         {
2841                 PRVM_G_FLOAT(OFS_RETURN) = -1;
2842                 VM_Warning("VM_drawcharacter: %s passed null character !\n",PRVM_NAME);
2843                 return;
2844         }
2845
2846         pos = PRVM_G_VECTOR(OFS_PARM0);
2847         scale = PRVM_G_VECTOR(OFS_PARM2);
2848         rgb = PRVM_G_VECTOR(OFS_PARM3);
2849         flag = (int)PRVM_G_FLOAT(OFS_PARM5);
2850
2851         if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
2852         {
2853                 PRVM_G_FLOAT(OFS_RETURN) = -2;
2854                 VM_Warning("VM_drawcharacter: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
2855                 return;
2856         }
2857
2858         if(pos[2] || scale[2])
2859                 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")));
2860
2861         if(!scale[0] || !scale[1])
2862         {
2863                 PRVM_G_FLOAT(OFS_RETURN) = -3;
2864                 VM_Warning("VM_drawcharacter: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
2865                 return;
2866         }
2867
2868         DrawQ_String_Font(pos[0], pos[1], &character, 1, scale[0], scale[1], rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM4), flag, NULL, true, getdrawfont());
2869         PRVM_G_FLOAT(OFS_RETURN) = 1;
2870 }
2871
2872 /*
2873 =========
2874 VM_drawstring
2875
2876 float   drawstring(vector position, string text, vector scale, vector rgb, float alpha, float flag)
2877 =========
2878 */
2879 void VM_drawstring(void)
2880 {
2881         float *pos,*scale,*rgb;
2882         const char  *string;
2883         int flag;
2884         VM_SAFEPARMCOUNT(6,VM_drawstring);
2885
2886         string = PRVM_G_STRING(OFS_PARM1);
2887         pos = PRVM_G_VECTOR(OFS_PARM0);
2888         scale = PRVM_G_VECTOR(OFS_PARM2);
2889         rgb = PRVM_G_VECTOR(OFS_PARM3);
2890         flag = (int)PRVM_G_FLOAT(OFS_PARM5);
2891
2892         if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
2893         {
2894                 PRVM_G_FLOAT(OFS_RETURN) = -2;
2895                 VM_Warning("VM_drawstring: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
2896                 return;
2897         }
2898
2899         if(!scale[0] || !scale[1])
2900         {
2901                 PRVM_G_FLOAT(OFS_RETURN) = -3;
2902                 VM_Warning("VM_drawstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
2903                 return;
2904         }
2905
2906         if(pos[2] || scale[2])
2907                 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")));
2908
2909         DrawQ_String_Font(pos[0], pos[1], string, 0, scale[0], scale[1], rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM4), flag, NULL, true, getdrawfont());
2910         PRVM_G_FLOAT(OFS_RETURN) = 1;
2911 }
2912
2913 /*
2914 =========
2915 VM_drawcolorcodedstring
2916
2917 float   drawcolorcodedstring(vector position, string text, vector scale, float alpha, float flag)
2918 =========
2919 */
2920 void VM_drawcolorcodedstring(void)
2921 {
2922         float *pos,*scale;
2923         const char  *string;
2924         int flag,color;
2925         VM_SAFEPARMCOUNT(5,VM_drawstring);
2926
2927         string = PRVM_G_STRING(OFS_PARM1);
2928         pos = PRVM_G_VECTOR(OFS_PARM0);
2929         scale = PRVM_G_VECTOR(OFS_PARM2);
2930         flag = (int)PRVM_G_FLOAT(OFS_PARM4);
2931
2932         if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
2933         {
2934                 PRVM_G_FLOAT(OFS_RETURN) = -2;
2935                 VM_Warning("VM_drawcolorcodedstring: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
2936                 return;
2937         }
2938
2939         if(!scale[0] || !scale[1])
2940         {
2941                 PRVM_G_FLOAT(OFS_RETURN) = -3;
2942                 VM_Warning("VM_drawcolorcodedstring: scale %s is null !\n", (scale[0] == 0) ? ((scale[1] == 0) ? "x and y" : "x") : "y");
2943                 return;
2944         }
2945
2946         if(pos[2] || scale[2])
2947                 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")));
2948
2949         color = -1;
2950         DrawQ_String_Font(pos[0], pos[1], string, 0, scale[0], scale[1], 1, 1, 1, PRVM_G_FLOAT(OFS_PARM3), flag, NULL, false, getdrawfont());
2951         PRVM_G_FLOAT(OFS_RETURN) = 1;
2952 }
2953 /*
2954 =========
2955 VM_stringwidth
2956
2957 float   stringwidth(string text, float allowColorCodes)
2958 =========
2959 */
2960 void VM_stringwidth(void)
2961 {
2962         const char  *string;
2963         int colors;
2964         VM_SAFEPARMCOUNT(2,VM_drawstring);
2965
2966         string = PRVM_G_STRING(OFS_PARM0);
2967         colors = (int)PRVM_G_FLOAT(OFS_PARM1);
2968
2969         PRVM_G_FLOAT(OFS_RETURN) = DrawQ_TextWidth_Font(string, 0, !colors, getdrawfont()); // 1x1 characters, don't actually draw
2970 }
2971 /*
2972 =========
2973 VM_drawpic
2974
2975 float   drawpic(vector position, string pic, vector size, vector rgb, float alpha, float flag)
2976 =========
2977 */
2978 void VM_drawpic(void)
2979 {
2980         const char *picname;
2981         float *size, *pos, *rgb;
2982         int flag;
2983
2984         VM_SAFEPARMCOUNT(6,VM_drawpic);
2985
2986         picname = PRVM_G_STRING(OFS_PARM1);
2987         VM_CheckEmptyString (picname);
2988
2989         // is pic cached ? no function yet for that
2990         if(!1)
2991         {
2992                 PRVM_G_FLOAT(OFS_RETURN) = -4;
2993                 VM_Warning("VM_drawpic: %s: %s not cached !\n", PRVM_NAME, picname);
2994                 return;
2995         }
2996
2997         pos = PRVM_G_VECTOR(OFS_PARM0);
2998         size = PRVM_G_VECTOR(OFS_PARM2);
2999         rgb = PRVM_G_VECTOR(OFS_PARM3);
3000         flag = (int) PRVM_G_FLOAT(OFS_PARM5);
3001
3002         if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3003         {
3004                 PRVM_G_FLOAT(OFS_RETURN) = -2;
3005                 VM_Warning("VM_drawpic: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3006                 return;
3007         }
3008
3009         if(pos[2] || size[2])
3010                 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")));
3011
3012         DrawQ_Pic(pos[0], pos[1], Draw_CachePic (picname), size[0], size[1], rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM4), flag);
3013         PRVM_G_FLOAT(OFS_RETURN) = 1;
3014 }
3015 /*
3016 =========
3017 VM_drawsubpic
3018
3019 float   drawsubpic(vector position, vector size, string pic, vector srcPos, vector srcSize, vector rgb, float alpha, float flag)
3020
3021 =========
3022 */
3023 void VM_drawsubpic(void)
3024 {
3025         const char *picname;
3026         float *size, *pos, *rgb, *srcPos, *srcSize, alpha;
3027         int flag;
3028
3029         VM_SAFEPARMCOUNT(8,VM_drawsubpic);
3030
3031         picname = PRVM_G_STRING(OFS_PARM2);
3032         VM_CheckEmptyString (picname);
3033
3034         // is pic cached ? no function yet for that
3035         if(!1)
3036         {
3037                 PRVM_G_FLOAT(OFS_RETURN) = -4;
3038                 VM_Warning("VM_drawsubpic: %s: %s not cached !\n", PRVM_NAME, picname);
3039                 return;
3040         }
3041
3042         pos = PRVM_G_VECTOR(OFS_PARM0);
3043         size = PRVM_G_VECTOR(OFS_PARM1);
3044         srcPos = PRVM_G_VECTOR(OFS_PARM3);
3045         srcSize = PRVM_G_VECTOR(OFS_PARM4);
3046         rgb = PRVM_G_VECTOR(OFS_PARM5);
3047         alpha = PRVM_G_FLOAT(OFS_PARM6);
3048         flag = (int) PRVM_G_FLOAT(OFS_PARM7);
3049
3050         if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3051         {
3052                 PRVM_G_FLOAT(OFS_RETURN) = -2;
3053                 VM_Warning("VM_drawsubpic: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3054                 return;
3055         }
3056
3057         if(pos[2] || size[2])
3058                 Con_Printf("VM_drawsubpic: z value%s from %s discarded\n",(pos[2] && size[2]) ? "s" : " ",((pos[2] && size[2]) ? "pos and size" : (pos[2] ? "pos" : "size")));
3059
3060         DrawQ_SuperPic(pos[0], pos[1], Draw_CachePic (picname),
3061                 size[0], size[1],
3062                 srcPos[0],              srcPos[1],              rgb[0], rgb[1], rgb[2], alpha,
3063                 srcPos[0] + srcSize[0], srcPos[1],              rgb[0], rgb[1], rgb[2], alpha,
3064                 srcPos[0],              srcPos[1] + srcSize[1], rgb[0], rgb[1], rgb[2], alpha,
3065                 srcPos[0] + srcSize[0], srcPos[1] + srcSize[1], rgb[0], rgb[1], rgb[2], alpha,
3066                 flag);
3067         PRVM_G_FLOAT(OFS_RETURN) = 1;
3068 }
3069
3070 /*
3071 =========
3072 VM_drawfill
3073
3074 float drawfill(vector position, vector size, vector rgb, float alpha, float flag)
3075 =========
3076 */
3077 void VM_drawfill(void)
3078 {
3079         float *size, *pos, *rgb;
3080         int flag;
3081
3082         VM_SAFEPARMCOUNT(5,VM_drawfill);
3083
3084
3085         pos = PRVM_G_VECTOR(OFS_PARM0);
3086         size = PRVM_G_VECTOR(OFS_PARM1);
3087         rgb = PRVM_G_VECTOR(OFS_PARM2);
3088         flag = (int) PRVM_G_FLOAT(OFS_PARM4);
3089
3090         if(flag < DRAWFLAG_NORMAL || flag >=DRAWFLAG_NUMFLAGS)
3091         {
3092                 PRVM_G_FLOAT(OFS_RETURN) = -2;
3093                 VM_Warning("VM_drawfill: %s: wrong DRAWFLAG %i !\n",PRVM_NAME,flag);
3094                 return;
3095         }
3096
3097         if(pos[2] || size[2])
3098                 Con_Printf("VM_drawfill: z value%s from %s discarded\n",(pos[2] && size[2]) ? "s" : " ",((pos[2] && size[2]) ? "pos and size" : (pos[2] ? "pos" : "size")));
3099
3100         DrawQ_Fill(pos[0], pos[1], size[0], size[1], rgb[0], rgb[1], rgb[2], PRVM_G_FLOAT(OFS_PARM3), flag);
3101         PRVM_G_FLOAT(OFS_RETURN) = 1;
3102 }
3103
3104 /*
3105 =========
3106 VM_drawsetcliparea
3107
3108 drawsetcliparea(float x, float y, float width, float height)
3109 =========
3110 */
3111 void VM_drawsetcliparea(void)
3112 {
3113         float x,y,w,h;
3114         VM_SAFEPARMCOUNT(4,VM_drawsetcliparea);
3115
3116         x = bound(0, PRVM_G_FLOAT(OFS_PARM0), vid_conwidth.integer);
3117         y = bound(0, PRVM_G_FLOAT(OFS_PARM1), vid_conheight.integer);
3118         w = bound(0, PRVM_G_FLOAT(OFS_PARM2) + PRVM_G_FLOAT(OFS_PARM0) - x, (vid_conwidth.integer  - x));
3119         h = bound(0, PRVM_G_FLOAT(OFS_PARM3) + PRVM_G_FLOAT(OFS_PARM1) - y, (vid_conheight.integer - y));
3120
3121         DrawQ_SetClipArea(x, y, w, h);
3122 }
3123
3124 /*
3125 =========
3126 VM_drawresetcliparea
3127
3128 drawresetcliparea()
3129 =========
3130 */
3131 void VM_drawresetcliparea(void)
3132 {
3133         VM_SAFEPARMCOUNT(0,VM_drawresetcliparea);
3134
3135         DrawQ_ResetClipArea();
3136 }
3137
3138 /*
3139 =========
3140 VM_getimagesize
3141
3142 vector  getimagesize(string pic)
3143 =========
3144 */
3145 void VM_getimagesize(void)
3146 {
3147         const char *p;
3148         cachepic_t *pic;
3149
3150         VM_SAFEPARMCOUNT(1,VM_getimagesize);
3151
3152         p = PRVM_G_STRING(OFS_PARM0);
3153         VM_CheckEmptyString (p);
3154
3155         pic = Draw_CachePic_Flags (p, CACHEPICFLAG_NOTPERSISTENT);
3156
3157         PRVM_G_VECTOR(OFS_RETURN)[0] = pic->width;
3158         PRVM_G_VECTOR(OFS_RETURN)[1] = pic->height;
3159         PRVM_G_VECTOR(OFS_RETURN)[2] = 0;
3160 }
3161
3162 /*
3163 =========
3164 VM_keynumtostring
3165
3166 string keynumtostring(float keynum)
3167 =========
3168 */
3169 void VM_keynumtostring (void)
3170 {
3171         VM_SAFEPARMCOUNT(1, VM_keynumtostring);
3172
3173         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(Key_KeynumToString((int)PRVM_G_FLOAT(OFS_PARM0)));
3174 }
3175
3176 /*
3177 =========
3178 VM_findkeysforcommand
3179
3180 string  findkeysforcommand(string command)
3181
3182 the returned string is an altstring
3183 =========
3184 */
3185 #define NUMKEYS 5 // TODO: merge the constant in keys.c with this one somewhen
3186
3187 void M_FindKeysForCommand(const char *command, int *keys);
3188 void VM_findkeysforcommand(void)
3189 {
3190         const char *cmd;
3191         char ret[VM_STRINGTEMP_LENGTH];
3192         int keys[NUMKEYS];
3193         int i;
3194
3195         VM_SAFEPARMCOUNT(1, VM_findkeysforcommand);
3196
3197         cmd = PRVM_G_STRING(OFS_PARM0);
3198
3199         VM_CheckEmptyString(cmd);
3200
3201         M_FindKeysForCommand(cmd, keys);
3202
3203         ret[0] = 0;
3204         for(i = 0; i < NUMKEYS; i++)
3205                 strlcat(ret, va(" \'%i\'", keys[i]), sizeof(ret));
3206
3207         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(ret);
3208 }
3209
3210 /*
3211 =========
3212 VM_stringtokeynum
3213
3214 float stringtokeynum(string key)
3215 =========
3216 */
3217 void VM_stringtokeynum (void)
3218 {
3219         VM_SAFEPARMCOUNT( 1, VM_keynumtostring );
3220
3221         PRVM_G_INT(OFS_RETURN) = Key_StringToKeynum(PRVM_G_STRING(OFS_PARM0));
3222 }
3223
3224 // CL_Video interface functions
3225
3226 /*
3227 ========================
3228 VM_cin_open
3229
3230 float cin_open(string file, string name)
3231 ========================
3232 */
3233 void VM_cin_open( void )
3234 {
3235         const char *file;
3236         const char *name;
3237
3238         VM_SAFEPARMCOUNT( 2, VM_cin_open );
3239
3240         file = PRVM_G_STRING( OFS_PARM0 );
3241         name = PRVM_G_STRING( OFS_PARM1 );
3242
3243         VM_CheckEmptyString( file );
3244     VM_CheckEmptyString( name );
3245
3246         if( CL_OpenVideo( file, name, MENUOWNER ) )
3247                 PRVM_G_FLOAT( OFS_RETURN ) = 1;
3248         else
3249                 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3250 }
3251
3252 /*
3253 ========================
3254 VM_cin_close
3255
3256 void cin_close(string name)
3257 ========================
3258 */
3259 void VM_cin_close( void )
3260 {
3261         const char *name;
3262
3263         VM_SAFEPARMCOUNT( 1, VM_cin_close );
3264
3265         name = PRVM_G_STRING( OFS_PARM0 );
3266         VM_CheckEmptyString( name );
3267
3268         CL_CloseVideo( CL_GetVideoByName( name ) );
3269 }
3270
3271 /*
3272 ========================
3273 VM_cin_setstate
3274 void cin_setstate(string name, float type)
3275 ========================
3276 */
3277 void VM_cin_setstate( void )
3278 {
3279         const char *name;
3280         clvideostate_t  state;
3281         clvideo_t               *video;
3282
3283         VM_SAFEPARMCOUNT( 2, VM_cin_netstate );
3284
3285         name = PRVM_G_STRING( OFS_PARM0 );
3286         VM_CheckEmptyString( name );
3287
3288         state = (clvideostate_t)((int)PRVM_G_FLOAT( OFS_PARM1 ));
3289
3290         video = CL_GetVideoByName( name );
3291         if( video && state > CLVIDEO_UNUSED && state < CLVIDEO_STATECOUNT )
3292                 CL_SetVideoState( video, state );
3293 }
3294
3295 /*
3296 ========================
3297 VM_cin_getstate
3298
3299 float cin_getstate(string name)
3300 ========================
3301 */
3302 void VM_cin_getstate( void )
3303 {
3304         const char *name;
3305         clvideo_t               *video;
3306
3307         VM_SAFEPARMCOUNT( 1, VM_cin_getstate );
3308
3309         name = PRVM_G_STRING( OFS_PARM0 );
3310         VM_CheckEmptyString( name );
3311
3312         video = CL_GetVideoByName( name );
3313         if( video )
3314                 PRVM_G_FLOAT( OFS_RETURN ) = (int)video->state;
3315         else
3316                 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3317 }
3318
3319 /*
3320 ========================
3321 VM_cin_restart
3322
3323 void cin_restart(string name)
3324 ========================
3325 */
3326 void VM_cin_restart( void )
3327 {
3328         const char *name;
3329         clvideo_t               *video;
3330
3331         VM_SAFEPARMCOUNT( 1, VM_cin_restart );
3332
3333         name = PRVM_G_STRING( OFS_PARM0 );
3334         VM_CheckEmptyString( name );
3335
3336         video = CL_GetVideoByName( name );
3337         if( video )
3338                 CL_RestartVideo( video );
3339 }
3340
3341 /*
3342 ========================
3343 VM_Gecko_Init
3344 ========================
3345 */
3346 void VM_Gecko_Init( void ) {
3347         // the prog struct is memset to 0 by Initprog? [12/6/2007 Black]
3348         // FIXME: remove the other _Init functions then, too? [12/6/2007 Black]
3349 }
3350
3351 /*
3352 ========================
3353 VM_Gecko_Destroy
3354 ========================
3355 */
3356 void VM_Gecko_Destroy( void ) {
3357         int i;
3358         for( i = 0 ; i < PRVM_MAX_GECKOINSTANCES ; i++ ) {
3359                 clgecko_t **instance = &prog->opengeckoinstances[ i ];
3360                 if( *instance ) {
3361                         CL_Gecko_DestroyBrowser( *instance );
3362                 }
3363                 *instance = NULL;
3364         }
3365 }
3366
3367 /*
3368 ========================
3369 VM_gecko_create
3370
3371 float[bool] gecko_create( string name )
3372 ========================
3373 */
3374 void VM_gecko_create( void ) {
3375         const char *name;
3376         int i;
3377         clgecko_t *instance;
3378         
3379         VM_SAFEPARMCOUNT( 1, VM_gecko_create );
3380
3381         name = PRVM_G_STRING( OFS_PARM0 );
3382         VM_CheckEmptyString( name );
3383
3384         // find an empty slot for this gecko browser..
3385         for( i = 0 ; i < PRVM_MAX_GECKOINSTANCES ; i++ ) {
3386                 if( prog->opengeckoinstances[ i ] == NULL ) {
3387                         break;
3388                 }
3389         }
3390         if( i == PRVM_MAX_GECKOINSTANCES ) {
3391                         VM_Warning("VM_gecko_create: %s ran out of gecko handles (%i)\n", PRVM_NAME, PRVM_MAX_GECKOINSTANCES);
3392                         PRVM_G_FLOAT( OFS_RETURN ) = 0;
3393                         return;
3394         }
3395
3396         instance = prog->opengeckoinstances[ i ] = CL_Gecko_CreateBrowser( name, PRVM_GetProgNr() );
3397    if( !instance ) {
3398                 // TODO: error handling [12/3/2007 Black]
3399                 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3400                 return;
3401         }
3402         PRVM_G_FLOAT( OFS_RETURN ) = 1;
3403 }
3404
3405 /*
3406 ========================
3407 VM_gecko_destroy
3408
3409 void gecko_destroy( string name )
3410 ========================
3411 */
3412 void VM_gecko_destroy( void ) {
3413         const char *name;
3414         clgecko_t *instance;
3415
3416         VM_SAFEPARMCOUNT( 1, VM_gecko_destroy );
3417
3418         name = PRVM_G_STRING( OFS_PARM0 );
3419         VM_CheckEmptyString( name );
3420         instance = CL_Gecko_FindBrowser( name );
3421         if( !instance ) {
3422                 return;
3423         }
3424         CL_Gecko_DestroyBrowser( instance );
3425 }
3426
3427 /*
3428 ========================
3429 VM_gecko_navigate
3430
3431 void gecko_navigate( string name, string URI )
3432 ========================
3433 */
3434 void VM_gecko_navigate( void ) {
3435         const char *name;
3436         const char *URI;
3437         clgecko_t *instance;
3438
3439         VM_SAFEPARMCOUNT( 2, VM_gecko_navigate );
3440
3441         name = PRVM_G_STRING( OFS_PARM0 );
3442         URI = PRVM_G_STRING( OFS_PARM1 );
3443         VM_CheckEmptyString( name );
3444         VM_CheckEmptyString( URI );
3445
3446    instance = CL_Gecko_FindBrowser( name );
3447         if( !instance ) {
3448                 return;
3449         }
3450         CL_Gecko_NavigateToURI( instance, URI );
3451 }
3452
3453 /*
3454 ========================
3455 VM_gecko_keyevent
3456
3457 float[bool] gecko_keyevent( string name, float key, float eventtype ) 
3458 ========================
3459 */
3460 void VM_gecko_keyevent( void ) {
3461         const char *name;
3462         unsigned int key;
3463         clgecko_buttoneventtype_t eventtype;
3464         clgecko_t *instance;
3465
3466         VM_SAFEPARMCOUNT( 3, VM_gecko_keyevent );
3467
3468         name = PRVM_G_STRING( OFS_PARM0 );
3469         VM_CheckEmptyString( name );
3470         key = (unsigned int) PRVM_G_FLOAT( OFS_PARM1 );
3471         switch( (unsigned int) PRVM_G_FLOAT( OFS_PARM2 ) ) {
3472         case 0:
3473                 eventtype = CLG_BET_DOWN;
3474                 break;
3475         case 1:
3476                 eventtype = CLG_BET_UP;
3477                 break;
3478         case 2:
3479                 eventtype = CLG_BET_PRESS;
3480                 break;
3481         case 3:
3482                 eventtype = CLG_BET_DOUBLECLICK;
3483                 break;
3484         default:
3485                 // TODO: console printf? [12/3/2007 Black]
3486                 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3487                 return;
3488         }
3489
3490         instance = CL_Gecko_FindBrowser( name );
3491         if( !instance ) {
3492                 PRVM_G_FLOAT( OFS_RETURN ) = 0;
3493                 return;
3494         }
3495
3496         PRVM_G_FLOAT( OFS_RETURN ) = (CL_Gecko_Event_Key( instance, key, eventtype ) == true);
3497 }
3498
3499 /*
3500 ========================
3501 VM_gecko_movemouse
3502
3503 void gecko_mousemove( string name, float x, float y )
3504 ========================
3505 */
3506 void VM_gecko_movemouse( void ) {
3507         const char *name;
3508         float x, y;
3509         clgecko_t *instance;
3510
3511         VM_SAFEPARMCOUNT( 3, VM_gecko_movemouse );
3512
3513         name = PRVM_G_STRING( OFS_PARM0 );
3514         VM_CheckEmptyString( name );
3515         x = PRVM_G_FLOAT( OFS_PARM1 );
3516         y = PRVM_G_FLOAT( OFS_PARM2 );
3517         
3518         instance = CL_Gecko_FindBrowser( name );
3519         if( !instance ) {
3520                 return;
3521         }
3522         CL_Gecko_Event_CursorMove( instance, x, y );
3523 }
3524
3525
3526 /*
3527 ========================
3528 VM_gecko_resize
3529
3530 void gecko_resize( string name, float w, float h )
3531 ========================
3532 */
3533 void VM_gecko_resize( void ) {
3534         const char *name;
3535         float w, h;
3536         clgecko_t *instance;
3537
3538         VM_SAFEPARMCOUNT( 3, VM_gecko_movemouse );
3539
3540         name = PRVM_G_STRING( OFS_PARM0 );
3541         VM_CheckEmptyString( name );
3542         w = PRVM_G_FLOAT( OFS_PARM1 );
3543         h = PRVM_G_FLOAT( OFS_PARM2 );
3544         
3545         instance = CL_Gecko_FindBrowser( name );
3546         if( !instance ) {
3547                 return;
3548         }
3549         CL_Gecko_Resize( instance, w, h );
3550 }
3551
3552
3553 /*
3554 ========================
3555 VM_gecko_get_texture_extent
3556
3557 vector gecko_get_texture_extent( string name )
3558 ========================
3559 */
3560 void VM_gecko_get_texture_extent( void ) {
3561         const char *name;
3562         clgecko_t *instance;
3563
3564         VM_SAFEPARMCOUNT( 1, VM_gecko_movemouse );
3565
3566         name = PRVM_G_STRING( OFS_PARM0 );
3567         VM_CheckEmptyString( name );
3568         
3569         PRVM_G_VECTOR(OFS_RETURN)[2] = 0;
3570         instance = CL_Gecko_FindBrowser( name );
3571         if( !instance ) {
3572                 PRVM_G_VECTOR(OFS_RETURN)[0] = 0;
3573                 PRVM_G_VECTOR(OFS_RETURN)[1] = 0;
3574                 return;
3575         }
3576         CL_Gecko_GetTextureExtent( instance, 
3577                 PRVM_G_VECTOR(OFS_RETURN), PRVM_G_VECTOR(OFS_RETURN)+1 );
3578 }
3579
3580
3581
3582 /*
3583 ==============
3584 VM_makevectors
3585
3586 Writes new values for v_forward, v_up, and v_right based on angles
3587 void makevectors(vector angle)
3588 ==============
3589 */
3590 void VM_makevectors (void)
3591 {
3592         prvm_eval_t *valforward, *valright, *valup;
3593         valforward = PRVM_GLOBALFIELDVALUE(prog->globaloffsets.v_forward);
3594         valright = PRVM_GLOBALFIELDVALUE(prog->globaloffsets.v_right);
3595         valup = PRVM_GLOBALFIELDVALUE(prog->globaloffsets.v_up);
3596         if (!valforward || !valright || !valup)
3597         {
3598                 VM_Warning("makevectors: could not find v_forward, v_right, or v_up global variables\n");
3599                 return;
3600         }
3601         VM_SAFEPARMCOUNT(1, VM_makevectors);
3602         AngleVectors (PRVM_G_VECTOR(OFS_PARM0), valforward->vector, valright->vector, valup->vector);
3603 }
3604
3605 /*
3606 ==============
3607 VM_vectorvectors
3608
3609 Writes new values for v_forward, v_up, and v_right based on the given forward vector
3610 vectorvectors(vector)
3611 ==============
3612 */
3613 void VM_vectorvectors (void)
3614 {
3615         prvm_eval_t *valforward, *valright, *valup;
3616         valforward = PRVM_GLOBALFIELDVALUE(prog->globaloffsets.v_forward);
3617         valright = PRVM_GLOBALFIELDVALUE(prog->globaloffsets.v_right);
3618         valup = PRVM_GLOBALFIELDVALUE(prog->globaloffsets.v_up);
3619         if (!valforward || !valright || !valup)
3620         {
3621                 VM_Warning("vectorvectors: could not find v_forward, v_right, or v_up global variables\n");
3622                 return;
3623         }
3624         VM_SAFEPARMCOUNT(1, VM_vectorvectors);
3625         VectorNormalize2(PRVM_G_VECTOR(OFS_PARM0), valforward->vector);
3626         VectorVectors(valforward->vector, valright->vector, valup->vector);
3627 }
3628
3629 /*
3630 ========================
3631 VM_drawline
3632
3633 void drawline(float width, vector pos1, vector pos2, vector rgb, float alpha, float flags)
3634 ========================
3635 */
3636 void VM_drawline (void)
3637 {
3638         float   *c1, *c2, *rgb;
3639         float   alpha, width;
3640         unsigned char   flags;
3641
3642         VM_SAFEPARMCOUNT(6, VM_drawline);
3643         width   = PRVM_G_FLOAT(OFS_PARM0);
3644         c1              = PRVM_G_VECTOR(OFS_PARM1);
3645         c2              = PRVM_G_VECTOR(OFS_PARM2);
3646         rgb             = PRVM_G_VECTOR(OFS_PARM3);
3647         alpha   = PRVM_G_FLOAT(OFS_PARM4);
3648         flags   = (int)PRVM_G_FLOAT(OFS_PARM5);
3649         DrawQ_Line(width, c1[0], c1[1], c2[0], c2[1], rgb[0], rgb[1], rgb[2], alpha, flags);
3650 }
3651
3652 // float(float number, float quantity) bitshift (EXT_BITSHIFT)
3653 void VM_bitshift (void)
3654 {
3655         int n1, n2;
3656         VM_SAFEPARMCOUNT(2, VM_bitshift);
3657
3658         n1 = (int)fabs((int)PRVM_G_FLOAT(OFS_PARM0));
3659         n2 = (int)PRVM_G_FLOAT(OFS_PARM1);
3660         if(!n1)
3661                 PRVM_G_FLOAT(OFS_RETURN) = n1;
3662         else
3663         if(n2 < 0)
3664                 PRVM_G_FLOAT(OFS_RETURN) = (n1 >> -n2);
3665         else
3666                 PRVM_G_FLOAT(OFS_RETURN) = (n1 << n2);
3667 }
3668
3669 ////////////////////////////////////////
3670 // AltString functions
3671 ////////////////////////////////////////
3672
3673 /*
3674 ========================
3675 VM_altstr_count
3676
3677 float altstr_count(string)
3678 ========================
3679 */
3680 void VM_altstr_count( void )
3681 {
3682         const char *altstr, *pos;
3683         int     count;
3684
3685         VM_SAFEPARMCOUNT( 1, VM_altstr_count );
3686
3687         altstr = PRVM_G_STRING( OFS_PARM0 );
3688         //VM_CheckEmptyString( altstr );
3689
3690         for( count = 0, pos = altstr ; *pos ; pos++ ) {
3691                 if( *pos == '\\' ) {
3692                         if( !*++pos ) {
3693                                 break;
3694                         }
3695                 } else if( *pos == '\'' ) {
3696                         count++;
3697                 }
3698         }
3699
3700         PRVM_G_FLOAT( OFS_RETURN ) = (float) (count / 2);
3701 }
3702
3703 /*
3704 ========================
3705 VM_altstr_prepare
3706
3707 string altstr_prepare(string)
3708 ========================
3709 */
3710 void VM_altstr_prepare( void )
3711 {
3712         char *out;
3713         const char *instr, *in;
3714         int size;
3715         char outstr[VM_STRINGTEMP_LENGTH];
3716
3717         VM_SAFEPARMCOUNT( 1, VM_altstr_prepare );
3718
3719         instr = PRVM_G_STRING( OFS_PARM0 );
3720
3721         for( out = outstr, in = instr, size = sizeof(outstr) - 1 ; size && *in ; size--, in++, out++ )
3722                 if( *in == '\'' ) {
3723                         *out++ = '\\';
3724                         *out = '\'';
3725                         size--;
3726                 } else
3727                         *out = *in;
3728         *out = 0;
3729
3730         PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString( outstr );
3731 }
3732
3733 /*
3734 ========================
3735 VM_altstr_get
3736
3737 string altstr_get(string, float)
3738 ========================
3739 */
3740 void VM_altstr_get( void )
3741 {
3742         const char *altstr, *pos;
3743         char *out;
3744         int count, size;
3745         char outstr[VM_STRINGTEMP_LENGTH];
3746
3747         VM_SAFEPARMCOUNT( 2, VM_altstr_get );
3748
3749         altstr = PRVM_G_STRING( OFS_PARM0 );
3750
3751         count = (int)PRVM_G_FLOAT( OFS_PARM1 );
3752         count = count * 2 + 1;
3753
3754         for( pos = altstr ; *pos && count ; pos++ )
3755                 if( *pos == '\\' ) {
3756                         if( !*++pos )
3757                                 break;
3758                 } else if( *pos == '\'' )
3759                         count--;
3760
3761         if( !*pos ) {
3762                 PRVM_G_INT( OFS_RETURN ) = 0;
3763                 return;
3764         }
3765
3766         for( out = outstr, size = sizeof(outstr) - 1 ; size && *pos ; size--, pos++, out++ )
3767                 if( *pos == '\\' ) {
3768                         if( !*++pos )
3769                                 break;
3770                         *out = *pos;
3771                         size--;
3772                 } else if( *pos == '\'' )
3773                         break;
3774                 else
3775                         *out = *pos;
3776
3777         *out = 0;
3778         PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString( outstr );
3779 }
3780
3781 /*
3782 ========================
3783 VM_altstr_set
3784
3785 string altstr_set(string altstr, float num, string set)
3786 ========================
3787 */
3788 void VM_altstr_set( void )
3789 {
3790     int num;
3791         const char *altstr, *str;
3792         const char *in;
3793         char *out;
3794         char outstr[VM_STRINGTEMP_LENGTH];
3795
3796         VM_SAFEPARMCOUNT( 3, VM_altstr_set );
3797
3798         altstr = PRVM_G_STRING( OFS_PARM0 );
3799
3800         num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3801
3802         str = PRVM_G_STRING( OFS_PARM2 );
3803
3804         out = outstr;
3805         for( num = num * 2 + 1, in = altstr; *in && num; *out++ = *in++ )
3806                 if( *in == '\\' ) {
3807                         if( !*++in ) {
3808                                 break;
3809                         }
3810                 } else if( *in == '\'' ) {
3811                         num--;
3812                 }
3813
3814         // copy set in
3815         for( ; *str; *out++ = *str++ );
3816         // now jump over the old content
3817         for( ; *in ; in++ )
3818                 if( *in == '\'' || (*in == '\\' && !*++in) )
3819                         break;
3820
3821         strlcpy(out, in, outstr + sizeof(outstr) - out);
3822         PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString( outstr );
3823 }
3824
3825 /*
3826 ========================
3827 VM_altstr_ins
3828 insert after num
3829 string  altstr_ins(string altstr, float num, string set)
3830 ========================
3831 */
3832 void VM_altstr_ins(void)
3833 {
3834         int num;
3835         const char *setstr;
3836         const char *set;
3837         const char *instr;
3838         const char *in;
3839         char *out;
3840         char outstr[VM_STRINGTEMP_LENGTH];
3841
3842         VM_SAFEPARMCOUNT(3, VM_altstr_ins);
3843
3844         in = instr = PRVM_G_STRING( OFS_PARM0 );
3845         num = (int)PRVM_G_FLOAT( OFS_PARM1 );
3846         set = setstr = PRVM_G_STRING( OFS_PARM2 );
3847
3848         out = outstr;
3849         for( num = num * 2 + 2 ; *in && num > 0 ; *out++ = *in++ )
3850                 if( *in == '\\' ) {
3851                         if( !*++in ) {
3852                                 break;
3853                         }
3854                 } else if( *in == '\'' ) {
3855                         num--;
3856                 }
3857
3858         *out++ = '\'';
3859         for( ; *set ; *out++ = *set++ );
3860         *out++ = '\'';
3861
3862         strlcpy(out, in, outstr + sizeof(outstr) - out);
3863         PRVM_G_INT( OFS_RETURN ) = PRVM_SetTempString( outstr );
3864 }
3865
3866
3867 ////////////////////////////////////////
3868 // BufString functions
3869 ////////////////////////////////////////
3870 //[515]: string buffers support
3871
3872 static size_t stringbuffers_sortlength;
3873
3874 static void BufStr_Expand(prvm_stringbuffer_t *stringbuffer, int strindex)
3875 {
3876         if (stringbuffer->max_strings <= strindex)
3877         {
3878                 char **oldstrings = stringbuffer->strings;
3879                 stringbuffer->max_strings = max(stringbuffer->max_strings * 2, 128);
3880                 while (stringbuffer->max_strings <= strindex)
3881                         stringbuffer->max_strings *= 2;
3882                 stringbuffer->strings = Mem_Alloc(prog->progs_mempool, stringbuffer->max_strings * sizeof(stringbuffer->strings[0]));
3883                 if (stringbuffer->num_strings > 0)
3884                         memcpy(stringbuffer->strings, oldstrings, stringbuffer->num_strings * sizeof(stringbuffer->strings[0]));
3885                 if (oldstrings)
3886                         Mem_Free(oldstrings);
3887         }
3888 }
3889
3890 static void BufStr_Shrink(prvm_stringbuffer_t *stringbuffer)
3891 {
3892         // reduce num_strings if there are empty string slots at the end
3893         while (stringbuffer->num_strings > 0 && stringbuffer->strings[stringbuffer->num_strings - 1] == NULL)
3894                 stringbuffer->num_strings--;
3895
3896         // if empty, free the string pointer array
3897         if (stringbuffer->num_strings == 0)
3898         {
3899                 stringbuffer->max_strings = 0;
3900                 if (stringbuffer->strings)
3901                         Mem_Free(stringbuffer->strings);
3902                 stringbuffer->strings = NULL;
3903         }
3904 }
3905
3906 static int BufStr_SortStringsUP (const void *in1, const void *in2)
3907 {
3908         const char *a, *b;
3909         a = *((const char **) in1);
3910         b = *((const char **) in2);
3911         if(!a[0])       return 1;
3912         if(!b[0])       return -1;
3913         return strncmp(a, b, stringbuffers_sortlength);
3914 }
3915
3916 static int BufStr_SortStringsDOWN (const void *in1, const void *in2)
3917 {
3918         const char *a, *b;
3919         a = *((const char **) in1);
3920         b = *((const char **) in2);
3921         if(!a[0])       return 1;
3922         if(!b[0])       return -1;
3923         return strncmp(b, a, stringbuffers_sortlength);
3924 }
3925
3926 /*
3927 ========================
3928 VM_buf_create
3929 creates new buffer, and returns it's index, returns -1 if failed
3930 float buf_create(void) = #460;
3931 ========================
3932 */
3933 void VM_buf_create (void)
3934 {
3935         prvm_stringbuffer_t *stringbuffer;
3936         int i;
3937         VM_SAFEPARMCOUNT(0, VM_buf_create);
3938         stringbuffer = Mem_ExpandableArray_AllocRecord(&prog->stringbuffersarray);
3939         for (i = 0;stringbuffer != Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, i);i++);
3940         stringbuffer->origin = PRVM_AllocationOrigin();
3941         PRVM_G_FLOAT(OFS_RETURN) = i;
3942 }
3943
3944 /*
3945 ========================
3946 VM_buf_del
3947 deletes buffer and all strings in it
3948 void buf_del(float bufhandle) = #461;
3949 ========================
3950 */
3951 void VM_buf_del (void)
3952 {
3953         prvm_stringbuffer_t *stringbuffer;
3954         VM_SAFEPARMCOUNT(1, VM_buf_del);
3955         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3956         if (stringbuffer)
3957         {
3958                 int i;
3959                 for (i = 0;i < stringbuffer->num_strings;i++)
3960                         if (stringbuffer->strings[i])
3961                                 Mem_Free(stringbuffer->strings[i]);
3962                 if (stringbuffer->strings)
3963                         Mem_Free(stringbuffer->strings);
3964                 if(stringbuffer->origin)
3965                         PRVM_Free((char *)stringbuffer->origin);
3966                 Mem_ExpandableArray_FreeRecord(&prog->stringbuffersarray, stringbuffer);
3967         }
3968         else
3969         {
3970                 VM_Warning("VM_buf_del: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
3971                 return;
3972         }
3973 }
3974
3975 /*
3976 ========================
3977 VM_buf_getsize
3978 how many strings are stored in buffer
3979 float buf_getsize(float bufhandle) = #462;
3980 ========================
3981 */
3982 void VM_buf_getsize (void)
3983 {
3984         prvm_stringbuffer_t *stringbuffer;
3985         VM_SAFEPARMCOUNT(1, VM_buf_getsize);
3986
3987         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
3988         if(!stringbuffer)
3989         {
3990                 PRVM_G_FLOAT(OFS_RETURN) = -1;
3991                 VM_Warning("VM_buf_getsize: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
3992                 return;
3993         }
3994         else
3995                 PRVM_G_FLOAT(OFS_RETURN) = stringbuffer->num_strings;
3996 }
3997
3998 /*
3999 ========================
4000 VM_buf_copy
4001 copy all content from one buffer to another, make sure it exists
4002 void buf_copy(float bufhandle_from, float bufhandle_to) = #463;
4003 ========================
4004 */
4005 void VM_buf_copy (void)
4006 {
4007         prvm_stringbuffer_t *srcstringbuffer, *dststringbuffer;
4008         int i;
4009         VM_SAFEPARMCOUNT(2, VM_buf_copy);
4010
4011         srcstringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4012         if(!srcstringbuffer)
4013         {
4014                 VM_Warning("VM_buf_copy: invalid source buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4015                 return;
4016         }
4017         i = (int)PRVM_G_FLOAT(OFS_PARM1);
4018         if(i == (int)PRVM_G_FLOAT(OFS_PARM0))
4019         {
4020                 VM_Warning("VM_buf_copy: source == destination (%i) in %s\n", i, PRVM_NAME);
4021                 return;
4022         }
4023         dststringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4024         if(!dststringbuffer)
4025         {
4026                 VM_Warning("VM_buf_copy: invalid destination buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM1), PRVM_NAME);
4027                 return;
4028         }
4029
4030         for (i = 0;i < dststringbuffer->num_strings;i++)
4031                 if (dststringbuffer->strings[i])
4032                         Mem_Free(dststringbuffer->strings[i]);
4033         if (dststringbuffer->strings)
4034                 Mem_Free(dststringbuffer->strings);
4035         *dststringbuffer = *srcstringbuffer;
4036         if (dststringbuffer->max_strings)
4037                 dststringbuffer->strings = (char **)Mem_Alloc(prog->progs_mempool, sizeof(dststringbuffer->strings[0]) * dststringbuffer->max_strings);
4038
4039         for (i = 0;i < dststringbuffer->num_strings;i++)
4040         {
4041                 if (srcstringbuffer->strings[i])
4042                 {
4043                         size_t stringlen;
4044                         stringlen = strlen(srcstringbuffer->strings[i]) + 1;
4045                         dststringbuffer->strings[i] = (char *)Mem_Alloc(prog->progs_mempool, stringlen);
4046                         memcpy(dststringbuffer->strings[i], srcstringbuffer->strings[i], stringlen);
4047                 }
4048         }
4049 }
4050
4051 /*
4052 ========================
4053 VM_buf_sort
4054 sort buffer by beginnings of strings (cmplength defaults it's length)
4055 "backward == TRUE" means that sorting goes upside-down
4056 void buf_sort(float bufhandle, float cmplength, float backward) = #464;
4057 ========================
4058 */
4059 void VM_buf_sort (void)
4060 {
4061         prvm_stringbuffer_t *stringbuffer;
4062         VM_SAFEPARMCOUNT(3, VM_buf_sort);
4063
4064         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4065         if(!stringbuffer)
4066         {
4067                 VM_Warning("VM_buf_sort: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4068                 return;
4069         }
4070         if(stringbuffer->num_strings <= 0)
4071         {
4072                 VM_Warning("VM_buf_sort: tried to sort empty buffer %i in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4073                 return;
4074         }
4075         stringbuffers_sortlength = (int)PRVM_G_FLOAT(OFS_PARM1);
4076         if(stringbuffers_sortlength <= 0)
4077                 stringbuffers_sortlength = 0x7FFFFFFF;
4078
4079         if(!PRVM_G_FLOAT(OFS_PARM2))
4080                 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsUP);
4081         else
4082                 qsort(stringbuffer->strings, stringbuffer->num_strings, sizeof(char*), BufStr_SortStringsDOWN);
4083
4084         BufStr_Shrink(stringbuffer);
4085 }
4086
4087 /*
4088 ========================
4089 VM_buf_implode
4090 concantenates all buffer string into one with "glue" separator and returns it as tempstring
4091 string buf_implode(float bufhandle, string glue) = #465;
4092 ========================
4093 */
4094 void VM_buf_implode (void)
4095 {
4096         prvm_stringbuffer_t *stringbuffer;
4097         char                    k[VM_STRINGTEMP_LENGTH];
4098         const char              *sep;
4099         int                             i;
4100         size_t                  l;
4101         VM_SAFEPARMCOUNT(2, VM_buf_implode);
4102
4103         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4104         PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4105         if(!stringbuffer)
4106         {
4107                 VM_Warning("VM_buf_implode: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4108                 return;
4109         }
4110         if(!stringbuffer->num_strings)
4111                 return;
4112         sep = PRVM_G_STRING(OFS_PARM1);
4113         k[0] = 0;
4114         for(l = i = 0;i < stringbuffer->num_strings;i++)
4115         {
4116                 if(stringbuffer->strings[i])
4117                 {
4118                         l += (i > 0 ? strlen(sep) : 0) + strlen(stringbuffer->strings[i]);
4119                         if (l >= sizeof(k) - 1)
4120                                 break;
4121                         strlcat(k, sep, sizeof(k));
4122                         strlcat(k, stringbuffer->strings[i], sizeof(k));
4123                 }
4124         }
4125         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(k);
4126 }
4127
4128 /*
4129 ========================
4130 VM_bufstr_get
4131 get a string from buffer, returns tempstring, dont str_unzone it!
4132 string bufstr_get(float bufhandle, float string_index) = #465;
4133 ========================
4134 */
4135 void VM_bufstr_get (void)
4136 {
4137         prvm_stringbuffer_t *stringbuffer;
4138         int                             strindex;
4139         VM_SAFEPARMCOUNT(2, VM_bufstr_get);
4140
4141         PRVM_G_INT(OFS_RETURN) = OFS_NULL;
4142         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4143         if(!stringbuffer)
4144         {
4145                 VM_Warning("VM_bufstr_get: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4146                 return;
4147         }
4148         strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4149         if (strindex < 0)
4150         {
4151                 VM_Warning("VM_bufstr_get: invalid string index %i used in %s\n", strindex, PRVM_NAME);
4152                 return;
4153         }
4154         if (strindex < stringbuffer->num_strings && stringbuffer->strings[strindex])
4155                 PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(stringbuffer->strings[strindex]);
4156 }
4157
4158 /*
4159 ========================
4160 VM_bufstr_set
4161 copies a string into selected slot of buffer
4162 void bufstr_set(float bufhandle, float string_index, string str) = #466;
4163 ========================
4164 */
4165 void VM_bufstr_set (void)
4166 {
4167         int                             strindex;
4168         prvm_stringbuffer_t *stringbuffer;
4169         const char              *news;
4170
4171         VM_SAFEPARMCOUNT(3, VM_bufstr_set);
4172
4173         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4174         if(!stringbuffer)
4175         {
4176                 VM_Warning("VM_bufstr_set: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4177                 return;
4178         }
4179         strindex = (int)PRVM_G_FLOAT(OFS_PARM1);
4180         if(strindex < 0 || strindex >= 1000000) // huge number of strings
4181         {
4182                 VM_Warning("VM_bufstr_set: invalid string index %i used in %s\n", strindex, PRVM_NAME);
4183                 return;
4184         }
4185
4186         BufStr_Expand(stringbuffer, strindex);
4187         stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4188
4189         if(stringbuffer->strings[strindex])
4190                 Mem_Free(stringbuffer->strings[strindex]);
4191         stringbuffer->strings[strindex] = NULL;
4192
4193         news = PRVM_G_STRING(OFS_PARM2);
4194         if (news && news[0])
4195         {
4196                 size_t alloclen = strlen(news) + 1;
4197                 stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4198                 memcpy(stringbuffer->strings[strindex], news, alloclen);
4199         }
4200
4201         BufStr_Shrink(stringbuffer);
4202 }
4203
4204 /*
4205 ========================
4206 VM_bufstr_add
4207 adds string to buffer in first free slot and returns its index
4208 "order == TRUE" means that string will be added after last "full" slot
4209 float bufstr_add(float bufhandle, string str, float order) = #467;
4210 ========================
4211 */
4212 void VM_bufstr_add (void)
4213 {
4214         int                             order, strindex;
4215         prvm_stringbuffer_t *stringbuffer;
4216         const char              *string;
4217         size_t                  alloclen;
4218
4219         VM_SAFEPARMCOUNT(3, VM_bufstr_add);
4220
4221         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4222         PRVM_G_FLOAT(OFS_RETURN) = -1;
4223         if(!stringbuffer)
4224         {
4225                 VM_Warning("VM_bufstr_add: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4226                 return;
4227         }
4228         string = PRVM_G_STRING(OFS_PARM1);
4229         if(!string || !string[0])
4230         {
4231                 VM_Warning("VM_bufstr_add: can not add an empty string to buffer %i in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4232                 return;
4233         }
4234         order = (int)PRVM_G_FLOAT(OFS_PARM2);
4235         if(order)
4236                 strindex = stringbuffer->num_strings;
4237         else
4238                 for (strindex = 0;strindex < stringbuffer->num_strings;strindex++)
4239                         if (stringbuffer->strings[strindex] == NULL)
4240                                 break;
4241
4242         BufStr_Expand(stringbuffer, strindex);
4243
4244         stringbuffer->num_strings = max(stringbuffer->num_strings, strindex + 1);
4245         alloclen = strlen(string) + 1;
4246         stringbuffer->strings[strindex] = (char *)Mem_Alloc(prog->progs_mempool, alloclen);
4247         memcpy(stringbuffer->strings[strindex], string, alloclen);
4248
4249         PRVM_G_FLOAT(OFS_RETURN) = strindex;
4250 }
4251
4252 /*
4253 ========================
4254 VM_bufstr_free
4255 delete string from buffer
4256 void bufstr_free(float bufhandle, float string_index) = #468;
4257 ========================
4258 */
4259 void VM_bufstr_free (void)
4260 {
4261         int                             i;
4262         prvm_stringbuffer_t     *stringbuffer;
4263         VM_SAFEPARMCOUNT(2, VM_bufstr_free);
4264
4265         stringbuffer = (prvm_stringbuffer_t *)Mem_ExpandableArray_RecordAtIndex(&prog->stringbuffersarray, (int)PRVM_G_FLOAT(OFS_PARM0));
4266         if(!stringbuffer)
4267         {
4268                 VM_Warning("VM_bufstr_free: invalid buffer %i used in %s\n", (int)PRVM_G_FLOAT(OFS_PARM0), PRVM_NAME);
4269                 return;
4270         }
4271         i = (int)PRVM_G_FLOAT(OFS_PARM1);
4272         if(i < 0)
4273         {
4274                 VM_Warning("VM_bufstr_free: invalid string index %i used in %s\n", i, PRVM_NAME);
4275                 return;
4276         }
4277
4278         if (i < stringbuffer->num_strings)
4279         {
4280                 if(stringbuffer->strings[i])
4281                         Mem_Free(stringbuffer->strings[i]);
4282                 stringbuffer->strings[i] = NULL;
4283         }
4284
4285         BufStr_Shrink(stringbuffer);
4286 }
4287
4288 //=============
4289
4290 /*
4291 ==============
4292 VM_changeyaw
4293
4294 This was a major timewaster in progs, so it was converted to C
4295 ==============
4296 */
4297 void VM_changeyaw (void)
4298 {
4299         prvm_edict_t            *ent;
4300         float           ideal, current, move, speed;
4301
4302         // this is called (VERY HACKISHLY) by SV_MoveToGoal, so it can not use any
4303         // parameters because they are the parameters to SV_MoveToGoal, not this
4304         //VM_SAFEPARMCOUNT(0, VM_changeyaw);
4305
4306         ent = PRVM_PROG_TO_EDICT(PRVM_GLOBALFIELDVALUE(prog->globaloffsets.self)->edict);
4307         if (ent == prog->edicts)
4308         {
4309                 VM_Warning("changeyaw: can not modify world entity\n");
4310                 return;
4311         }
4312         if (ent->priv.server->free)
4313         {
4314                 VM_Warning("changeyaw: can not modify free entity\n");
4315                 return;
4316         }
4317         if (prog->fieldoffsets.angles < 0 || prog->fieldoffsets.ideal_yaw < 0 || prog->fieldoffsets.yaw_speed < 0)
4318         {
4319                 VM_Warning("changeyaw: angles, ideal_yaw, or yaw_speed field(s) not found\n");
4320                 return;
4321         }
4322         current = ANGLEMOD(PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.angles)->vector[1]);
4323         ideal = PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.ideal_yaw)->_float;
4324         speed = PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.yaw_speed)->_float;
4325
4326         if (current == ideal)
4327                 return;
4328         move = ideal - current;
4329         if (ideal > current)
4330         {
4331                 if (move >= 180)
4332                         move = move - 360;
4333         }
4334         else
4335         {
4336                 if (move <= -180)
4337                         move = move + 360;
4338         }
4339         if (move > 0)
4340         {
4341                 if (move > speed)
4342                         move = speed;
4343         }
4344         else
4345         {
4346                 if (move < -speed)
4347                         move = -speed;
4348         }
4349
4350         PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.angles)->vector[1] = ANGLEMOD (current + move);
4351 }
4352
4353 /*
4354 ==============
4355 VM_changepitch
4356 ==============
4357 */
4358 void VM_changepitch (void)
4359 {
4360         prvm_edict_t            *ent;
4361         float           ideal, current, move, speed;
4362
4363         VM_SAFEPARMCOUNT(1, VM_changepitch);
4364
4365         ent = PRVM_G_EDICT(OFS_PARM0);
4366         if (ent == prog->edicts)
4367         {
4368                 VM_Warning("changepitch: can not modify world entity\n");
4369                 return;
4370         }
4371         if (ent->priv.server->free)
4372         {
4373                 VM_Warning("changepitch: can not modify free entity\n");
4374                 return;
4375         }
4376         if (prog->fieldoffsets.angles < 0 || prog->fieldoffsets.idealpitch < 0 || prog->fieldoffsets.pitch_speed < 0)
4377         {
4378                 VM_Warning("changepitch: angles, idealpitch, or pitch_speed field(s) not found\n");
4379                 return;
4380         }
4381         current = ANGLEMOD(PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.angles)->vector[0]);
4382         ideal = PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.idealpitch)->_float;
4383         speed = PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.pitch_speed)->_float;
4384
4385         if (current == ideal)
4386                 return;
4387         move = ideal - current;
4388         if (ideal > current)
4389         {
4390                 if (move >= 180)
4391                         move = move - 360;
4392         }
4393         else
4394         {
4395                 if (move <= -180)
4396                         move = move + 360;
4397         }
4398         if (move > 0)
4399         {
4400                 if (move > speed)
4401                         move = speed;
4402         }
4403         else
4404         {
4405                 if (move < -speed)
4406                         move = -speed;
4407         }
4408
4409         PRVM_EDICTFIELDVALUE(ent, prog->fieldoffsets.angles)->vector[0] = ANGLEMOD (current + move);
4410 }
4411
4412 // TODO: adapt all static function names to use a single naming convention... [12/3/2007 Black]
4413 static int Is_Text_Color (char c, char t)
4414 {
4415         int a = 0;
4416         char c2 = c - (c & 128);
4417         char t2 = t - (t & 128);
4418
4419         if(c != STRING_COLOR_TAG && c2 != STRING_COLOR_TAG)             return 0;
4420         if(t >= '0' && t <= '9')                a = 1;
4421         if(t2 >= '0' && t2 <= '9')              a = 1;
4422 /*      if(t >= 'A' && t <= 'Z')                a = 2;
4423         if(t2 >= 'A' && t2 <= 'Z')              a = 2;
4424
4425         if(a == 1 && scr_colortext.integer > 0)
4426                 return 1;
4427         if(a == 2 && scr_multifonts.integer > 0)
4428                 return 2;
4429 */
4430         return a;
4431 }
4432
4433 void VM_uncolorstring (void)
4434 {
4435         const char      *in;
4436         char            out[VM_STRINGTEMP_LENGTH];
4437         int                     k = 0, i = 0;
4438
4439         VM_SAFEPARMCOUNT(1, VM_uncolorstring);
4440         in = PRVM_G_STRING(OFS_PARM0);
4441         VM_CheckEmptyString (in);
4442
4443         while (in[k])
4444         {
4445                 if(in[k+1])
4446                 if(Is_Text_Color(in[k], in[k+1]) == 1/* || (in[k] == '&' && in[k+1] == 'r')*/)
4447                 {
4448                         k += 2;
4449                         continue;
4450                 }
4451                 out[i] = in[k];
4452                 ++k;
4453                 ++i;
4454         }
4455         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(out);
4456 }
4457
4458 // #221 float(string str, string sub[, float startpos]) strstrofs (FTE_STRINGS)
4459 //strstr, without generating a new string. Use in conjunction with FRIK_FILE's substring for more similar strstr.
4460 void VM_strstrofs (void)
4461 {
4462         const char *instr, *match;
4463         int firstofs;
4464         VM_SAFEPARMCOUNTRANGE(2, 3, VM_strstrofs);
4465         instr = PRVM_G_STRING(OFS_PARM0);
4466         match = PRVM_G_STRING(OFS_PARM1);
4467         firstofs = (prog->argc > 2)?PRVM_G_FLOAT(OFS_PARM2):0;
4468
4469         if (firstofs && (firstofs < 0 || firstofs > (int)strlen(instr)))
4470         {
4471                 PRVM_G_FLOAT(OFS_RETURN) = -1;
4472                 return;
4473         }
4474
4475         match = strstr(instr+firstofs, match);
4476         if (!match)
4477                 PRVM_G_FLOAT(OFS_RETURN) = -1;
4478         else
4479                 PRVM_G_FLOAT(OFS_RETURN) = match - instr;
4480 }
4481
4482 //#222 string(string s, float index) str2chr (FTE_STRINGS)
4483 void VM_str2chr (void)
4484 {
4485         const char *s;
4486         VM_SAFEPARMCOUNT(2, VM_str2chr);
4487         s = PRVM_G_STRING(OFS_PARM0);
4488         if((unsigned)PRVM_G_FLOAT(OFS_PARM1) < strlen(s))
4489                 PRVM_G_FLOAT(OFS_RETURN) = (unsigned char)s[(unsigned)PRVM_G_FLOAT(OFS_PARM1)];
4490         else
4491                 PRVM_G_FLOAT(OFS_RETURN) = 0;
4492 }
4493
4494 //#223 string(float c, ...) chr2str (FTE_STRINGS)
4495 void VM_chr2str (void)
4496 {
4497         char    t[9];
4498         int             i;
4499         VM_SAFEPARMCOUNTRANGE(0, 8, VM_chr2str);
4500         for(i = 0;i < prog->argc && i < (int)sizeof(t) - 1;i++)
4501                 t[i] = (unsigned char)PRVM_G_FLOAT(OFS_PARM0+i*3);
4502         t[i] = 0;
4503         PRVM_G_INT(OFS_RETURN) = PRVM_SetTempString(t);
4504 }
4505
4506 static int chrconv_number(int i, int base, int conv)
4507 {
4508         i -= base;
4509         switch (conv)
4510         {
4511         default:
4512         case 5:
4513         case 6:
4514         case 0:
4515                 break;
4516         case 1:
4517                 base = '0';
4518                 break;
4519         case 2:
4520                 base = '0'+128;
4521                 break;
4522         case 3:
4523                 base = '0'-30;
4524                 break;
4525         case 4:
4526                 base = '0'+128-30;
4527                 break;
4528         }
4529         return i + base;
4530 }
4531 static int chrconv_punct(int i, int base, int conv)
4532 {
4533         i -= base;
4534         switch (conv)