mirror of
https://github.com/JGRennison/OpenTTD-patches.git
synced 2024-11-06 03:20:28 +00:00
4412871e5c
- Because patches are (will be in a few commits) saved, you cannot specify the order of the GUI-items in the SettingDesc tables themselves. Doing so would mean messing around with the savegame-version, or doing expensive lookups. So the GUI-tables are now just simple indeces into the original table. No more is needed since that table contains all information - The only change in functionality is that the stepsize has been automated. It is calculated from the minimum and maximum values such that within 50 clicks you will have gone from one end to the other if scrolling. - The GUI has kept its flags intact. These are: SGF_0ISDISABLED: the variable might have a domain higher than zero, but a special value of nul is used as telling that feature is disabled. SGF_NOCOMMA: represent the number without any thousand-seperators SGF_MULTISTRING: internally the variable is a number, but its representation is a string based on a simple offset. SGF_NETWORK_ONLY: this setting can only be changed during network games SGF_CURRENCY: the variable represents money and will be shown in the local currency - - NOTE! The game is not compilable after this commit (because console hooks have not been updated)
83 lines
3.7 KiB
C
83 lines
3.7 KiB
C
/* $Id$ */
|
|
|
|
#ifndef SETTINGS_H
|
|
#define SETTINGS_H
|
|
|
|
#include "saveload.h"
|
|
|
|
/** Convention/Type of settings. This is then further specified if necessary
|
|
* with the SLE_ (SLE_VAR/SLE_FILE) enums in saveload.h
|
|
* @see VarTypes
|
|
* @see SettingDescBase */
|
|
enum SettingDescType {
|
|
/* 4 bytes allocated a maximum of 16 types for GenericType */
|
|
SDT_NUMX = 0, // any number-type
|
|
SDT_BOOLX = 1, // a boolean number
|
|
SDT_ONEOFMANY = 2, // bitmasked number where only ONE bit may be set
|
|
SDT_MANYOFMANY = 3, // bitmasked number where MULTIPLE bits may be set
|
|
SDT_INTLIST = 4, // list of integers seperated by a comma ','
|
|
SDT_STRING = 5, // string with a pre-allocated buffer
|
|
/* 10 more possible primitives */
|
|
};
|
|
|
|
enum SettingGuiFlag {
|
|
/* 8 bytes allocated for a maximum of 8 flags
|
|
* Flags directing saving/loading of a variable */
|
|
SGF_0ISDISABLED = 1 << 0, ///< a value of zero means the feature is disabled
|
|
SGF_NOCOMMA = 1 << 1, ///< number without any thousand seperators (no formatting)
|
|
SGF_MULTISTRING = 1 << 2, ///< the value represents a limited number of string-options (internally integer)
|
|
SGF_NETWORK_ONLY = 1 << 3, ///< this setting only applies to network games
|
|
SGF_CURRENCY = 1 << 4, ///< the number represents money, so when reading value multiply by exchange rate
|
|
/* 3 more possible flags */
|
|
};
|
|
|
|
typedef int32 OnChange(int32 var);
|
|
typedef byte SettingDescType;
|
|
typedef byte SettingGuiFlag;
|
|
|
|
typedef struct SettingDescBase {
|
|
const char *name; ///< name of the setting. Used in configuration file and for console
|
|
const void *def; ///< default value given when none is present
|
|
SettingDescType cmd; ///< various flags for the variable
|
|
SettingGuiFlag flags; ///< handles how a setting would show up in the GUI (text/currency, etc.)
|
|
int32 min, max; ///< minimum and maximum values
|
|
const char *many; ///< ONE/MANY_OF_MANY: string of possible values for this type
|
|
StringID str; ///< (translated) string with descriptive text; gui and console
|
|
OnChange *proc; ///< callback procedure for when the value is changed
|
|
} SettingDescBase;
|
|
|
|
typedef struct SettingDesc {
|
|
SettingDescBase desc; ///< Settings structure (going to configuration file)
|
|
SaveLoad save; ///< Internal structure (going to savegame, parts to config)
|
|
} SettingDesc;
|
|
|
|
/* NOTE: The only difference between SettingDesc and SettingDescGlob is
|
|
* that one uses global variables as a source and the other offsets
|
|
* in a struct which are bound to a certain variable during runtime.
|
|
* The only way to differentiate between these two is to check if an object
|
|
* has been passed to the function or not. If not, then it is a global variable
|
|
* and save->variable has its address, otherwise save->variable only holds the
|
|
* offset in a certain struct */
|
|
typedef SettingDesc SettingDescGlobVarList;
|
|
|
|
typedef enum {
|
|
IGT_VARIABLES = 0, ///< values of the form "landscape = hilly"
|
|
IGT_LIST = 1, ///< a list of values, seperated by \n and terminated by the next group block
|
|
} IniGroupType;
|
|
|
|
/** Get the address of the variable. Which one to pick depends on the object
|
|
* pointer. If it is NULL we are dealing with global variables so the address
|
|
* is taken. If non-null only the offset is stored in the union and we need
|
|
* to add this to the address of the object */
|
|
static inline void *ini_get_variable(const SaveLoad *sld, const void *object)
|
|
{
|
|
return (object == NULL) ? sld->address : (byte*)object + (unsigned long)sld->address;
|
|
}
|
|
|
|
void IConsoleSetPatchSetting(const char *name, const char *value);
|
|
void IConsoleGetPatchSetting(const char *name);
|
|
const SettingDesc *GetSettingDescription(uint index);
|
|
void SetPatchValue(uint index, const Patches *object, int32 value);
|
|
|
|
#endif /* SETTINGS_H */
|