X-Git-Url: http://git.xonotic.org/?p=xonotic%2Fdarkplaces.git;a=blobdiff_plain;f=cvar.h;h=660320390f99358d826e0f8f1fa0b12f790840c4;hp=89ad8fc90f02f58fb6802a98b90acc75f1dd0ade;hb=ca767b6a14085cfd278eaf6999c0177f75bf19fa;hpb=08e7de68e5f8474965781304c0b9e49debcbd967 diff --git a/cvar.h b/cvar.h index 89ad8fc9..66032039 100644 --- a/cvar.h +++ b/cvar.h @@ -1,5 +1,6 @@ /* Copyright (C) 1996-1997 Id Software, Inc. +Copyright (C) 2006-2021 DarkPlaces contributors This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License @@ -8,7 +9,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. @@ -56,108 +57,151 @@ interface from being ambiguous. #ifndef CVAR_H #define CVAR_H -// cvar flags -#define CVAR_SAVE 1 -#define CVAR_NOTIFY 2 +#include "qtypes.h" +#include "qdefs.h" +struct cmd_state_s; +struct qfile_s; -// type of a cvar for menu purposes -#define CVARMENUTYPE_FLOAT 1 -#define CVARMENUTYPE_INTEGER 2 -#define CVARMENUTYPE_SLIDER 3 -#define CVARMENUTYPE_BOOL 4 -#define CVARMENUTYPE_STRING 5 -#define CVARMENUTYPE_OPTION 6 +typedef struct cvar_s +{ + int flags; + + const char *name; + + const char *string; + const char *description; + int integer; + float value; + float vector[3]; + + const char *defstring; + + void (*callback)(struct cvar_s *var); + + char **aliases; + int aliases_size; + + struct cvar_s *initstate; // snapshot of cvar during init -// which menu to put a cvar in -#define CVARMENU_GRAPHICS 1 -#define CVARMENU_SOUND 2 -#define CVARMENU_INPUT 3 -#define CVARMENU_NETWORK 4 -#define CVARMENU_SERVER 5 + int globaldefindex[3]; + int globaldefindex_stringno[3]; -#define MAX_CVAROPTIONS 16 + struct cvar_s *next; +} cvar_t; -typedef struct +typedef struct cvar_hash_s { - int value; - char *name; -} -cvaroption_t; + cvar_t *cvar; + struct cvar_hash_s *next; +} cvar_hash_t; -typedef struct +typedef struct cvar_state_s { - int type; - float valuemin, valuemax, valuestep; - int numoptions; - cvaroption_t optionlist[MAX_CVAROPTIONS]; + cvar_t *vars; + cvar_hash_t *hashtable[CVAR_HASHSIZE]; } -menucvar_t; +cvar_state_t; -typedef struct cvar_s -{ - int flags; - char *name; - char *string; - int integer; - float value; - float vector[3]; - menucvar_t menuinfo; - struct cvar_s *next; -} cvar_t; +extern cvar_state_t cvars_all; +extern cvar_state_t cvars_null; // used by cmd_serverfromclient which intentionally has no cvars available + +void Cvar_RegisterAlias(cvar_t *variable, const char *alias ); + +void Cvar_RegisterCallback(cvar_t *variable, void (*callback)(cvar_t *)); + +/// registers a cvar that already has the name, string, and optionally the +/// archive elements set. +void Cvar_RegisterVariable(cvar_t *variable); -void Cvar_MenuSlider(cvar_t *variable, int menu, float slider_min, float slider_max, float slider_step); -void Cvar_MenuBool(cvar_t *variable, int menu, char *name_false, char *name_true); -void Cvar_MenuFloat(cvar_t *variable, int menu, float range_min, float range_max); -void Cvar_MenuInteger(cvar_t *variable, int menu, int range_min, int range_max); -void Cvar_MenuString(cvar_t *variable, int menu); -void Cvar_MenuOption(cvar_t *variable, int menu, int value[16], char *name[16]); +qbool Cvar_Readonly (cvar_t *var, const char *cmd_name); -void Cvar_RegisterVariable (cvar_t *variable); -// registers a cvar that already has the name, string, and optionally the -// archive elements set. +void Cvar_Callback(cvar_t *var); -void Cvar_Set (char *var_name, char *value); -// equivelant to " " typed at the console +/// equivelant to " " typed at the console +void Cvar_Set (cvar_state_t *cvars, const char *var_name, const char *value); -void Cvar_SetValue (char *var_name, float value); -// expands value to a string and calls Cvar_Set +/// expands value to a string and calls Cvar_Set +void Cvar_SetValue (cvar_state_t *cvars, const char *var_name, float value); -void Cvar_SetQuick (cvar_t *var, char *value); -void Cvar_SetValueQuick (cvar_t *var, float value); +void Cvar_SetQuick (cvar_t *var, const char *value); +void Cvar_SetValueQuick (cvar_t *var, float value); -float Cvar_VariableValue (char *var_name); +float Cvar_VariableValueOr (cvar_state_t *cvars, const char *var_name, float def, int neededflags); +// returns def if not defined + +float Cvar_VariableValue (cvar_state_t *cvars, const char *var_name, int neededflags); // returns 0 if not defined or non numeric -char *Cvar_VariableString (char *var_name); +const char *Cvar_VariableStringOr (cvar_state_t *cvars, const char *var_name, const char *def, int neededflags); +// returns def if not defined + +const char *Cvar_VariableString (cvar_state_t *cvars, const char *var_name, int neededflags); +// returns an empty string if not defined + +const char *Cvar_VariableDefString (cvar_state_t *cvars, const char *var_name, int neededflags); // returns an empty string if not defined -char *Cvar_CompleteVariable (char *partial); +const char *Cvar_VariableDescription (cvar_state_t *cvars, const char *var_name, int neededflags); +// returns an empty string if not defined + +const char *Cvar_CompleteVariable (cvar_state_t *cvars, const char *partial, int neededflags); // attempts to match a partial variable name for command line completion // returns NULL if nothing fits -qboolean Cvar_Command (void); -// called by Cmd_ExecuteString when Cmd_Argv(0) doesn't match a known +void Cvar_PrintHelp(cvar_t *cvar, const char *name, qbool full); + +void Cvar_CompleteCvarPrint (cvar_state_t *cvars, const char *partial, int neededflags); + +qbool Cvar_Command (struct cmd_state_s *cmd); +// called by Cmd_ExecuteString when Cmd_Argv(cmd, 0) doesn't match a known // command. Returns true if the command was a variable reference that // was handled. (print or change) -void Cvar_WriteVariables (QFile *f); +void Cvar_SaveInitState(cvar_state_t *cvars); +void Cvar_RestoreInitState(cvar_state_t *cvars); + +void Cvar_UnlockDefaults(struct cmd_state_s *cmd); +void Cvar_LockDefaults_f(struct cmd_state_s *cmd); +void Cvar_ResetToDefaults_All_f(struct cmd_state_s *cmd); +void Cvar_ResetToDefaults_NoSaveOnly_f(struct cmd_state_s *cmd); +void Cvar_ResetToDefaults_SaveOnly_f(struct cmd_state_s *cmd); + +void Cvar_WriteVariables (cvar_state_t *cvars, struct qfile_s *f); // Writes lines containing "set variable value" for all variables // with the archive flag set to true. -cvar_t *Cvar_FindVar (char *var_name); -cvar_t *Cvar_FindVarAfter (char *prev_var_name, int neededflags); +cvar_t *Cvar_FindVar(cvar_state_t *cvars, const char *var_name, int neededflags); +cvar_t *Cvar_FindVarAfter(cvar_state_t *cvars, const char *prev_var_name, int neededflags); -int Cvar_CompleteCountPossible (char *partial); -char **Cvar_CompleteBuildList (char *partial); +int Cvar_CompleteCountPossible(cvar_state_t *cvars, const char *partial, int neededflags); +const char **Cvar_CompleteBuildList(cvar_state_t *cvars, const char *partial, int neededflags); // Added by EvilTypeGuy - functions for tab completion system // Thanks to Fett erich@heintz.com // Thanks to taniwha -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/ +/// 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(struct cmd_state_s *cmd); + +void Cvar_Set_f(struct cmd_state_s *cmd); +void Cvar_SetA_f(struct cmd_state_s *cmd); +void Cvar_Del_f(struct cmd_state_s *cmd); +// 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(cvar_state_t *cvars, const char *name, const char *value, int flags, const char *newdescription); + +extern const char *cvar_dummy_description; // ALWAYS the same pointer + +void Cvar_UpdateAllAutoCvars(cvar_state_t *cvars); // updates ALL autocvars of the active prog to the cvar values (savegame loading) + +#ifdef FILLALLCVARSWITHRUBBISH +void Cvar_FillAll_f(cmd_state_t *cmd); +#endif /* FILLALLCVARSWITHRUBBISH */ #endif