X-Git-Url: http://de.git.xonotic.org/?a=blobdiff_plain;f=cvar.h;h=9014c50fb5ad4c52ca237ab023e6f2eacb427e26;hb=145be4b7f63608b1b43cdae981761cc74c34efa0;hp=0ed510ab72012528b8f45ebad19b45a97cd2cfe0;hpb=4afd7acaef531b4f9e4494eab8797bae141e3ce1;p=xonotic%2Fdarkplaces.git diff --git a/cvar.h b/cvar.h index 0ed510ab..9014c50f 100644 --- a/cvar.h +++ b/cvar.h @@ -8,7 +8,7 @@ of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of -MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. @@ -60,8 +60,18 @@ interface from being ambiguous. #define CVAR_SAVE 1 #define CVAR_NOTIFY 2 -#define CVAR_READONLY 4 -#define CVAR_MAXFLAGSVAL 7 // used to determine if flags is valid +#define CVAR_READONLY 4 +#define CVAR_SERVERINFO 8 +#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 127 +// for internal use only! +#define CVAR_DEFAULTSET (1<<30) +#define CVAR_ALLOCATED (1<<31) /* // type of a cvar for menu purposes @@ -81,14 +91,14 @@ interface from being ambiguous. #define MAX_CVAROPTIONS 16 -typedef struct +typedef struct cvaroption_s { int value; const char *name; } cvaroption_t; -typedef struct +typedef struct menucvar_s { int type; float valuemin, valuemax, valuestep; @@ -101,13 +111,20 @@ menucvar_t; typedef struct cvar_s { int flags; + char *name; + char *string; + char *description; int integer; float value; float vector[3]; + + char *defstring; + //menucvar_t menuinfo; struct cvar_s *next; + struct cvar_s *nextonhashchain; } cvar_t; /* @@ -119,15 +136,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); @@ -138,15 +155,29 @@ float Cvar_VariableValue (const char *var_name); const char *Cvar_VariableString (const char *var_name); // returns an empty string if not defined +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 +void Cvar_CompleteCvarPrint (const char *partial); + qboolean 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_UnlockDefaults (void); +void Cvar_LockDefaults_f (void); +void Cvar_ResetToDefaults_All_f (void); +void Cvar_ResetToDefaults_NoSaveOnly_f (void); +void Cvar_ResetToDefaults_SaveOnly_f (void); + void Cvar_WriteVariables (qfile_t *f); // Writes lines containing "set variable value" for all variables // with the archive flag set to true. @@ -160,11 +191,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) + +/// 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