X-Git-Url: http://de.git.xonotic.org/?a=blobdiff_plain;f=cvar.h;h=8fb6ca2c75e50e63f090be0ecbf9385b65f7104c;hb=16121fcfd55d2e1fda8a39295356241f56d537f4;hp=4224653e829fa581f50aae873ec6890db1661b1e;hpb=bd117c30bdcd6dc925030dc47cb6492d5d9da2d2;p=xonotic%2Fdarkplaces.git diff --git a/cvar.h b/cvar.h index 4224653e..8fb6ca2c 100644 --- a/cvar.h +++ b/cvar.h @@ -65,8 +65,12 @@ interface from being ambiguous. #define CVAR_USERINFO 16 // CVAR_PRIVATE means do not $ expand or sendcvar this cvar under any circumstances (rcon_password uses this) #define CVAR_PRIVATE 32 +// this means that this cvar should update a userinfo key but the name does not correspond directly to the userinfo key to update, and may require additional conversion ("_cl_color" for example should update "topcolor" and "bottomcolor") +#define CVAR_NQUSERINFOHACK 64 // used to determine if flags is valid -#define CVAR_MAXFLAGSVAL 63 +#define CVAR_NORESETTODEFAULTS 128 +// for engine-owned cvars that must not be reset on gametype switch (e.g. scr_screenshot_name, which otherwise isn't set to the mod name properly) +#define CVAR_MAXFLAGSVAL 255 // for internal use only! #define CVAR_DEFAULTSET (1<<30) #define CVAR_ALLOCATED (1<<31) @@ -134,15 +138,15 @@ void Cvar_MenuString(cvar_t *variable, int menu); void Cvar_MenuOption(cvar_t *variable, int menu, int value[16], const char *name[16]); */ +/// registers a cvar that already has the name, string, and optionally the +/// archive elements set. void Cvar_RegisterVariable (cvar_t *variable); -// registers a cvar that already has the name, string, and optionally the -// archive elements set. +/// equivelant to " " typed at the console void Cvar_Set (const char *var_name, const char *value); -// equivelant to " " typed at the console +/// expands value to a string and calls Cvar_Set void Cvar_SetValue (const char *var_name, float value); -// expands value to a string and calls Cvar_Set void Cvar_SetQuick (cvar_t *var, const char *value); void Cvar_SetValueQuick (cvar_t *var, float value); @@ -156,6 +160,9 @@ const char *Cvar_VariableString (const char *var_name); const char *Cvar_VariableDefString (const char *var_name); // returns an empty string if not defined +const char *Cvar_VariableDescription (const char *var_name); +// returns an empty string if not defined + const char *Cvar_CompleteVariable (const char *partial); // attempts to match a partial variable name for command line completion // returns NULL if nothing fits @@ -186,20 +193,27 @@ const char **Cvar_CompleteBuildList (const char *partial); // Thanks to Fett erich@heintz.com // Thanks to taniwha +/// Prints a list of Cvars including a count of them to the user console +/// Referenced in cmd.c in Cmd_Init hence it's inclusion here. +/// Added by EvilTypeGuy eviltypeguy@qeradiant.com +/// Thanks to Matthias "Maddes" Buecher, http://www.inside3d.com/qip/ void Cvar_List_f (void); -// Prints a list of Cvars including a count of them to the user console -// Referenced in cmd.c in Cmd_Init hence it's inclusion here -// Added by EvilTypeGuy eviltypeguy@qeradiant.com -// Thanks to Matthias "Maddes" Buecher, http://www.inside3d.com/qip/ void Cvar_Set_f (void); void Cvar_SetA_f (void); // commands to create new cvars (or set existing ones) // seta creates an archived cvar (saved to config) -cvar_t *Cvar_Get (const char *name, const char *value, int flags); -// allocates a cvar by name and returns its address, -// or merely sets its value if it already exists. +/// allocates a cvar by name and returns its address, +/// or merely sets its value if it already exists. +cvar_t *Cvar_Get (const char *name, const char *value, int flags, const char *newdescription); + +extern char *cvar_dummy_description; // ALWAYS the same pointer +extern cvar_t *cvar_vars; // used to list all cvars + +#ifdef FILLALLCVARSWITHRUBBISH +void Cvar_FillAll_f(); +#endif /* FILLALLCVARSWITHRUBBISH */ #endif