DarkPlaces
Game engine based on the Quake 1 engine by id Software, developed by LadyHavoc
 
cvar.c File Reference
#include "quakedef.h"
+ Include dependency graph for cvar.c:

Go to the source code of this file.

Functions

void Cvar_Callback (cvar_t *var)
 
qbool Cvar_Command (cmd_state_t *cmd)
 
const char ** Cvar_CompleteBuildList (cvar_state_t *cvars, const char *partial, unsigned neededflags)
 
int Cvar_CompleteCountPossible (cvar_state_t *cvars, const char *partial, unsigned neededflags)
 
void Cvar_CompleteCvarPrint (cvar_state_t *cvars, const char *partial, unsigned neededflags)
 
const char * Cvar_CompleteVariable (cvar_state_t *cvars, const char *partial, unsigned neededflags)
 
void Cvar_Del_f (cmd_state_t *cmd)
 
static qbool Cvar_Delete (cvar_state_t *cvars, const char *name, const char *callername)
 For "quiet" mode pass NULL as the callername.
 
cvar_tCvar_FindVar (cvar_state_t *cvars, const char *var_name, unsigned neededflags)
 
cvar_tCvar_FindVarAfter (cvar_state_t *cvars, const char *prev_var_name, unsigned neededflags)
 
static cvar_hash_t ** Cvar_FindVarLink (cvar_state_t *cvars, const char *var_name, cvar_t **prev_alpha, unsigned neededflags)
 Returns a pointer to the pointer stored in hashtable[] (or the one it links to) because we'll need to update that when deleting a cvar as other cvar(s) may share its hashindex.
 
cvar_tCvar_Get (cvar_state_t *cvars, const char *name, const char *value, unsigned flags, const char *newdescription)
 allocates a cvar by name and returns its address, or merely sets its value if it already exists.
 
static const char * Cvar_IsAutoCvar (cvar_t *var)
 Check if a cvar is held by some progs in which case its name is returned, otherwise NULL.
 
static void Cvar_Link (cvar_t *variable, cvar_state_t *cvars)
 
void Cvar_List_f (cmd_state_t *cmd)
 
void Cvar_LockDefaults_f (cmd_state_t *cmd)
 
void Cvar_PrintHelp (cvar_t *cvar, const char *name, qbool full)
 
qbool Cvar_Readonly (cvar_t *var, const char *cmd_name)
 
void Cvar_RegisterCallback (cvar_t *variable, void(*callback)(cvar_t *))
 
void Cvar_RegisterVariable (cvar_t *variable)
 registers a cvar that already has the name, string, and optionally the archive elements set.
 
void Cvar_RegisterVirtual (cvar_t *variable, const char *name)
 
void Cvar_ResetToDefaults_All_f (cmd_state_t *cmd)
 
void Cvar_ResetToDefaults_NoSaveOnly_f (cmd_state_t *cmd)
 
void Cvar_ResetToDefaults_SaveOnly_f (cmd_state_t *cmd)
 
void Cvar_RestoreInitState (cvar_state_t *cvars)
 
void Cvar_SaveInitState (cvar_state_t *cvars)
 
void Cvar_Set (cvar_state_t *cvars, const char *var_name, const char *value)
 equivelant to "<name> <variable>" typed at the console
 
void Cvar_Set_f (cmd_state_t *cmd)
 
void Cvar_SetA_f (cmd_state_t *cmd)
 
void Cvar_SetQuick (cvar_t *var, const char *value)
 
static void Cvar_SetQuick_Internal (cvar_t *var, const char *value)
 
void Cvar_SetValue (cvar_state_t *cvars, const char *var_name, float value)
 expands value to a string and calls Cvar_Set
 
void Cvar_SetValueQuick (cvar_t *var, float value)
 
void Cvar_UnlockDefaults (cmd_state_t *cmd)
 
void Cvar_UpdateAllAutoCvars (cvar_state_t *cvars)
 called after loading a savegame
 
static void Cvar_UpdateAutoCvar (cvar_t *var)
 we assume that prog is already set to the target progs
 
const char * Cvar_VariableDefString (cvar_state_t *cvars, const char *var_name, unsigned neededflags)
 
const char * Cvar_VariableDescription (cvar_state_t *cvars, const char *var_name, unsigned neededflags)
 
const char * Cvar_VariableString (cvar_state_t *cvars, const char *var_name, unsigned neededflags)
 
const char * Cvar_VariableStringOr (cvar_state_t *cvars, const char *var_name, const char *def, unsigned neededflags)
 
float Cvar_VariableValue (cvar_state_t *cvars, const char *var_name, unsigned neededflags)
 
float Cvar_VariableValueOr (cvar_state_t *cvars, const char *var_name, float def, unsigned neededflags)
 
void Cvar_WriteVariables (cvar_state_t *cvars, qfile_t *f)
 

Variables

const char * cvar_dummy_description = "custom cvar"
 
static const char * cvar_null_string = ""
 
cvar_state_t cvars_all
 
cvar_state_t cvars_null
 
cvar_t sv_disablenotify
 

Function Documentation

◆ Cvar_Callback()

void Cvar_Callback ( cvar_t * var)

Definition at line 372 of file cvar.c.

373{
374 if (var == NULL)
375 {
376 Con_Print(CON_WARN "Cvar_Callback: var == NULL\n");
377 return;
378 }
379
380 if(var->callback)
381 var->callback(var);
382}
void Con_Print(const char *msg)
Prints to all appropriate console targets, and adds timestamps.
Definition console.c:1504
#define CON_WARN
Definition console.h:101
#define NULL
Definition qtypes.h:12
void(* callback)(struct cvar_s *var)
Definition cvar.h:79

References cvar_t::callback, Con_Print(), CON_WARN, and NULL.

Referenced by CL_DisconnectEx(), CL_FinishTimeDemo(), CL_Init(), CL_TimeDemo_f(), Cvar_SetQuick_Internal(), SV_Init(), and VID_InitModeGL().

◆ Cvar_Command()

qbool Cvar_Command ( cmd_state_t * cmd)

Definition at line 833 of file cvar.c.

834{
835 cvar_state_t *cvars = cmd->cvars;
836 cvar_t *v;
837
838 // check variables
839 v = Cvar_FindVar(cvars, Cmd_Argv(cmd, 0), (cmd->cvars_flagsmask));
840 if (!v)
841 return false;
842
843 // perform a variable print or set
844 if (Cmd_Argc(cmd) == 1)
845 {
846 Cvar_PrintHelp(v, Cmd_Argv(cmd, 0), true);
847 return true;
848 }
849
851 Con_DPrint("Cvar_Command: ");
852
853 if(Cvar_Readonly(v, NULL))
854 return true;
855
858 Con_DPrint("\n");
859 return true;
860}
static int Cmd_Argc(cmd_state_t *cmd)
Definition cmd.h:249
static const char * Cmd_Argv(cmd_state_t *cmd, int arg)
Cmd_Argv(cmd, ) will return an empty string (not a NULL) if arg > argc, so string operations are alwa...
Definition cmd.h:254
void Con_DPrint(const char *msg)
A Con_Print that only shows up if the "developer" cvar is set.
Definition console.c:1531
void Cvar_SetQuick(cvar_t *var, const char *value)
Definition cvar.c:436
void Cvar_PrintHelp(cvar_t *cvar, const char *name, qbool full)
Definition cvar.c:274
cvar_t * Cvar_FindVar(cvar_state_t *cvars, const char *var_name, unsigned neededflags)
Definition cvar.c:36
qbool Cvar_Readonly(cvar_t *var, const char *cmd_name)
Definition cvar.c:813
const GLdouble * v
Definition glquake.h:762
cvar_t developer_extra
Definition host.c:49
void cmd(string command,...)
Definition cvar.h:66
int integer
Definition cvar.h:73

References cmd(), Cmd_Argc(), Cmd_Argv(), Con_DPrint(), Cvar_FindVar(), Cvar_PrintHelp(), Cvar_Readonly(), Cvar_SetQuick(), developer_extra, cvar_t::integer, NULL, and v.

Referenced by Cmd_ExecuteString().

◆ Cvar_CompleteBuildList()

const char ** Cvar_CompleteBuildList ( cvar_state_t * cvars,
const char * partial,
unsigned neededflags )

Definition at line 250 of file cvar.c.

251{
252 const cvar_t *cvar;
253 size_t len = 0;
254 size_t bpos = 0;
255 size_t sizeofbuf = (Cvar_CompleteCountPossible(cvars, partial, neededflags) + 1) * sizeof(const char *);
256 const char **buf;
257
258 len = strlen(partial);
259 buf = (const char **)Mem_Alloc(tempmempool, sizeofbuf + sizeof(const char *));
260 // Loop through the alias list and print all matches
261 for (cvar = cvars->vars; cvar; cvar = cvar->next)
262 if (!strncasecmp(partial, cvar->name, len) && (cvar->flags & neededflags))
263 buf[bpos++] = cvar->name;
264 else
265 for (char **alias = cvar->aliases; alias && *alias; alias++)
266 if (!strncasecmp(partial, *alias, len) && (cvar->flags & neededflags))
267 buf[bpos++] = *alias;
268
269
270 buf[bpos] = NULL;
271 return buf;
272}
int Cvar_CompleteCountPossible(cvar_state_t *cvars, const char *partial, unsigned neededflags)
Definition cvar.c:217
GLenum GLuint GLenum GLsizei const GLchar * buf
Definition glquake.h:657
float strlen(string s)
float cvar(string name)
cvar_t * vars
Definition cvar.h:101
mempool_t * tempmempool
Definition zone.c:794
#define Mem_Alloc(pool, size)
Definition zone.h:92

References buf, cvar(), Cvar_CompleteCountPossible(), Mem_Alloc, NULL, strlen(), tempmempool, and cvar_state_t::vars.

Referenced by Con_CompleteCommandLine().

◆ Cvar_CompleteCountPossible()

int Cvar_CompleteCountPossible ( cvar_state_t * cvars,
const char * partial,
unsigned neededflags )

Definition at line 217 of file cvar.c.

218{
219 cvar_t *cvar;
220 size_t len;
221 int h;
222
223 h = 0;
224 len = strlen(partial);
225
226 if (!len)
227 return 0;
228
229 // Loop through the cvars and count all possible matches
230 for (cvar = cvars->vars; cvar; cvar = cvar->next)
231 if (!strncasecmp(partial, cvar->name, len) && (cvar->flags & neededflags))
232 h++;
233 else
234 for (char **alias = cvar->aliases; alias && *alias; alias++)
235 if (!strncasecmp(partial, *alias, len) && (cvar->flags & neededflags))
236 h++;
237
238 return h;
239}

References cvar(), strlen(), and cvar_state_t::vars.

Referenced by Con_CompleteCommandLine(), and Cvar_CompleteBuildList().

◆ Cvar_CompleteCvarPrint()

void Cvar_CompleteCvarPrint ( cvar_state_t * cvars,
const char * partial,
unsigned neededflags )

Definition at line 288 of file cvar.c.

289{
290 cvar_t *cvar;
291 size_t len = strlen(partial);
292 // Loop through the command list and print all matches
293 for (cvar = cvars->vars; cvar; cvar = cvar->next)
294 if (!strncasecmp(partial, cvar->name, len) && (cvar->flags & neededflags))
295 Cvar_PrintHelp(cvar, cvar->name, true);
296 else
297 for (char **alias = cvar->aliases; alias && *alias; alias++)
298 if (!strncasecmp (partial, *alias, len) && (cvar->flags & neededflags))
299 Cvar_PrintHelp(cvar, *alias, true);
300
301
302}

References cvar(), Cvar_PrintHelp(), strlen(), and cvar_state_t::vars.

Referenced by Con_CompleteCommandLine().

◆ Cvar_CompleteVariable()

const char * Cvar_CompleteVariable ( cvar_state_t * cvars,
const char * partial,
unsigned neededflags )

Definition at line 190 of file cvar.c.

191{
192 cvar_t *cvar;
193 size_t len;
194
195 len = strlen(partial);
196
197 if (!len)
198 return NULL;
199
200// check functions
201 for (cvar=cvars->vars ; cvar ; cvar=cvar->next)
202 if (!strncasecmp (partial,cvar->name, len) && (cvar->flags & neededflags))
203 return cvar->name;
204
205 return NULL;
206}

References cvar(), NULL, strlen(), and cvar_state_t::vars.

◆ Cvar_Del_f()

void Cvar_Del_f ( cmd_state_t * cmd)

Definition at line 1110 of file cvar.c.

1111{
1112 cvar_state_t *cvars = cmd->cvars;
1113 int i;
1114
1115 if(Cmd_Argc(cmd) < 2)
1116 {
1117 Con_Printf("%s: wrong number of parameters, usage: unset <variablename1> [<variablename2> ...]\n", Cmd_Argv(cmd, 0));
1118 return;
1119 }
1120 for(i = 1; i < Cmd_Argc(cmd); ++i)
1121 Cvar_Delete(cvars, Cmd_Argv(cmd, i), Cmd_Argv(cmd, 0));
1122}
void Con_Printf(const char *fmt,...)
Prints to all appropriate console targets.
Definition console.c:1514
static qbool Cvar_Delete(cvar_state_t *cvars, const char *name, const char *callername)
For "quiet" mode pass NULL as the callername.
Definition cvar.c:766
int i

References cmd(), Cmd_Argc(), Cmd_Argv(), Con_Printf(), Cvar_Delete(), and i.

Referenced by Cmd_Init().

◆ Cvar_Delete()

static qbool Cvar_Delete ( cvar_state_t * cvars,
const char * name,
const char * callername )
static

For "quiet" mode pass NULL as the callername.

Returns true if the cvar was deleted.

Definition at line 766 of file cvar.c.

767{
768 cvar_t *cvar, *prev;
769 cvar_hash_t **hashlinkptr, *oldhashlink;
770 const char *progname;
771
772 hashlinkptr = Cvar_FindVarLink(cvars, name, &prev, ~0);
773 if(!hashlinkptr)
774 {
775 if (callername)
776 Con_Printf("%s: cvar \"%s\" is not defined.\n", callername, name);
777 return false;
778 }
779 cvar = (*hashlinkptr)->cvar;
780
781 if(!(cvar->flags & CF_ALLOCATED))
782 {
783 if (callername)
784 Con_Printf(CON_WARN "%s: engine cvar \"%s\" cannot be deleted!\n", callername, cvar->name);
785 return false;
786 }
787 if ((progname = Cvar_IsAutoCvar(cvar)))
788 {
789 if (callername)
790 Con_Printf(CON_WARN "%s: unable to delete cvar \"%s\", it is an autocvar used by running %s progs!\n", callername, cvar->name, progname);
791 return false;
792 }
793
794 if(cvar == cvars->vars)
795 cvars->vars = cvar->next;
796 else
797 prev->next = cvar->next;
798
799 if(cvar->description != cvar_dummy_description)
800 Z_Free((char *)cvar->description);
801 Z_Free((char *)cvar->name);
802 Z_Free((char *)cvar->string);
803 Z_Free((char *)cvar->defstring);
804 Z_Free(cvar);
805
806 oldhashlink = *hashlinkptr;
807 *hashlinkptr = (*hashlinkptr)->next;
808 Z_Free(oldhashlink);
809
810 return true;
811}
#define CF_ALLOCATED
created by Cvar_Get() (console or QC)
Definition cmd.h:64
static cvar_hash_t ** Cvar_FindVarLink(cvar_state_t *cvars, const char *var_name, cvar_t **prev_alpha, unsigned neededflags)
Returns a pointer to the pointer stored in hashtable[] (or the one it links to) because we'll need to...
Definition cvar.c:81
static const char * Cvar_IsAutoCvar(cvar_t *var)
Check if a cvar is held by some progs in which case its name is returned, otherwise NULL.
Definition cvar.c:306
const char * cvar_dummy_description
Definition cvar.c:25
const GLchar * name
Definition glquake.h:601
struct cvar_hash_s * next
Definition cvar.h:96
struct cvar_s * next
Definition cvar.h:90
#define Z_Free(data)
Definition zone.h:164

References CF_ALLOCATED, Con_Printf(), CON_WARN, cvar(), cvar_dummy_description, Cvar_FindVarLink(), Cvar_IsAutoCvar(), name, cvar_hash_t::next, cvar_t::next, cvar_state_t::vars, and Z_Free.

Referenced by Cvar_Del_f(), and Cvar_RestoreInitState().

◆ Cvar_FindVar()

cvar_t * Cvar_FindVar ( cvar_state_t * cvars,
const char * var_name,
unsigned neededflags )

Definition at line 36 of file cvar.c.

37{
38 unsigned hashindex;
39 cvar_hash_t *hash;
40
41 // use hash lookup to minimize search time
42 hashindex = CRC_Block((const unsigned char *)var_name, strlen(var_name)) % CVAR_HASHSIZE;
43 for (hash = cvars->hashtable[hashindex];hash;hash = hash->next)
44 if (!strcmp (var_name, hash->cvar->name) && (hash->cvar->flags & neededflags))
45 return hash->cvar;
46 else
47 for (char **alias = hash->cvar->aliases; alias && *alias; alias++)
48 if (!strcmp (var_name, *alias) && (hash->cvar->flags & neededflags))
49 return hash->cvar;
50 return NULL;
51}
unsigned short CRC_Block(const unsigned char *data, size_t size)
Definition com_crc16.c:75
#define CVAR_HASHSIZE
number of hash buckets for accelerating cvar name lookups
Definition qdefs.h:116
cvar_t * cvar
Definition cvar.h:95
cvar_hash_t * hashtable[CVAR_HASHSIZE]
Definition cvar.h:102
unsigned flags
Definition cvar.h:67
const char * name
Definition cvar.h:69
char ** aliases
Definition cvar.h:81

References cvar_t::aliases, CRC_Block(), cvar_hash_t::cvar, CVAR_HASHSIZE, cvar_t::flags, cvar_state_t::hashtable, cvar_t::name, cvar_hash_t::next, NULL, and strlen().

Referenced by CL_SendCvar_f(), Cmd_AddCommand(), Cmd_GetDirectCvarValue(), Cmd_Toggle_f(), Cvar_Command(), Cvar_FindVarAfter(), Cvar_Get(), Cvar_RegisterVariable(), Cvar_RegisterVirtual(), Cvar_Set(), Cvar_Set_f(), Cvar_SetA_f(), Cvar_VariableDefString(), Cvar_VariableDescription(), Cvar_VariableStringOr(), Cvar_VariableValueOr(), LoadSubtitles(), PRVM_Cvar_ReadOk(), PRVM_ED_EdictGet_f(), PRVM_ED_GlobalGet_f(), PRVM_Prog_Load(), VID_InitMode(), VM_cvar_set(), VM_cvar_type(), and VM_registercvar().

◆ Cvar_FindVarAfter()

cvar_t * Cvar_FindVarAfter ( cvar_state_t * cvars,
const char * prev_var_name,
unsigned neededflags )

Definition at line 53 of file cvar.c.

54{
55 cvar_t *var;
56
57 if (*prev_var_name)
58 {
59 var = Cvar_FindVar(cvars, prev_var_name, neededflags);
60 if (!var)
61 return NULL;
62 var = var->next;
63 }
64 else
65 var = cvars->vars;
66
67 // search for the next cvar matching the needed flags
68 while (var)
69 {
70 if (var->flags & neededflags)
71 break;
72 var = var->next;
73 }
74 return var;
75}

References Cvar_FindVar(), cvar_t::flags, cvar_t::next, NULL, and cvar_state_t::vars.

Referenced by NetConn_ServerParsePacket().

◆ Cvar_FindVarLink()

static cvar_hash_t ** Cvar_FindVarLink ( cvar_state_t * cvars,
const char * var_name,
cvar_t ** prev_alpha,
unsigned neededflags )
static

Returns a pointer to the pointer stored in hashtable[] (or the one it links to) because we'll need to update that when deleting a cvar as other cvar(s) may share its hashindex.

Definition at line 81 of file cvar.c.

82{
83 unsigned hashindex;
84 cvar_t *cvar;
85 cvar_hash_t **hashlinkptr;
86
87 // use hash lookup to minimize search time
88 hashindex = CRC_Block((const unsigned char *)var_name, strlen(var_name)) % CVAR_HASHSIZE;
89 if(prev_alpha) *prev_alpha = NULL;
90 hashlinkptr = &cvars->hashtable[hashindex];
91 for (hashlinkptr = &cvars->hashtable[hashindex]; *hashlinkptr; hashlinkptr = &(*hashlinkptr)->next)
92 {
93 cvar = (*hashlinkptr)->cvar;
94 if (!strcmp (var_name, cvar->name) && (cvar->flags & neededflags))
95 goto match;
96 else
97 for (char **alias = cvar->aliases; alias && *alias; alias++)
98 if (!strcmp (var_name, *alias) && (cvar->flags & neededflags))
99 goto match;
100 }
101 return NULL;
102
103match:
104 if(!prev_alpha || cvar == cvars->vars)
105 return hashlinkptr;
106 *prev_alpha = cvars->vars;
107 // if prev_alpha happens to become NULL then there has been some inconsistency elsewhere
108 // already - should I still insert '*prev_alpha &&' in the loop?
109 while((*prev_alpha)->next != cvar)
110 *prev_alpha = (*prev_alpha)->next;
111 return hashlinkptr;
112}

References CRC_Block(), cvar(), CVAR_HASHSIZE, cvar_state_t::hashtable, cvar_hash_t::next, cvar_t::next, NULL, strlen(), and cvar_state_t::vars.

Referenced by Cvar_Delete().

◆ Cvar_Get()

cvar_t * Cvar_Get ( cvar_state_t * cvars,
const char * name,
const char * value,
unsigned flags,
const char * newdescription )

allocates a cvar by name and returns its address, or merely sets its value if it already exists.

Definition at line 695 of file cvar.c.

696{
697 cvar_t *cvar;
698 int i;
699
701 Con_DPrintf("Cvar_Get(\"%s\", \"%s\", %i);\n", name, value, flags);
702
703 // first check to see if it has already been defined
704 cvar = Cvar_FindVar(cvars, name, ~0);
705 if (cvar)
706 {
707 cvar->flags |= flags;
709 if(newdescription && (cvar->flags & CF_ALLOCATED))
710 {
711 if(cvar->description != cvar_dummy_description)
712 Z_Free((char *)cvar->description);
713
714 if(*newdescription)
715 cvar->description = Z_strdup(newdescription);
716 else
717 cvar->description = cvar_dummy_description;
718 }
719 return cvar;
720 }
721
722 // check for pure evil
723 if (!*name)
724 {
725 Con_Printf(CON_WARN "Cvar_Get: invalid variable name\n");
726 return NULL;
727 }
728
729 // check for overlap with a command
731 {
732 Con_Printf(CON_WARN "Cvar_Get: %s is a command\n", name);
733 return NULL;
734 }
735
736 // allocate a new cvar, cvar name, and cvar string
737 // TODO: factorize the following code with the one at the end of Cvar_RegisterVariable()
738 // FIXME: these never get Z_Free'd
739 cvar = (cvar_t *)Z_Malloc(sizeof(cvar_t));
740 cvar->flags = flags | CF_ALLOCATED;
741 cvar->name = Z_strdup(name);
742 cvar->string = Z_strdup(value);
743 cvar->defstring = Z_strdup(value);
744 cvar->value = atof (cvar->string);
745 cvar->integer = (int) cvar->value;
746 cvar->aliases = NULL;
747 cvar->aliases_size = 0;
748 cvar->initstring = NULL;
749
750 if(newdescription && *newdescription)
751 cvar->description = Z_strdup(newdescription);
752 else
753 cvar->description = cvar_dummy_description; // actually checked by VM_cvar_type
754
755 // Mark it as not an autocvar.
756 for (i = 0;i < PRVM_PROG_MAX;i++)
757 cvar->globaldefindex[i] = -1;
758
759 Cvar_Link(cvar, cvars);
760
761 return cvar;
762}
cmd_state_t * cmd_local
command interpreter for local commands injected by SVQC, CSQC, MQC, server or client engine code uses...
Definition cmd.c:25
qbool Cmd_Exists(cmd_state_t *cmd, const char *cmd_name)
used by the cvar code to check for cvar / command name overlap
Definition cmd.c:1762
void Con_DPrintf(const char *fmt,...)
A Con_Printf that only shows up if the "developer" cvar is set.
Definition console.c:1544
float flags
static void Cvar_SetQuick_Internal(cvar_t *var, const char *value)
Definition cvar.c:390
static void Cvar_Link(cvar_t *variable, cvar_state_t *cvars)
Definition cvar.c:567
static int(ZEXPORT *qz_inflate)(z_stream *strm
GLsizei const GLfloat * value
Definition glquake.h:740
@ PRVM_PROG_MAX
Definition progsvm.h:757
#define Z_Malloc(size)
Definition zone.h:161
#define Z_strdup(s)
Definition zone.h:163

References CF_ALLOCATED, Cmd_Exists(), cmd_local, Con_DPrintf(), Con_Printf(), CON_WARN, cvar(), cvar_dummy_description, Cvar_FindVar(), Cvar_Link(), Cvar_SetQuick_Internal(), developer_extra, flags, i, int(), cvar_t::integer, name, NULL, PRVM_PROG_MAX, value, Z_Free, Z_Malloc, and Z_strdup.

Referenced by Cvar_Set_f(), Cvar_SetA_f(), Mod_VBSP_Load(), PRVM_ED_EdictGet_f(), PRVM_ED_GlobalGet_f(), PRVM_Prog_Load(), and VM_registercvar().

◆ Cvar_IsAutoCvar()

static const char * Cvar_IsAutoCvar ( cvar_t * var)
static

Check if a cvar is held by some progs in which case its name is returned, otherwise NULL.

Definition at line 306 of file cvar.c.

307{
308 int i;
309 prvm_prog_t *prog;
310 for (i = 0;i < PRVM_PROG_MAX;i++)
311 {
312 prog = &prvm_prog_list[i];
313 if (prog->loaded && var->globaldefindex[i] >= 0)
314 return prog->name;
315 }
316 return NULL;
317}
prvm_prog_t prvm_prog_list[PRVM_PROG_MAX]
Definition prvm_edict.c:27
int globaldefindex[3]
Definition cvar.h:87
qbool loaded
used to indicate whether a prog is loaded
Definition progsvm.h:710
const char * name
name of the prog, e.g. "Server", "Client" or "Menu" (used for text output)
Definition progsvm.h:700

References cvar_t::globaldefindex, i, prvm_prog_t::loaded, prvm_prog_t::name, NULL, prvm_prog_list, and PRVM_PROG_MAX.

Referenced by Cvar_Delete().

◆ Cvar_Link()

static void Cvar_Link ( cvar_t * variable,
cvar_state_t * cvars )
static

Definition at line 567 of file cvar.c.

568{
569 cvar_t *current, *next;
570 cvar_hash_t *hash;
571 unsigned hashindex;
572 /*
573 * Link the variable in
574 * alphanumerical order
575 */
576 for( current = NULL, next = cvars->vars ; next && strcmp( next->name, variable->name ) < 0 ; current = next, next = next->next )
577 ;
578 if(current)
579 current->next = variable;
580 else
581 cvars->vars = variable;
582 variable->next = next;
583
584 // link to head of list in this hash table index
585 hash = (cvar_hash_t *)Z_Malloc(sizeof(cvar_hash_t));
586 hashindex = CRC_Block((const unsigned char *)variable->name, strlen(variable->name)) % CVAR_HASHSIZE;
587 hash->next = cvars->hashtable[hashindex];
588 hash->cvar = variable;
589 cvars->hashtable[hashindex] = hash;
590}

References CRC_Block(), cvar_hash_t::cvar, CVAR_HASHSIZE, cvar_state_t::hashtable, cvar_t::name, cvar_hash_t::next, cvar_t::next, NULL, strlen(), cvar_state_t::vars, and Z_Malloc.

Referenced by Cvar_Get(), and Cvar_RegisterVariable().

◆ Cvar_List_f()

void Cvar_List_f ( cmd_state_t * cmd)

Definition at line 1008 of file cvar.c.

1009{
1010 cvar_state_t *cvars = cmd->cvars;
1011 cvar_t *cvar;
1012 const char *partial;
1013 int count;
1014 qbool ispattern;
1015 char vabuf[1024];
1016
1017 if (Cmd_Argc(cmd) > 1)
1018 {
1019 partial = Cmd_Argv(cmd, 1);
1020 ispattern = (strchr(partial, '*') || strchr(partial, '?'));
1021 if(!ispattern)
1022 partial = va(vabuf, sizeof(vabuf), "%s*", partial);
1023 }
1024 else
1025 {
1026 partial = va(vabuf, sizeof(vabuf), "*");
1027 ispattern = false;
1028 }
1029
1030 count = 0;
1031 for (cvar = cvars->vars; cvar; cvar = cvar->next)
1032 {
1033 if (matchpattern_with_separator(cvar->name, partial, false, "", false))
1034 {
1035 Cvar_PrintHelp(cvar, cvar->name, true);
1036 count++;
1037 }
1038 for (char **alias = cvar->aliases; alias && *alias; alias++)
1039 {
1040 if (matchpattern_with_separator(*alias, partial, false, "", false))
1041 {
1042 Cvar_PrintHelp(cvar, *alias, true);
1043 count++;
1044 }
1045 }
1046 }
1047
1048 if (Cmd_Argc(cmd) > 1)
1049 {
1050 if(ispattern)
1051 Con_Printf("%i cvar%s matching \"%s\"\n", count, (count > 1) ? "s" : "", partial);
1052 else
1053 Con_Printf("%i cvar%s beginning with \"%s\"\n", count, (count > 1) ? "s" : "", Cmd_Argv(cmd,1));
1054 }
1055 else
1056 Con_Printf("%i cvar(s)\n", count);
1057}
char * va(char *buf, size_t buflen, const char *format,...)
Definition common.c:972
int matchpattern_with_separator(const char *in, const char *pattern, int caseinsensitive, const char *separators, qbool wildcard_least_one)
Definition filematch.c:23
GLenum GLenum GLsizei count
Definition glquake.h:656
bool qbool
Definition qtypes.h:9

References cmd(), Cmd_Argc(), Cmd_Argv(), Con_Printf(), count, cvar(), Cvar_PrintHelp(), matchpattern_with_separator(), va(), and cvar_state_t::vars.

Referenced by Cmd_Init().

◆ Cvar_LockDefaults_f()

void Cvar_LockDefaults_f ( cmd_state_t * cmd)

Definition at line 871 of file cvar.c.

872{
873 cvar_state_t *cvars = cmd->cvars;
874 cvar_t *var;
875 // lock in the default values of all cvars
876 for (var = cvars->vars ; var ; var = var->next)
877 {
878 if (!(var->flags & CF_DEFAULTSET))
879 {
880 size_t alloclen;
881
882 //Con_Printf("locking cvar %s (%s -> %s)\n", var->name, var->string, var->defstring);
883 var->flags |= CF_DEFAULTSET;
884 Z_Free((char *)var->defstring);
885 alloclen = strlen(var->string) + 1;
886 var->defstring = (char *)Z_Malloc(alloclen);
887 memcpy((char *)var->defstring, var->string, alloclen);
888 }
889 }
890}
#define CF_DEFAULTSET
Definition cmd.h:63
const char * string
Definition cvar.h:71
const char * defstring
Definition cvar.h:77

References CF_DEFAULTSET, cmd(), cvar_t::defstring, cvar_t::flags, cvar_t::next, cvar_t::string, strlen(), cvar_state_t::vars, Z_Free, and Z_Malloc.

Referenced by Cmd_Init().

◆ Cvar_PrintHelp()

void Cvar_PrintHelp ( cvar_t * cvar,
const char * name,
qbool full )

Definition at line 274 of file cvar.c.

275{
276 // Aliases are purple, cvars are yellow
277 if (strcmp(cvar->name, name))
278 Con_Printf("^6%s^7 (alias of ^3%s^7)", name, cvar->name);
279 else
280 Con_Printf("^3%s^7", name);
281 Con_Printf(" is \"%s^7\" [\"%s^7\"]", ((cvar->flags & CF_PRIVATE) ? "********"/*hunter2*/ : cvar->string), cvar->defstring);
282 if (full)
283 Con_Printf(" %s", cvar->description);
284 Con_Print("\n");
285}
#define CF_PRIVATE
cvar should not be $ expanded or sent to the server under any circumstances (rcon_password,...
Definition cmd.h:59

References CF_PRIVATE, Con_Print(), Con_Printf(), cvar(), and name.

Referenced by Cmd_Apropos_f(), Cvar_Command(), Cvar_CompleteCvarPrint(), and Cvar_List_f().

◆ Cvar_Readonly()

qbool Cvar_Readonly ( cvar_t * var,
const char * cmd_name )

Definition at line 813 of file cvar.c.

814{
815 if (var->flags & CF_READONLY)
816 {
818 if(cmd_name)
819 Con_Printf("%s: ",cmd_name);
820 Con_Printf("%s is read-only\n", var->name);
821 return true;
822 }
823 return false;
824}
#define CF_READONLY
cvar cannot be changed from the console or the command buffer, and is considered CF_PERSISTENT
Definition cmd.h:54

References CF_READONLY, Con_Print(), Con_Printf(), CON_WARN, cvar_t::flags, and cvar_t::name.

Referenced by Cvar_Command(), Cvar_Set_f(), Cvar_SetA_f(), PRVM_ED_EdictGet_f(), and PRVM_ED_GlobalGet_f().

◆ Cvar_RegisterCallback()

void Cvar_RegisterCallback ( cvar_t * variable,
void(* callback )(cvar_t *) )

Definition at line 495 of file cvar.c.

496{
497 if (variable == NULL)
498 {
499 Con_Print(CON_WARN "Cvar_RegisterCallback: var == NULL\n");
500 return;
501 }
502
503 if (!(variable->flags & cmd_local->cvars_flagsmask))
504 {
506 Con_DPrintf("^6Cvar_RegisterCallback: rejecting cvar \"%s\"\n", variable->name);
507 return;
508 }
509
510 variable->callback = callback;
511}
unsigned cvars_flagsmask
which CVAR_* flags should be visible to this interpreter? (CF_CLIENT | CF_SERVER, or just CF_SERVER)
Definition cmd.h:144

References cvar_t::callback, cmd_local, Con_DPrintf(), Con_Print(), CON_WARN, cmd_state_t::cvars_flagsmask, developer_extra, cvar_t::flags, cvar_t::integer, cvar_t::name, and NULL.

Referenced by CL_InitCommands(), Con_Init(), Host_InitLocal(), NetConn_Init(), SV_Init(), SV_InitOperatorCommands(), Sys_Init_Commands(), and VID_Init().

◆ Cvar_RegisterVariable()

void Cvar_RegisterVariable ( cvar_t * variable)

registers a cvar that already has the name, string, and optionally the archive elements set.

Definition at line 599 of file cvar.c.

600{
601 cvar_state_t *cvars = &cvars_all;
602 cvar_t *current, *cvar;
603 int i;
604
605 if (!(variable->flags & cmd_local->cvars_flagsmask))
606 {
608 Con_DPrintf("^2Cvar_RegisterVariable: rejecting cvar \"%s\"\n", variable->name);
609 return;
610 }
611
613 Con_DPrintf("Cvar_RegisterVariable({\"%s\", \"%s\", %i});\n", variable->name, variable->string, variable->flags);
614
615 // first check to see if it has already been defined
616 cvar = Cvar_FindVar(cvars, variable->name, ~0);
617 if (cvar)
618 {
619 if (cvar->flags & CF_ALLOCATED)
620 {
622 Con_DPrintf("... replacing existing allocated cvar {\"%s\", \"%s\", %i}\n", cvar->name, cvar->string, cvar->flags);
623 // fixed variables replace allocated ones
624 // (because the engine directly accesses fixed variables)
625 // NOTE: this isn't actually used currently
626 // (all cvars are registered before config parsing)
627 variable->flags &= ~CF_ALLOCATED;
628 // cvar->string is now owned by variable instead
629 variable->string = cvar->string;
630 variable->defstring = cvar->defstring;
631 variable->value = atof (variable->string);
632 variable->integer = (int) variable->value;
633 // Preserve autocvar status.
634 memcpy(variable->globaldefindex, cvar->globaldefindex, sizeof(variable->globaldefindex));
635 memcpy(variable->globaldefindex_stringno, cvar->globaldefindex_stringno, sizeof(variable->globaldefindex_stringno));
636 // replace cvar with this one...
637 variable->next = cvar->next;
638 if (cvars->vars == cvar)
639 {
640 // head of the list is easy to change
641 cvars->vars = variable;
642 }
643 else
644 {
645 // otherwise find it somewhere in the list
646 for (current = cvars->vars;current->next != cvar;current = current->next)
647 ;
648 current->next = variable;
649 }
650
651 // get rid of old allocated cvar
652 // (but not cvar->string and cvar->defstring, because we kept those)
653 Z_Free((char *)cvar->name);
654 Z_Free(cvar);
655 }
656 else
657 Con_DPrintf("Can't register variable %s, already defined\n", variable->name);
658 return;
659 }
660
661 // check for overlap with a command
662 if (Cmd_Exists(cmd_local, variable->name))
663 {
664 Con_Printf(CON_WARN "Cvar_RegisterVariable: %s is a command\n", variable->name);
665 return;
666 }
667
668 // copy the value off, because future sets will Z_Free it
669 variable->name = Z_strdup(variable->name);
670 variable->string = Z_strdup(variable->string);
671 variable->defstring = Z_strdup(variable->string);
672 variable->value = atof (variable->string);
673 variable->integer = (int) variable->value;
674 variable->aliases = NULL;
675 variable->aliases_size = 0;
676 variable->initstring = NULL;
677
678 // Mark it as not an autocvar.
679 for (i = 0;i < PRVM_PROG_MAX;i++)
680 variable->globaldefindex[i] = -1;
681
682 // Safe for Cvar_SetQuick()
683 variable->flags |= CF_REGISTERED;
684
685 Cvar_Link(variable, cvars);
686}
#define CF_REGISTERED
created by Cvar_RegisterVariable()
Definition cmd.h:62
cvar_state_t cvars_all
Definition cvar.c:28
float value
Definition cvar.h:74
const char * initstring
Definition cvar.h:85
int globaldefindex_stringno[3]
Definition cvar.h:88
int aliases_size
Definition cvar.h:82

References cvar_t::aliases, cvar_t::aliases_size, CF_ALLOCATED, CF_REGISTERED, Cmd_Exists(), cmd_local, Con_DPrintf(), Con_Printf(), CON_WARN, cvar(), Cvar_FindVar(), Cvar_Link(), cvars_all, cmd_state_t::cvars_flagsmask, cvar_t::defstring, developer_extra, cvar_t::flags, cvar_t::globaldefindex, cvar_t::globaldefindex_stringno, i, cvar_t::initstring, int(), cvar_t::integer, cvar_t::name, cvar_t::next, NULL, PRVM_PROG_MAX, cvar_t::string, cvar_t::value, cvar_state_t::vars, Z_Free, and Z_strdup.

Referenced by CDAudio_Init(), CL_Demo_Init(), CL_Init(), CL_InitCommands(), CL_InitInput(), CL_Parse_Init(), CL_Particles_Init(), CL_Screen_Init(), CL_Video_Init(), Collision_Init(), COM_Init_Commands(), Con_Init(), Crypto_Init_Commands(), Curl_Init_Commands(), Font_Init(), FS_Init_Commands(), gl_backend_init(), GL_Draw_Init(), GL_Main_Init(), GL_Surf_Init(), Host_InitLocal(), Host_InitSession(), Key_Init(), LibAvW_OpenLibrary(), Memory_Init_Commands(), Mod_AliasInit(), Mod_BrushInit(), Mod_Init(), Mod_SpriteInit(), MR_Init_Commands(), NetConn_Init(), Palette_Init(), PRVM_Init(), R_Explosion_Init(), R_LightningBeams_Init(), R_Particles_Init(), R_Shadow_EditLights_Init(), R_Shadow_Init(), R_Sky_Init(), R_Textures_Init(), S_Init(), Sbar_Init(), SCR_CaptureVideo_Ogg_Init(), SV_Init(), SV_InitOperatorCommands(), Sys_Init_Commands(), TaskQueue_Init(), u8_Init(), V_Init(), VID_Init(), and VID_Shared_Init().

◆ Cvar_RegisterVirtual()

void Cvar_RegisterVirtual ( cvar_t * variable,
const char * name )

Definition at line 513 of file cvar.c.

514{
515 cvar_state_t *cvars = &cvars_all;
516 cvar_hash_t *hash;
517 unsigned hashindex;
518
519 if (!(variable->flags & cmd_local->cvars_flagsmask))
520 {
522 Con_DPrintf("^6Cvar_RegisterVirtual: rejecting cvar \"%s\" alias \"%s\"\n", variable->name, name);
523 return;
524 }
525
526 if(!*name)
527 {
528 Con_Printf(CON_WARN "Cvar_RegisterVirtual: invalid virtual cvar name\n");
529 return;
530 }
531
532 // check for overlap with a command
534 {
535 Con_Printf(CON_WARN "Cvar_RegisterVirtual: %s is a command\n", name);
536 return;
537 }
538
539 if(Cvar_FindVar(&cvars_all, name, 0))
540 {
541 Con_Printf(CON_WARN "Cvar_RegisterVirtual: %s is a cvar\n", name);
542 return;
543 }
544
545 // Resize the variable->aliases list to have room for another entry and a null terminator.
546 // This zero-pads when resizing, so we don't need to write the NULL terminator manually here.
547 // Also if aliases is NULL this allocates fresh for the correct size, so it's fine to just do this.
548 variable->aliases = (char **)Z_Realloc(variable->aliases, sizeof(char *) * (variable->aliases_size + 2));
549 // Add the new alias, and increment the number of aliases in the list
550 variable->aliases[variable->aliases_size++] = Z_strdup(name);
551
552 // link to head of list in this hash table index
553 hash = (cvar_hash_t *)Z_Malloc(sizeof(cvar_hash_t));
554 hashindex = CRC_Block((const unsigned char *)name, strlen(name)) % CVAR_HASHSIZE;
555 hash->next = cvars->hashtable[hashindex];
556 cvars->hashtable[hashindex] = hash;
557 hash->cvar = variable;
558}
#define Z_Realloc(data, size)
Definition zone.h:162

References cvar_t::aliases, cvar_t::aliases_size, Cmd_Exists(), cmd_local, Con_DPrintf(), Con_Printf(), CON_WARN, CRC_Block(), cvar_hash_t::cvar, Cvar_FindVar(), CVAR_HASHSIZE, cvars_all, cmd_state_t::cvars_flagsmask, developer_extra, cvar_t::flags, cvar_state_t::hashtable, cvar_t::integer, cvar_t::name, name, cvar_hash_t::next, strlen(), Z_Malloc, Z_Realloc, and Z_strdup.

Referenced by CL_InitCommands(), CL_Screen_Init(), COM_Init_Commands(), Curl_Init_Commands(), NetConn_Init(), Sbar_Init(), and SV_Init().

◆ Cvar_ResetToDefaults_All_f()

void Cvar_ResetToDefaults_All_f ( cmd_state_t * cmd)

Definition at line 940 of file cvar.c.

941{
942 cvar_state_t *cvars = cmd->cvars;
943 cvar_t *var;
944 // restore the default values of all cvars
945 for (var = cvars->vars ; var ; var = var->next)
946 {
947 if((var->flags & (CF_PERSISTENT | CF_READONLY)) == 0)
948 Cvar_SetQuick(var, var->defstring);
949 }
950}
#define CF_PERSISTENT
cvar must not be reset on gametype switch (such as scr_screenshot_name, which otherwise isn't set to ...
Definition cmd.h:58

References CF_PERSISTENT, CF_READONLY, cmd(), Cvar_SetQuick(), cvar_t::defstring, cvar_t::flags, cvar_t::next, and cvar_state_t::vars.

Referenced by Cmd_Init().

◆ Cvar_ResetToDefaults_NoSaveOnly_f()

void Cvar_ResetToDefaults_NoSaveOnly_f ( cmd_state_t * cmd)

Definition at line 952 of file cvar.c.

953{
954 cvar_state_t *cvars = cmd->cvars;
955 cvar_t *var;
956 // restore the default values of all cvars
957 for (var = cvars->vars ; var ; var = var->next)
958 {
959 if ((var->flags & (CF_PERSISTENT | CF_READONLY | CF_ARCHIVE)) == 0)
960 Cvar_SetQuick(var, var->defstring);
961 }
962}
#define CF_ARCHIVE
cvar should have its set value saved to config.cfg and persist across sessions
Definition cmd.h:53

References CF_ARCHIVE, CF_PERSISTENT, CF_READONLY, cmd(), Cvar_SetQuick(), cvar_t::defstring, cvar_t::flags, cvar_t::next, and cvar_state_t::vars.

Referenced by Cmd_Init().

◆ Cvar_ResetToDefaults_SaveOnly_f()

void Cvar_ResetToDefaults_SaveOnly_f ( cmd_state_t * cmd)

Definition at line 965 of file cvar.c.

966{
967 cvar_state_t *cvars = cmd->cvars;
968 cvar_t *var;
969 // restore the default values of all cvars
970 for (var = cvars->vars ; var ; var = var->next)
971 {
973 Cvar_SetQuick(var, var->defstring);
974 }
975}

References CF_ARCHIVE, CF_PERSISTENT, CF_READONLY, cmd(), Cvar_SetQuick(), cvar_t::defstring, cvar_t::flags, cvar_t::next, and cvar_state_t::vars.

Referenced by Cmd_Init().

◆ Cvar_RestoreInitState()

void Cvar_RestoreInitState ( cvar_state_t * cvars)

Definition at line 901 of file cvar.c.

902{
903 cvar_t *c, *cp;
904
905 for (cp = cvars->vars; (c = cp);)
906 {
907 cp = c->next; // get next cvar now in case we delete this cvar
908
909 if (c->initstring)
910 {
911 // restore this cvar, it existed at init
912 Con_DPrintf("Cvar_RestoreInitState: Restoring cvar \"%s\"\n", c->name);
913
914 /* bones_was_here: intentionally NOT restoring defstring in this function.
915 * The only callsite, Host_LoadConfig_f, will re-exec quake.rc, default.cfg, etc.
916 * Defaults are unlocked here, so Cvar_LockDefaults_f will reset the defstring.
917 * This is more correct than restoring the defstring here
918 * because a gamedir change could load configs that should change defaults.
919 */
920
922 c->flags &= ~CF_DEFAULTSET;
923 }
924 else if (!(c->flags & (CF_PERSISTENT | CF_READONLY))) // cvars with those flags have no initstring AND may not be deleted or reset
925 {
926 // remove this cvar, it did not exist at init
927 Con_DPrintf("Cvar_RestoreInitState: cvar \"%s\"", c->name);
928 if (Cvar_Delete(cvars, c->name, NULL))
929 Con_DPrint("deleted.\n");
930 else
931 {
932 // In this case, at least reset it to the default.
933 Con_DPrint("reset.\n");
935 }
936 }
937 }
938}

References CF_PERSISTENT, CF_READONLY, Con_DPrint(), Con_DPrintf(), Cvar_Delete(), Cvar_SetQuick(), cvar_t::defstring, cvar_t::flags, cvar_t::initstring, cvar_t::name, cvar_t::next, NULL, and cvar_state_t::vars.

Referenced by Cmd_RestoreInitState().

◆ Cvar_SaveInitState()

void Cvar_SaveInitState ( cvar_state_t * cvars)

Definition at line 892 of file cvar.c.

893{
894 cvar_t *c;
895
896 for (c = cvars->vars;c;c = c->next)
897 if ((c->flags & (CF_PERSISTENT | CF_READONLY)) == 0)
898 c->initstring = Z_strdup(c->string);
899}

References CF_PERSISTENT, CF_READONLY, cvar_t::flags, cvar_t::initstring, cvar_t::next, cvar_t::string, cvar_state_t::vars, and Z_strdup.

Referenced by Cmd_SaveInitState().

◆ Cvar_Set()

void Cvar_Set ( cvar_state_t * cvars,
const char * var_name,
const char * value )

equivelant to "<name> <variable>" typed at the console

Definition at line 456 of file cvar.c.

457{
458 cvar_t *var;
459 var = Cvar_FindVar(cvars, var_name, ~0);
460 if (var == NULL)
461 {
462 Con_Printf(CON_WARN "Cvar_Set: variable %s not found\n", var_name);
463 return;
464 }
465 Cvar_SetQuick(var, value);
466}

References Con_Printf(), CON_WARN, Cvar_FindVar(), Cvar_SetQuick(), NULL, and value.

Referenced by Cvar_SetValue(), and SV_Map_f().

◆ Cvar_Set_f()

void Cvar_Set_f ( cmd_state_t * cmd)

Definition at line 1060 of file cvar.c.

1061{
1062 cvar_state_t *cvars = cmd->cvars;
1063 cvar_t *cvar;
1064
1065 // make sure it's the right number of parameters
1066 if (Cmd_Argc(cmd) < 3)
1067 {
1068 Con_Printf("Set: wrong number of parameters, usage: set <variablename> <value> [<description>]\n");
1069 return;
1070 }
1071
1072 // check if it's read-only
1073 cvar = Cvar_FindVar(cvars, Cmd_Argv(cmd, 1), ~0);
1074 if (cvar)
1075 if(Cvar_Readonly(cvar,"Set"))
1076 return;
1077
1079 Con_DPrint("Set: ");
1080
1081 // all looks ok, create/modify the cvar
1082 Cvar_Get(cvars, Cmd_Argv(cmd, 1), Cmd_Argv(cmd, 2), cmd->cvars_flagsmask, Cmd_Argc(cmd) > 3 ? Cmd_Argv(cmd, 3) : NULL);
1083}
cvar_t * Cvar_Get(cvar_state_t *cvars, const char *name, const char *value, unsigned flags, const char *newdescription)
allocates a cvar by name and returns its address, or merely sets its value if it already exists.
Definition cvar.c:695

References cmd(), Cmd_Argc(), Cmd_Argv(), Con_DPrint(), Con_Printf(), cvar(), Cvar_FindVar(), Cvar_Get(), Cvar_Readonly(), developer_extra, cvar_t::integer, and NULL.

Referenced by Cmd_Init().

◆ Cvar_SetA_f()

void Cvar_SetA_f ( cmd_state_t * cmd)

Definition at line 1085 of file cvar.c.

1086{
1087 cvar_state_t *cvars = cmd->cvars;
1088 cvar_t *cvar;
1089
1090 // make sure it's the right number of parameters
1091 if (Cmd_Argc(cmd) < 3)
1092 {
1093 Con_Printf("SetA: wrong number of parameters, usage: seta <variablename> <value> [<description>]\n");
1094 return;
1095 }
1096
1097 // check if it's read-only
1098 cvar = Cvar_FindVar(cvars, Cmd_Argv(cmd, 1), ~0);
1099 if (cvar)
1100 if(Cvar_Readonly(cvar,"SetA"))
1101 return;
1102
1104 Con_DPrint("SetA: ");
1105
1106 // all looks ok, create/modify the cvar
1107 Cvar_Get(cvars, Cmd_Argv(cmd, 1), Cmd_Argv(cmd, 2), cmd->cvars_flagsmask | CF_ARCHIVE, Cmd_Argc(cmd) > 3 ? Cmd_Argv(cmd, 3) : NULL);
1108}

References CF_ARCHIVE, cmd(), Cmd_Argc(), Cmd_Argv(), Con_DPrint(), Con_Printf(), cvar(), Cvar_FindVar(), Cvar_Get(), Cvar_Readonly(), developer_extra, cvar_t::integer, and NULL.

Referenced by Cmd_Init().

◆ Cvar_SetQuick()

void Cvar_SetQuick ( cvar_t * var,
const char * value )

Definition at line 436 of file cvar.c.

437{
438 if (var == NULL)
439 {
440 Con_Print(CON_WARN "Cvar_SetQuick: var == NULL\n");
441 return;
442 }
443
444 if (!(var->flags & CF_REGISTERED) && !(var->flags & CF_ALLOCATED))
445 {
446 Con_Printf(CON_WARN "Warning: Cvar_SetQuick() cannot set unregistered cvar \"%s\"\n", var->name);
447 return; // setting an unregistered engine cvar crashes
448 }
449
451 Con_DPrintf("Cvar_SetQuick({\"%s\", \"%s\", %i, \"%s\"}, \"%s\");\n", var->name, var->string, var->flags, var->defstring, value);
452
454}

References CF_ALLOCATED, CF_REGISTERED, Con_DPrintf(), Con_Print(), Con_Printf(), CON_WARN, Cvar_SetQuick_Internal(), cvar_t::defstring, developer_extra, cvar_t::flags, cvar_t::integer, cvar_t::name, NULL, cvar_t::string, and value.

Referenced by CL_Bottomcolor_c(), CL_Color_c(), CL_Connect_f(), CL_Name_f(), CL_NetworkTimeReceived(), CL_ParseServerInfo(), CL_Screen_Init(), CL_SetupWorldModel(), CL_StopPlayback(), CL_Topcolor_c(), Cmd_Toggle_f(), COM_Init_Commands(), Con_Init(), Con_RCon_ClearPassword_c(), Cvar_Command(), Cvar_ResetToDefaults_All_f(), Cvar_ResetToDefaults_NoSaveOnly_f(), Cvar_ResetToDefaults_SaveOnly_f(), Cvar_RestoreInitState(), Cvar_Set(), Cvar_SetValueQuick(), em_on_resize(), FOG_clear(), FS_Rescan(), GL_CheckExtension(), GL_Main_Init(), GL_Setup(), Host_InitSession(), M_GameOptions_Draw(), M_GameOptions_Key(), Mod_BrushInit(), NetConn_Init(), R_Shadow_EditLights_DrawSelectedLightProperties(), SV_MaxPlayers_f(), SV_ServerOptions(), SV_SpawnServer(), VID_ClearExtensions(), VID_InitModeGL(), VID_Start(), and VM_cvar_set().

◆ Cvar_SetQuick_Internal()

static void Cvar_SetQuick_Internal ( cvar_t * var,
const char * value )
static

Definition at line 390 of file cvar.c.

391{
392 qbool changed;
393 size_t valuelen;
394
395 changed = strcmp(var->string, value) != 0;
396 // LadyHavoc: don't reallocate when there is no change
397 if (!changed)
398 goto cvar_callback;
399
400 // LadyHavoc: don't reallocate when the buffer is the same size
401 valuelen = strlen(value);
402 if (!var->string || strlen(var->string) != valuelen)
403 {
404 Z_Free ((char *)var->string); // free the old value string
405
406 var->string = (char *)Z_Malloc (valuelen + 1);
407 }
408 memcpy ((char *)var->string, value, valuelen + 1);
409 var->value = atof (var->string);
410 var->integer = (int) var->value;
411 if ((var->flags & CF_NOTIFY) && sv.active && !sv_disablenotify.integer)
412 SV_BroadcastPrintf("\003^3Server cvar \"%s\" changed to \"%s\"\n", var->name, var->string);
413#if 0
414 // TODO: add infostring support to the server?
415 if ((var->flags & CF_SERVERINFO) && changed && sv.active)
416 {
418 if (sv.active)
419 {
420 MSG_WriteByte (&sv.reliable_datagram, svc_serverinfostring);
423 }
424 }
425#endif
426 if (var->flags & CF_USERINFO)
427 CL_SetInfo(var->name, var->string, true, false, false, false);
428
430
431cvar_callback:
432 // Call the function stored in the cvar for bounds checking, cleanup, etc
433 Cvar_Callback(var);
434}
void CL_SetInfo(const char *key, const char *value, qbool send, qbool allowstarkey, qbool allowmodel, qbool quiet)
Definition cl_main.c:233
#define CF_NOTIFY
cvar should trigger a chat notification to all connected clients when changed
Definition cmd.h:55
#define CF_SERVERINFO
command or cvar relevant to serverinfo string handling
Definition cmd.h:56
#define CF_USERINFO
command or cvar used to communicate userinfo to the server
Definition cmd.h:57
void InfoString_SetValue(char *buffer, size_t bufferlength, const char *key, const char *value)
void MSG_WriteString(sizebuf_t *sb, const char *s)
Definition com_msg.c:173
void MSG_WriteByte(sizebuf_t *sb, int c)
Definition com_msg.c:130
cvar_t sv_disablenotify
Definition sv_main.c:42
static void Cvar_UpdateAutoCvar(cvar_t *var)
we assume that prog is already set to the target progs
Definition cvar.c:320
void Cvar_Callback(cvar_t *var)
Definition cvar.c:372
server_t sv
local server
Definition sv_main.c:223
void SV_BroadcastPrintf(const char *fmt,...) DP_FUNC_PRINTF(1)
Definition sv_send.c:116
server_static_t svs
persistant server info
Definition sv_main.c:224
char serverinfo[MAX_SERVERINFO_STRING]
server infostring
Definition server.h:36
qbool active
false if only a net client
Definition server.h:66
sizebuf_t reliable_datagram
Definition server.h:130

References server_t::active, CF_NOTIFY, CF_SERVERINFO, CF_USERINFO, CL_SetInfo(), Cvar_Callback(), Cvar_UpdateAutoCvar(), cvar_t::flags, InfoString_SetValue(), int(), cvar_t::integer, MSG_WriteByte(), MSG_WriteString(), cvar_t::name, server_t::reliable_datagram, server_static_t::serverinfo, cvar_t::string, strlen(), sv, SV_BroadcastPrintf(), sv_disablenotify, svs, cvar_t::value, value, Z_Free, and Z_Malloc.

Referenced by Cvar_Get(), and Cvar_SetQuick().

◆ Cvar_SetValue()

void Cvar_SetValue ( cvar_state_t * cvars,
const char * var_name,
float value )

expands value to a string and calls Cvar_Set

Definition at line 484 of file cvar.c.

485{
486 char val[MAX_INPUTLINE];
487
488 if ((float)((int)value) == value)
489 dpsnprintf(val, sizeof(val), "%i", (int)value);
490 else
491 dpsnprintf(val, sizeof(val), "%f", value);
492 Cvar_Set(cvars, var_name, val);
493}
int dpsnprintf(char *buffer, size_t buffersize, const char *format,...)
Returns the number of printed characters, excluding the final '\0' or returns -1 if the buffer isn't ...
Definition common.c:997
void Cvar_Set(cvar_state_t *cvars, const char *var_name, const char *value)
equivelant to "<name> <variable>" typed at the console
Definition cvar.c:456
#define MAX_INPUTLINE
maximum size of console commandline, QuakeC strings, and many other text processing buffers
Definition qdefs.h:94

References Cvar_Set(), dpsnprintf(), MAX_INPUTLINE, and value.

◆ Cvar_SetValueQuick()

void Cvar_SetValueQuick ( cvar_t * var,
float value )

Definition at line 473 of file cvar.c.

474{
475 char val[MAX_INPUTLINE];
476
477 if ((float)((int)value) == value)
478 dpsnprintf(val, sizeof(val), "%i", (int)value);
479 else
480 dpsnprintf(val, sizeof(val), "%f", value);
481 Cvar_SetQuick(var, val);
482}

References Cvar_SetQuick(), dpsnprintf(), MAX_INPUTLINE, and value.

Referenced by CDAudio_Init(), CDAudio_StartPlaylist(), CDAudio_StopPlaylistTrack(), CL_Beams_SetupExternalTexture(), CL_BeginDownloads(), CL_Color_f(), CL_DisconnectEx(), CL_DrawVideo(), CL_Init(), CL_ParseServerInfo(), CL_UpdateScreen(), CL_VM_Init(), Cmd_Toggle_f(), Con_CheckResize(), Con_DrawNotify(), em_on_resize(), FS_Rescan(), GL_Main_Init(), GL_SetupTextureParameters(), Host_Framerate_c(), Host_Timescale_c(), Key_Console(), M_LanConfig_Key(), M_Menu_Options_AdjustSliders(), M_Menu_Options_ColorControl_AdjustSliders(), M_Menu_Options_Effects_AdjustSliders(), M_Menu_Options_Graphics_AdjustSliders(), M_Menu_Video_AdjustSliders(), M_NetStart_Change(), M_Options_ColorControl_Key(), M_Video_Key(), Memory_Init_Commands(), MR_Init(), NetConn_Heartbeat(), NetConn_Init(), NetConn_OpenClientPorts(), NetConn_OpenServerPorts(), R_Bloom_StartFrame(), R_BufferData_Resize(), R_FrameData_Alloc(), R_HDR_UpdateIrisAdaptation(), R_Mesh_Start(), R_MeshQueue_RenderTransparent(), R_Shadow_DrawModelShadowMaps(), R_Shadow_EditLights_DrawSelectedLightProperties(), R_Textures_Frame(), r_textures_start(), R_TimeReport_EndFrame(), R_UpdateVariables(), R_Water_ProcessPlanes(), S_Init(), S_SetChannelLayout(), S_Startup(), S_Terminate(), SCR_SizeDown_f(), SCR_SizeUp_f(), SCR_UpdateVars(), SndSys_Init(), SV_Loadgame_f(), SV_SendClientDatagram(), SV_ServerOptions(), SV_SpawnServer(), Sys_DirtyTime(), Sys_SDL_HandleEvents(), VID_EnableJoystick(), VID_Init(), VID_InitMode(), VID_InitModeGL(), VID_Restart_f(), VID_SetMouse(), VID_Shared_SetJoystick(), and VID_Start().

◆ Cvar_UnlockDefaults()

void Cvar_UnlockDefaults ( cmd_state_t * cmd)

Definition at line 862 of file cvar.c.

863{
864 cvar_state_t *cvars = cmd->cvars;
865 cvar_t *var;
866 // unlock the default values of all cvars
867 for (var = cvars->vars ; var ; var = var->next)
868 var->flags &= ~CF_DEFAULTSET;
869}

References cmd(), cvar_t::flags, cvar_t::next, and cvar_state_t::vars.

◆ Cvar_UpdateAllAutoCvars()

void Cvar_UpdateAllAutoCvars ( cvar_state_t * cvars)

called after loading a savegame

Definition at line 365 of file cvar.c.

366{
367 cvar_t *var;
368 for (var = cvars->vars ; var ; var = var->next)
370}

References Cvar_UpdateAutoCvar(), cvar_t::next, and cvar_state_t::vars.

Referenced by SV_Loadgame_f().

◆ Cvar_UpdateAutoCvar()

static void Cvar_UpdateAutoCvar ( cvar_t * var)
static

we assume that prog is already set to the target progs

Definition at line 320 of file cvar.c.

321{
322 int i;
323 int j;
324 const char *s;
325 vec3_t v;
326 prvm_prog_t *prog;
327 for (i = 0;i < PRVM_PROG_MAX;i++)
328 {
329 prog = &prvm_prog_list[i];
330 if (prog->loaded && var->globaldefindex[i] >= 0)
331 {
332 // MUST BE SYNCED WITH prvm_edict.c PRVM_Prog_Load
333 switch(prog->globaldefs[var->globaldefindex[i]].type & ~DEF_SAVEGLOBAL)
334 {
335 case ev_float:
337 break;
338 case ev_vector:
339 s = var->string;
340 VectorClear(v);
341 for (j = 0;j < 3;j++)
342 {
343 while (*s && ISWHITESPACE(*s))
344 s++;
345 if (!*s)
346 break;
347 v[j] = atof(s);
348 while (!ISWHITESPACE(*s))
349 s++;
350 if (!*s)
351 break;
352 }
354 break;
355 case ev_string:
358 break;
359 }
360 }
361 }
362}
#define VectorClear(a)
Definition mathlib.h:97
#define VectorCopy(in, out)
Definition mathlib.h:101
#define DEF_SAVEGLOBAL
Definition pr_comp.h:421
@ ev_vector
Definition pr_comp.h:29
@ ev_string
Definition pr_comp.h:29
@ ev_float
Definition pr_comp.h:29
const char * PRVM_ChangeEngineString(prvm_prog_t *prog, int i, const char *s)
#define PRVM_GLOBALFIELDFLOAT(fieldoffset)
Definition progsvm.h:216
#define PRVM_GLOBALFIELDSTRING(fieldoffset)
Definition progsvm.h:218
#define PRVM_GLOBALFIELDVECTOR(fieldoffset)
Definition progsvm.h:217
#define ISWHITESPACE(ch)
Definition qdefs.h:184
vec_t vec3_t[3]
Definition qtypes.h:71
uint32_t ofs
Definition pr_comp.h:416
uint32_t type
Definition pr_comp.h:414
mdef_t * globaldefs
Definition progsvm.h:546

References DEF_SAVEGLOBAL, ev_float, ev_string, ev_vector, cvar_t::globaldefindex, cvar_t::globaldefindex_stringno, prvm_prog_t::globaldefs, i, ISWHITESPACE, prvm_prog_t::loaded, mdef_t::ofs, PRVM_ChangeEngineString(), PRVM_GLOBALFIELDFLOAT, PRVM_GLOBALFIELDSTRING, PRVM_GLOBALFIELDVECTOR, prvm_prog_list, PRVM_PROG_MAX, cvar_t::string, mdef_t::type, v, cvar_t::value, VectorClear, and VectorCopy.

Referenced by Cvar_SetQuick_Internal(), and Cvar_UpdateAllAutoCvars().

◆ Cvar_VariableDefString()

const char * Cvar_VariableDefString ( cvar_state_t * cvars,
const char * var_name,
unsigned neededflags )

Definition at line 159 of file cvar.c.

160{
161 cvar_t *var;
162
163 var = Cvar_FindVar(cvars, var_name, neededflags);
164 if (!var)
165 return cvar_null_string;
166 return var->defstring;
167}
static const char * cvar_null_string
Definition cvar.c:26

References Cvar_FindVar(), cvar_null_string, and cvar_t::defstring.

Referenced by Key_Console(), and VM_cvar_defstring().

◆ Cvar_VariableDescription()

const char * Cvar_VariableDescription ( cvar_state_t * cvars,
const char * var_name,
unsigned neededflags )

Definition at line 174 of file cvar.c.

175{
176 cvar_t *var;
177
178 var = Cvar_FindVar(cvars, var_name, neededflags);
179 if (!var)
180 return cvar_null_string;
181 return var->description;
182}
const char * description
Definition cvar.h:72

References Cvar_FindVar(), cvar_null_string, and cvar_t::description.

Referenced by VM_cvar_description().

◆ Cvar_VariableString()

const char * Cvar_VariableString ( cvar_state_t * cvars,
const char * var_name,
unsigned neededflags )

Definition at line 149 of file cvar.c.

150{
151 return Cvar_VariableStringOr(cvars, var_name, cvar_null_string, neededflags);
152}
const char * Cvar_VariableStringOr(cvar_state_t *cvars, const char *var_name, const char *def, unsigned neededflags)
Definition cvar.c:139

References cvar_null_string, and Cvar_VariableStringOr().

Referenced by Con_CompleteCommandLine(), Key_Parse_CommonKeys(), SV_Status_f(), and VM_cvar_string().

◆ Cvar_VariableStringOr()

const char * Cvar_VariableStringOr ( cvar_state_t * cvars,
const char * var_name,
const char * def,
unsigned neededflags )

Definition at line 139 of file cvar.c.

140{
141 cvar_t *var;
142
143 var = Cvar_FindVar(cvars, var_name, neededflags);
144 if (!var)
145 return def;
146 return var->string;
147}

References Cvar_FindVar(), and cvar_t::string.

Referenced by Cvar_VariableString().

◆ Cvar_VariableValue()

float Cvar_VariableValue ( cvar_state_t * cvars,
const char * var_name,
unsigned neededflags )

Definition at line 129 of file cvar.c.

130{
131 return Cvar_VariableValueOr(cvars, var_name, 0, neededflags);
132}
float Cvar_VariableValueOr(cvar_state_t *cvars, const char *var_name, float def, unsigned neededflags)
Definition cvar.c:119

References Cvar_VariableValueOr().

Referenced by Mod_LoadQ3Shaders(), and VM_cvar().

◆ Cvar_VariableValueOr()

float Cvar_VariableValueOr ( cvar_state_t * cvars,
const char * var_name,
float def,
unsigned neededflags )

Definition at line 119 of file cvar.c.

120{
121 cvar_t *var;
122
123 var = Cvar_FindVar(cvars, var_name, neededflags);
124 if (!var)
125 return def;
126 return atof (var->string);
127}

References Cvar_FindVar(), and cvar_t::string.

Referenced by Cvar_VariableValue(), and SND_Spatialize_WithSfx().

◆ Cvar_WriteVariables()

void Cvar_WriteVariables ( cvar_state_t * cvars,
qfile_t * f )

Definition at line 985 of file cvar.c.

986{
987 cvar_t *var;
988 char buf1[MAX_INPUTLINE], buf2[MAX_INPUTLINE];
989
990 // don't save cvars that match their default value
991 for (var = cvars->vars ; var ; var = var->next) {
992 if ((var->flags & CF_ARCHIVE) && (strcmp(var->string, var->defstring) || ((var->flags & CF_ALLOCATED) && !(var->flags & CF_DEFAULTSET))))
993 {
994 Cmd_QuoteString(buf1, sizeof(buf1), var->name, "\"\\$", false);
995 Cmd_QuoteString(buf2, sizeof(buf2), var->string, "\"\\$", false);
996 FS_Printf(f, "%s\"%s\" \"%s\"\n", var->flags & CF_ALLOCATED ? "seta " : "", buf1, buf2);
997 }
998 }
999}
qbool Cmd_QuoteString(char *out, size_t outlen, const char *in, const char *quoteset, qbool putquotes)
quotes a string so that it can be used as a command argument again; quoteset is a string that contain...
Definition cmd.c:1000
int FS_Printf(qfile_t *file, const char *format,...)
Definition fs.c:3273
float f

References CF_ALLOCATED, CF_ARCHIVE, CF_DEFAULTSET, Cmd_QuoteString(), cvar_t::defstring, f, cvar_t::flags, FS_Printf(), MAX_INPUTLINE, cvar_t::name, cvar_t::next, cvar_t::string, and cvar_state_t::vars.

Referenced by Host_SaveConfig().

Variable Documentation

◆ cvar_dummy_description

const char* cvar_dummy_description = "custom cvar"

Definition at line 25 of file cvar.c.

Referenced by Cvar_Delete(), Cvar_Get(), and VM_cvar_type().

◆ cvar_null_string

const char* cvar_null_string = ""
static

Definition at line 26 of file cvar.c.

Referenced by Cvar_VariableDefString(), Cvar_VariableDescription(), and Cvar_VariableString().

◆ cvars_all

◆ cvars_null

cvar_state_t cvars_null

Definition at line 29 of file cvar.c.

Referenced by Cmd_Init().

◆ sv_disablenotify

cvar_t sv_disablenotify
extern

Definition at line 42 of file sv_main.c.

42{CF_SERVER, "sv_disablenotify", "0", "suppress broadcast prints when certain cvars are changed (CF_NOTIFY flag in engine code)"};
#define CF_SERVER
cvar/command that only the server can change/execute
Definition cmd.h:49

Referenced by Cvar_SetQuick_Internal(), and SV_Init().