Cvar (console variable) header file. More...

#include "../shared/shared.h"
#include "../common/scripts_lua.h"

Include dependency graph for cvar.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	cvarChangeListener_t
struct	cvar_t
	This is a cvar definition. Cvars can be user modified and used in our menus e.g. More...
struct	cvarList_t
class	CvarListener
	Listener for cvar changes. More...

Macros
#define	CVAR_ARCHIVE 1
#define	CVAR_USERINFO 2
#define	CVAR_SERVERINFO 4
#define	CVAR_NOSET 8
#define	CVAR_LATCH 16
#define	CVAR_DEVELOPER 32
#define	CVAR_CHEAT 64
#define	CVAR_R_IMAGES 128
#define	CVAR_R_CONTEXT 256
#define	CVAR_R_PROGRAMS 512
#define	CVAR_R_MASK (CVAR_R_IMAGES \| CVAR_R_CONTEXT \| CVAR_R_PROGRAMS)

Typedefs
typedef void(*	cvarChangeListenerFunc_t) (const char cvarName, const char oldValue, const char newValue, void data)
	Callback for the change listener.
typedef SharedPtr< CvarListener >	CvarListenerPtr

Functions
cvar_t *	Cvar_GetFirst (void)
	Return the first cvar of the cvar list.
cvar_t *	Cvar_Get (const char varName, const char value="", int flags=0, const char *desc=nullptr)
	creates the variable if it doesn't exist, or returns the existing one if it exists, the value will not be changed, but flags will be ORed in that allows variables to be unarchived without needing bitflags
cvar_t *	Cvar_Set (const char varName, const char value,...) __attribute__((format(__printf__
	will create the variable if it doesn't exist
cvar_t cvar_t *	Cvar_ForceSet (const char varName, const char value)
	will set the variable even if NOSET or LATCH
cvar_t *	Cvar_FullSet (const char varName, const char value, int flags)
	Sets a cvar from console with the given flags.
void	Cvar_SetValue (const char *varName, float value)
	expands value to a string and calls Cvar_Set
int	Cvar_GetInteger (const char *varName)
	returns 0 if not defined or non numeric
float	Cvar_GetValue (const char *varName)
	returns 0.0 if not defined or non numeric
const char *	Cvar_GetString (const char *varName)
	returns an empty string if not defined
const char *	Cvar_VariableStringOld (const char *varName)
	returns an empty string if not defined
int	Cvar_CompleteVariable (const char partial, const char *match)
	attempts to match a partial variable name for command line completion returns nullptr if nothing fits
void	Cvar_UpdateLatchedVars (void)
	any CVAR_LATCHED variables that have been set will now take effect
bool	Cvar_Command (void)
	called by Cmd_ExecuteString when Cmd_Argv(0) doesn't match a known command. Returns true if the command was a variable reference that was handled. (print or change)
void	Cvar_Init (void)
	Reads in all archived cvars.
void	Cvar_Shutdown (void)
const char *	Cvar_Userinfo (char *info, size_t infoSize)
	returns an info string containing all the CVAR_USERINFO cvars
const char *	Cvar_Serverinfo (char *info, size_t infoSize)
	returns an info string containing all the CVAR_SERVERINFO cvars
bool	Cvar_AssertValue (cvar_t *cvar, float minVal, float maxVal, bool shouldBeIntegral)
	this function checks cvar ranges and integral values
bool	Cvar_SetCheckFunction (const char varName, bool(check)(cvar_t *cvar))
	Sets the check functions for a cvar (e.g. Cvar_Assert).
cvarChangeListener_t *	Cvar_RegisterChangeListener (const char *varName, cvarChangeListenerFunc_t listenerFunc)
	Registers a listener that is executed each time a cvar changed its value.
void	Cvar_UnRegisterChangeListener (const char *varName, cvarChangeListenerFunc_t listenerFunc)
	Unregisters a cvar change listener.
void	Cvar_RegisterCvarListener (CvarListenerPtr listener)
	Registers a cvar listener.
void	Cvar_UnRegisterCvarListener (CvarListenerPtr listener)
	Unregisters a cvar listener.
void	Cvar_FixCheatVars (void)
	Reset cheat cvar values to default.
bool	Cvar_Delete (const char *varName)
	Function to remove the cvar and free the space.
cvar_t *	Cvar_FindVar (const char *varName)
	Searches for a cvar given by parameter.
bool	Cvar_PendingCvars (int flags)
	Checks whether there are pending cvars for the given flags.
void	Com_SetUserinfoModified (bool modified)
bool	Com_IsUserinfoModified (void)
void	Com_SetRenderModified (bool modified)
bool	Com_IsRenderModified (void)
void	Cvar_ClearVars (int flags)
void	Cvar_Reset (cvar_t *cvar)
	Sets the cvar value back to the old value.

Detailed Description

Cvar (console variable) header file.

cvar_t variables are used to hold scalar or string variables that can be changed or displayed at the console or prog code as well as accessed directly in C code. The user can access cvars from the console in three ways: r_draworder prints the current value r_draworder 0 sets the current value to 0 set r_draworder 0 as above, but creates the cvar if not present Cvars are restricted from having the same names as commands to keep this interface from being ambiguous.

Definition in file cvar.h.

Macro Definition Documentation

◆ CVAR_ARCHIVE

#define CVAR_ARCHIVE 1

set to cause it to be saved to vars.rc

Definition at line 40 of file cvar.h.

Referenced by ACTOR_InitStartup(), CL_CameraInit(), CL_InitLocal(), CL_ViewInit(), Con_Init(), Cvar_List_f(), Cvar_Set_f(), Cvar_Switch_f(), Cvar_WriteVariables(), G_Init(), GAME_MP_CallbacksInit(), GAME_MP_ServerListInit(), HUD_InitStartup(), IN_Init(), IN_StartupJoystick(), Irc_Init(), M_Init(), NET_Init(), PTL_InitStartup(), Qcommon_Init(), R_InitExtensions(), R_RegisterSystemVars(), R_SphereInit(), S_Init(), S_MumbleInit(), SAV_Init(), SAV_InitCallbacks(), SCR_Init(), GameTest::SetUpTestCase(), SV_Init(), Sys_Init(), TOTD_InitStartup(), UI_Init(), UI_InitDraw(), UI_RegisterGeoscapeNode(), VID_Init(), and WEB_InitStartup().

◆ CVAR_CHEAT

#define CVAR_CHEAT 64

clamp to the default value when cheats are off

Definition at line 46 of file cvar.h.

Referenced by Cvar_FixCheatVars(), Cvar_Get(), and G_Init().

◆ CVAR_DEVELOPER

#define CVAR_DEVELOPER 32

set from commandline (not from within the game) and hide from console

Definition at line 45 of file cvar.h.

Referenced by CP_InitStartup(), Cvar_CompleteVariable(), Cvar_List_f(), Cvar_Set2(), G_Init(), GEO_InitStartup(), UFO_InitStartup(), and UI_Init().

◆ CVAR_LATCH

#define CVAR_LATCH 16

save changes until server restart

Definition at line 44 of file cvar.h.

Referenced by Cvar_List_f(), Cvar_Set2(), Cvar_Set_f(), Cvar_Switch_f(), G_Init(), HUD_InitStartup(), R_RegisterSystemVars(), S_MumbleInit(), SV_Init(), SV_InitGame(), and SV_Shutdown().

◆ CVAR_NOSET

#define CVAR_NOSET 8

don't allow change from console at all, but can be set from the command line

Definition at line 43 of file cvar.h.

Referenced by CL_InitLocal(), Cvar_List_f(), Cvar_Set2(), Cvar_Set_f(), Cvar_Switch_f(), G_Init(), GAME_SetMode(), Irc_Init(), Qcommon_Init(), GameTest::SetUpTestCase(), SV_Init(), SV_Map(), SV_Shutdown(), and TEST_F().

◆ CVAR_R_CONTEXT

#define CVAR_R_CONTEXT 256

vid shutdown if such a cvar was modified

Definition at line 48 of file cvar.h.

Referenced by CL_Init(), CL_Shutdown(), R_RegisterSystemVars(), and VID_Init().

◆ CVAR_R_IMAGES

#define CVAR_R_IMAGES 128

effects image filtering

Definition at line 47 of file cvar.h.

Referenced by CL_Init(), CL_Shutdown(), Cvar_List_f(), and R_RegisterSystemVars().

◆ CVAR_R_MASK

#define CVAR_R_MASK (CVAR_R_IMAGES | CVAR_R_CONTEXT | CVAR_R_PROGRAMS)

Definition at line 51 of file cvar.h.

Referenced by Cvar_Set2(), R_BeginFrame(), and R_Init().

◆ CVAR_R_PROGRAMS

#define CVAR_R_PROGRAMS 512

if changed, shaders are restarted

Definition at line 49 of file cvar.h.

Referenced by R_BeginFrame(), R_InitExtensions(), and R_RegisterSystemVars().

◆ CVAR_SERVERINFO

#define CVAR_SERVERINFO 4

added to serverinfo when changed

Definition at line 42 of file cvar.h.

Referenced by CL_InitLocal(), Cvar_Get(), Cvar_List_f(), Cvar_Serverinfo(), Cvar_Set2(), Cvar_Set_f(), Cvar_Switch_f(), G_Init(), GAME_MP_CallbacksInit(), Qcommon_Init(), GameTest::SetUpTestCase(), SV_Init(), SV_Map(), and Sys_Init().

◆ CVAR_USERINFO

#define CVAR_USERINFO 2

added to userinfo when changed

Definition at line 41 of file cvar.h.

Referenced by ACTOR_InitStartup(), CL_InitLocal(), Cvar_FullSet(), Cvar_Get(), Cvar_List_f(), Cvar_Set2(), Cvar_Set_f(), Cvar_Switch_f(), Cvar_Userinfo(), G_Init(), GAME_MP_CallbacksInit(), and TEST_F().

Typedef Documentation

◆ cvarChangeListenerFunc_t

typedef void(* cvarChangeListenerFunc_t) (const char *cvarName, const char *oldValue, const char *newValue, void *data)

Callback for the change listener.

Parameters

cvarName	The name of the cvar that was changed.
oldValue	The old value of the cvar - this is never `nullptr`, but can be empty.
newValue	The new value of the cvar - this is never `nullptr`, but can be empty.

Definition at line 59 of file cvar.h.

◆ CvarListenerPtr

typedef SharedPtr<CvarListener> CvarListenerPtr

Definition at line 105 of file cvar.h.

Function Documentation

◆ Com_IsRenderModified()

bool Com_IsRenderModified ( void )

Definition at line 71 of file cvar.cpp.

References renderModified.

Referenced by Cvar_Set(), and R_BeginFrame().

◆ Com_IsUserinfoModified()

bool Com_IsUserinfoModified ( void )

Definition at line 61 of file cvar.cpp.

References userinfoModified.

Referenced by CL_SendChangedUserinfos(), and Cvar_Set().

◆ Com_SetRenderModified()

void Com_SetRenderModified ( bool modified )

Definition at line 66 of file cvar.cpp.

References renderModified.

Referenced by Cvar_Set(), Cvar_Set2(), Qcommon_Init(), and R_BeginFrame().

◆ Com_SetUserinfoModified()

void Com_SetUserinfoModified ( bool modified )

Definition at line 56 of file cvar.cpp.

References userinfoModified.

Referenced by CL_Connect(), CL_SendChangedUserinfos(), Cvar_FullSet(), Cvar_Set(), Cvar_Set2(), and Qcommon_Init().

◆ Cvar_AssertValue()

bool Cvar_AssertValue	(	cvar_t *	cvar,
		float	minVal,
		float	maxVal,
		bool	shouldBeIntegral )

this function checks cvar ranges and integral values

Returns: true if assert isn't true and the cvar was changed to a valid value, false if the new value is ok and nothing was changed.

Parameters

[in]	cvar	Cvar to check
[in]	minVal	The minimal value the cvar should have
[in]	maxVal	The maximal value the cvar should have
[in]	shouldBeIntegral	No floats for this cvar please

Definition at line 161 of file cvar.cpp.

References Com_Printf(), Cvar_Set(), Cvar_SetValue(), cvar_t::integer, cvar_t::name, and cvar_t::value.

Referenced by CL_CvarCheckVidGamma(), CL_CvarCheckVidMode(), CL_CvarWorldLevel(), Com_CvarCheckMaxFPS(), Cvar_Set(), R_CvarCheckDynamicLights(), R_CvarCheckMaxLightmap(), R_CvarCheckMultisample(), R_CvarCheckWeather(), R_CvarPostProcess(), R_CvarPrograms(), and SV_CheckMaxSoldiersPerPlayer().

◆ Cvar_ClearVars()

void Cvar_ClearVars ( int flags )

Definition at line 891 of file cvar.cpp.

References cvarVars.

Referenced by Cvar_Set(), R_BeginFrame(), and R_Init().

◆ Cvar_Command()

bool Cvar_Command ( void )

called by Cmd_ExecuteString when Cmd_Argv(0) doesn't match a known command. Returns true if the command was a variable reference that was handled. (print or change)

Returns: True if cvar exists - false otherwise

You can print the current value or set a new value with this function To set a new value for a cvar from within the console just type the cvar name followed by the value. To print the current cvar's value just type the cvar name and hit enter

See also: Cvar_Set_f; Cvar_SetValue; Cvar_Set

Definition at line 708 of file cvar.cpp.

References Cmd_Argc(), Cmd_Argv(), Com_Printf(), Cvar_FindVar(), Cvar_Set(), and v.

Referenced by Cmd_vExecuteString(), and Cvar_Set().

◆ Cvar_CompleteVariable()

int Cvar_CompleteVariable	(	const char *	partial,
		const char **	match )

attempts to match a partial variable name for command line completion returns nullptr if nothing fits

Parameters

	partial	The beginning of the variable we try to complete
[out]	match	The found entry of the list we are searching, in case of more than one entry their common suffix is returned.

See also: Cmd_CompleteCommand; Key_CompleteCommand

Definition at line 258 of file cvar.cpp.

References Cmd_GenericCompleteFunction(), Com_Printf(), CVAR_DEVELOPER, cvarVars, and S_COLOR_GREEN.

Referenced by Com_ConsoleCompleteCommand(), and Cvar_Set().

◆ Cvar_Delete()

bool Cvar_Delete ( const char * varName )

Function to remove the cvar and free the space.

Definition at line 279 of file cvar.cpp.

References cvar_t::changeListener, Com_HashKey(), Com_Printf(), CVAR_HASH_SIZE, cvarListeners, cvarVars, cvarVarsHash, cvar_t::defaultString, cvar_t::description, cvar_t::flags, hash, HASH_Delete, i, cvar_t::latchedString, Mem_Free, cvar_t::name, cvar_t::next, cvarChangeListener_t::next, cvar_t::oldString, cvar_t::prev, Q_strcasecmp, and cvar_t::string.

Referenced by _wrap_delvar(), cgame_import_t::bool(), Cvar_Del_f(), Cvar_Set(), GAME_GetImportData(), GAMECvarListener::onGameModeChange(), and UI_ExecuteAction().

◆ Cvar_FindVar()

cvar_t * Cvar_FindVar ( const char * varName )

Searches for a cvar given by parameter.

Parameters

varName The cvar name as string

Returns: Pointer to cvar_t struct or nullptr if no cvar with the specified name was found

See also: Cvar_GetString; Cvar_SetValue

Definition at line 106 of file cvar.cpp.

References Com_HashKey(), CVAR_HASH_SIZE, cvarVarsHash, hash, and Q_streq.

Referenced by _wrap_findvar(), Cvar_Add_f(), Cvar_Command(), Cvar_Define_f(), Cvar_FullSet(), Cvar_Get(), Cvar_GetInteger(), Cvar_GetString(), Cvar_GetValue(), Cvar_Mod_f(), Cvar_RegisterChangeListener(), Cvar_Set(), Cvar_Set2(), Cvar_Set_f(), Cvar_SetCheckFunction(), Cvar_SetOld_f(), Cvar_Switch_f(), Cvar_UnRegisterChangeListener(), Cvar_VariableStringOld(), INV_UpdateObject_f(), uiCvarNode::onWindowClosed(), uiTabNode::onWindowOpened(), SV_GetCvarToken(), UI_GetBooleanFromExpression(), and UI_RemoveCvarListener_f().

◆ Cvar_FixCheatVars()

void Cvar_FixCheatVars ( void )

Reset cheat cvar values to default.

See also: CL_SendCommand

Definition at line 1042 of file cvar.cpp.

References com_cvarSysPool, Com_Printf(), Com_ServerState(), CVAR_CHEAT, Cvar_GetInteger(), cvarVars, Mem_Free, Mem_PoolStrDup, and Q_streq.

Referenced by CL_SendCommand(), and Cvar_Set().

◆ Cvar_ForceSet()

cvar_t cvar_t * Cvar_ForceSet	(	const char *	varName,
		const char *	value )

will set the variable even if NOSET or LATCH

Definition at line 604 of file cvar.cpp.

References Cvar_Set2().

Referenced by CL_ActorSelect(), CL_CharacterSkillAndScoreCvars(), Cvar_Set(), GAME_GetImportData(), INV_ItemDescription(), Irc_Client_CmdNick(), Irc_Client_CmdTopic(), Irc_Client_Join(), Irc_Client_Msg_f(), Irc_Logic_Disconnect(), uiTabNode::onWindowOpened(), Qcommon_Init(), SV_StartGame_f(), UI_ExecuteSetAction(), UI_TextEntryNodeAbortEdition(), and UI_TextEntryNodeEdit().

◆ Cvar_FullSet()

cvar_t * Cvar_FullSet	(	const char *	varName,
		const char *	value,
		int	flags )

Sets a cvar from console with the given flags.

Note: flags are: CVAR_ARCHIVE These cvars will be saved. CVAR_USERINFO Added to userinfo when changed. CVAR_SERVERINFO Added to serverinfo when changed. CVAR_NOSET Don't allow change from console at all but can be set from the command line. CVAR_LATCH Save changes until server restart.

Parameters

varName	Which cvar
value	Which value for the cvar
flags	which flags

See also: Cvar_Set_f

Definition at line 640 of file cvar.cpp.

References com_cvarSysPool, Com_SetUserinfoModified(), Cvar_FindVar(), Cvar_Get(), CVAR_USERINFO, cvar_t::flags, cvar_t::integer, Mem_Free, Mem_PoolStrDup, cvar_t::modified, cvar_t::oldString, cvar_t::string, and cvar_t::value.

Referenced by Cvar_Set(), Cvar_Set_f(), Cvar_Switch_f(), GAME_SetMode(), and SV_Map().

◆ Cvar_Get()

cvar_t * Cvar_Get	(	const char *	var_name,
		const char *	var_value,
		int	flags,
		const char *	desc )

creates the variable if it doesn't exist, or returns the existing one if it exists, the value will not be changed, but flags will be ORed in that allows variables to be unarchived without needing bitflags

Parameters

[in]	var_name	The cvar name
[in]	var_value	The standard cvar value (will be set if the cvar doesn't exist)
[in]	flags	CVAR_USERINFO, CVAR_LATCH, CVAR_SERVERINFO, CVAR_ARCHIVE and so on
[in]	desc	This is a short description of the cvar (see console command cvarlist)

Note: CVAR_ARCHIVE: Cvar will be saved to config.cfg when game shuts down - and will be reloaded when game starts up the next time; CVAR_LATCH: Latched cvars will be updated at the next map load; CVAR_SERVERINFO: This cvar will be send in the server info response strings (server browser); CVAR_NOSET: This cvar can not be set from the commandline; CVAR_USERINFO: This cvar will be added to the userinfo string when changed (network synced); CVAR_DEVELOPER: Only changeable if we are in development mode If the variable already exists, the value will not be set The flags will be or'ed in if the variable exists.

Definition at line 342 of file cvar.cpp.

References com_cvarSysPool, Com_HashKey(), Com_Printf(), CVAR_CHEAT, Cvar_FindVar(), CVAR_HASH_SIZE, Cvar_InfoValidate(), CVAR_SERVERINFO, CVAR_USERINFO, cvarListeners, cvarVars, cvarVarsHash, cvar_t::defaultString, cvar_t::description, cvar_t::flags, hash, HASH_Add, i, cvar_t::integer, Mem_Free, Mem_PoolAllocType, Mem_PoolStrDup, cvar_t::modified, cvar_t::name, cvar_t::next, cvar_t::oldString, cvar_t::string, and cvar_t::value.