ref: fe2a32889ef6968fb533876bf2492927a9406344
dir: /cvar.h/
/* 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. it is sufficient to initialize a cvar_t with just the first two fields, or you can add a ,true flag for variables that you want saved to the configuration file when the game is quit: cvar_t r_draworder = {"r_draworder","1"}; cvar_t scr_screensize = {"screensize","1",true}; Cvars must be registered before use, or they will have a 0 value instead of the float interpretation of the string. Generally, all cvar_t declarations should be registered in the apropriate init function before any console commands are executed: Cvar_RegisterVariable (&host_framerate); C code usually just references a cvar in place: if ( r_draworder.value ) It could optionally ask for the value to be looked up for a string name: if (Cvar_VariableValue ("r_draworder")) Interpreted prog code can access cvars with the cvar(name) or cvar_set (name, value) internal functions: teamplay = cvar("teamplay"); cvar_set ("registered", "1"); The user can access cvars from the console in two ways: r_draworder prints the current value r_draworder 0 sets the current value to 0 Cvars are restricted from having the same names as commands to keep this interface from being ambiguous. */ typedef struct cvar_s cvar_t; struct cvar_s { char *name; char *string; bool archive; // set to true to cause it to be saved to vars.rc float value; void (*cb) (cvar_t *); bool server; // notifies players when changed }; void Cvar_RegisterVariable (cvar_t *variable); // registers a cvar that already has the name, string, and optionally the // archive elements set. float Cvar_VariableValue (char *var_name); // returns 0 if not defined or non numeric char *Cvar_VariableString (char *var_name); // returns an empty string if not defined char *Cvar_CompleteVariable (char *partial); // attempts to match a partial variable name for command line completion // returns NULL if nothing fits 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) cvar_t *Cvar_FindVar (char *var_name); extern cvar_t *cvar_vars;