settings.cpp File Reference

All actions handling saving and loading of the settings/configuration goes on in this file. More...

#include "stdafx.h"
#include <charconv>
#include "settings_table.h"
#include "debug.h"
#include "currency.h"
#include "network/network.h"
#include "network/network_func.h"
#include "network/core/config.h"
#include "command_func.h"
#include "console_func.h"
#include "genworld.h"
#include "string_func.h"
#include "window_func.h"
#include "company_func.h"
#include "rev.h"
#include "error.h"
#include "gamelog.h"
#include "settings_func.h"
#include "ini_type.h"
#include "ai/ai_config.hpp"
#include "game/game_config.hpp"
#include "newgrf_config.h"
#include "picker_func.h"
#include "base_media_base.h"
#include "fios.h"
#include "fileio_func.h"
#include "settings_cmd.h"
#include "table/strings.h"
#include "safeguards.h"

Go to the source code of this file.

Data Structures
class	ConfigIniFile
	IniFile to store a configuration. More...

Typedefs
typedef void	SettingDescProc(IniFile &ini, const SettingTable &desc, const char *grpname, void *object, bool only_startup)
typedef void	SettingDescProcList(IniFile &ini, const char *grpname, StringList &list)

Enumerations
enum	IniFileVersion : uint32_t {   IFV_0 , IFV_PRIVATE_SECRETS , IFV_GAME_TYPE , IFV_LINKGRAPH_SECONDS ,   IFV_NETWORK_PRIVATE_SETTINGS , IFV_AUTOSAVE_RENAME , IFV_RIGHT_CLICK_CLOSE , IFV_REMOVE_GENERATION_SEED ,   IFV_MAX_VERSION }
	Ini-file versions. More...

Functions
static auto &	GenericSettingTables ()
	List of all the generic setting tables.
static auto &	PrivateSettingTables ()
	List of all the private setting tables.
static auto &	SecretSettingTables ()
	List of all the secrets setting tables.
static bool	IsSignedVarMemType (VarType vt)
static size_t	LookupManyOfMany (const std::vector< std::string > &many, const char *str)
	Find the set-integer value MANYofMANY type in a string.
static std::optional< std::vector< uint32_t > >	ParseIntList (const char *p)
	Parse a string into a vector of uint32s.
static bool	LoadIntList (const char *str, void *array, int nelems, VarType type)
	Load parsed string-values into an integer-array (intlist)
static void	IniLoadSettings (IniFile &ini, const SettingTable &settings_table, const char *grpname, void *object, bool only_startup)
	Load values from a group of an IniFile structure into the internal representation.
static void	IniSaveSettings (IniFile &ini, const SettingTable &settings_table, const char *grpname, void *object, bool)
	Save the values of settings to the inifile.
static void	IniLoadSettingList (IniFile &ini, const char *grpname, StringList &list)
	Loads all items from a 'grpname' section into a list The list parameter can be a nullptr pointer, in this case nothing will be saved and a callback function should be defined that will take over the list-handling and store the data itself somewhere.
static void	IniSaveSettingList (IniFile &ini, const char *grpname, StringList &list)
	Saves all items from a list into the 'grpname' section The list parameter can be a nullptr pointer, in this case a callback function should be defined that will provide the source data to be saved.
void	IniLoadWindowSettings (IniFile &ini, const char *grpname, void *desc)
	Load a WindowDesc from config.
void	IniSaveWindowSettings (IniFile &ini, const char *grpname, void *desc)
	Save a WindowDesc to config.
void	PrepareOldDiffCustom ()
	Prepare for reading and old diff_custom by zero-ing the memory.
void	HandleOldDiffCustom (bool savegame)
	Reading of the old diff_custom array and transforming it to the new format.
static void	ValidateSettings ()
	Checks if any settings are set to incorrect values, and sets them to correct values in that case.
static void	AILoadConfig (const IniFile &ini, const char *grpname)
static void	GameLoadConfig (const IniFile &ini, const char *grpname)
static void	GraphicsSetLoadConfig (IniFile &ini)
	Load BaseGraphics set selection and configuration.
static GRFConfig *	GRFLoadConfig (const IniFile &ini, const char *grpname, bool is_static)
	Load a GRF configuration.
static IniFileVersion	LoadVersionFromConfig (const IniFile &ini)
static void	AISaveConfig (IniFile &ini, const char *grpname)
static void	GameSaveConfig (IniFile &ini, const char *grpname)
static void	SaveVersionInConfig (IniFile &ini)
	Save the version of OpenTTD to the ini file.
static void	GraphicsSetSaveConfig (IniFile &ini)
	Save BaseGraphics set selection and configuration.
static void	GRFSaveConfig (IniFile &ini, const char *grpname, const GRFConfig *list)
static void	HandleSettingDescs (IniFile &generic_ini, IniFile &private_ini, IniFile &secrets_ini, SettingDescProc *proc, SettingDescProcList *proc_list, bool only_startup=false)
static void	RemoveEntriesFromIni (IniFile &ini, const SettingTable &table)
	Remove all entries from a settings table from an ini-file.
bool	IsConversionNeeded (const ConfigIniFile &ini, const std::string &group, const std::string &old_var, const std::string &new_var, const IniItem **old_item)
	Check whether a conversion should be done, and based on what old setting information.
void	LoadFromConfig (bool startup)
	Load the values from the configuration files.
void	SaveToConfig ()
	Save the values to the configuration file.
StringList	GetGRFPresetList ()
	Get the list of known NewGrf presets.
GRFConfig *	LoadGRFPresetFromConfig (const char *config_name)
	Load a NewGRF configuration by preset-name.
void	SaveGRFPresetToConfig (const char *config_name, GRFConfig *config)
	Save a NewGRF configuration with a preset name.
void	DeleteGRFPresetFromConfig (const char *config_name)
	Delete a NewGRF configuration by preset name.
static const SettingDesc *	GetSettingFromName (const std::string_view name, const SettingTable &settings)
	Given a name of setting, return a setting description from the table.
void	GetSaveLoadFromSettingTable (SettingTable settings, std::vector< SaveLoad > &saveloads)
	Get the SaveLoad for all settings in the settings table.
static const SettingDesc *	GetCompanySettingFromName (std::string_view name)
	Given a name of setting, return a company setting description of it.
const SettingDesc *	GetSettingFromName (const std::string_view name)
	Given a name of any setting, return any setting description of it.
CommandCost	CmdChangeSetting (DoCommandFlag flags, const std::string &name, int32_t value)
	Network-safe changing of settings (server-only).
CommandCost	CmdChangeCompanySetting (DoCommandFlag flags, const std::string &name, int32_t value)
	Change one of the per-company settings.
bool	SetSettingValue (const IntSettingDesc *sd, int32_t value, bool force_newgame)
	Top function to save the new value of an element of the Settings struct.
void	SetDefaultCompanySettings (CompanyID cid)
	Set the company settings for a new company to their default values.
void	SyncCompanySettings ()
	Sync all company settings in a multiplayer game.
bool	SetSettingValue (const StringSettingDesc *sd, std::string value, bool force_newgame)
	Set a setting value with a string.
void	IConsoleSetSetting (const char *name, const char *value, bool force_newgame)
void	IConsoleSetSetting (const char *name, int value)
void	IConsoleGetSetting (const char *name, bool force_newgame)
	Output value of a specific setting to the console.
static void	IConsoleListSettingsTable (const SettingTable &table, const char *prefilter)
void	IConsoleListSettings (const char *prefilter)
	List all settings and their value to the console.

Variables
ClientSettings	_settings_client
	The current settings for this game.
GameSettings	_settings_game
	Game settings of a running game or the scenario editor.
GameSettings	_settings_newgame
	Game settings for new games (updated from the intro screen).
VehicleDefaultSettings	_old_vds
	Used for loading default vehicles settings from old savegames.
std::string	_config_file
	Configuration file of OpenTTD.
std::string	_private_file
	Private configuration file of OpenTTD.
std::string	_secrets_file
	Secrets configuration file of OpenTTD.
std::string	_favs_file
	Picker favourites configuration file of OpenTTD.
static ErrorList	_settings_error_list
	Errors while loading minimal settings.
const uint16_t	INIFILE_VERSION = (IniFileVersion)(IFV_MAX_VERSION - 1)
	Current ini-file version of OpenTTD.

Detailed Description

All actions handling saving and loading of the settings/configuration goes on in this file.

The file consists of three parts:

1. Parsing the configuration file (openttd.cfg). This is achieved with the ini_ functions which handle various types, such as normal 'key = value' pairs, lists and value combinations of lists, strings, integers, 'bit'-masks and element selections.
2. Handle reading and writing to the setting-structures from inside the game either from the console for example or through the gui with CMD_ functions.
3. Handle saving/loading of the PATS chunk inside the savegame.

See also

SettingDesc

SaveLoad

Definition in file settings.cpp.

Typedef Documentation

SettingDescProc

typedef void SettingDescProc(IniFile &ini, const SettingTable &desc, const char *grpname, void *object, bool only_startup)

Definition at line 118 of file settings.cpp.

SettingDescProcList

typedef void SettingDescProcList(IniFile &ini, const char *grpname, StringList &list)

Definition at line 119 of file settings.cpp.

Enumeration Type Documentation

IniFileVersion

enum IniFileVersion : uint32_t

Ini-file versions.

Sometimes we move settings between different ini-files, as we need to know when we have to load/remove it from the old versus reading it from the new location. These versions assist with situations like that.

Enumerator
IFV_0	0 All versions prior to introduction.
IFV_PRIVATE_SECRETS	1 PR#9298 Moving of settings from openttd.cfg to private.cfg / secrets.cfg.
IFV_GAME_TYPE	2 PR#9515 Convert server_advertise to server_game_type.
IFV_LINKGRAPH_SECONDS	3 PR#10610 Store linkgraph update intervals in seconds instead of days.
IFV_NETWORK_PRIVATE_SETTINGS	4 PR#10762 Move use_relay_service to private settings.
IFV_AUTOSAVE_RENAME	5 PR#11143 Renamed values of autosave to be in minutes.
IFV_RIGHT_CLICK_CLOSE	6 PR#10204 Add alternative right click to close windows setting.
IFV_REMOVE_GENERATION_SEED	7 PR#11927 Remove "generation_seed" from configuration.
IFV_MAX_VERSION	Highest possible ini-file version.

Definition at line 162 of file settings.cpp.

Function Documentation

AILoadConfig()

static void AILoadConfig ( const IniFile &  ini, const char *  grpname  )

static

Definition at line 940 of file settings.cpp.

AISaveConfig()

static void AISaveConfig ( IniFile &  ini, const char *  grpname  )

static

Definition at line 1158 of file settings.cpp.

CmdChangeCompanySetting()

CommandCost CmdChangeCompanySetting	(	DoCommandFlag	flags,
		const std::string &	name,
		int32_t	value
	)

Change one of the per-company settings.

Parameters

flags	operation to perform
name	the name of the company setting to change
value	the new value for the setting The new value is properly clamped to its minimum/maximum when setting

Returns

the cost of this operation or an error

Definition at line 1722 of file settings.cpp.

References _current_company, SettingDesc::AsIntSetting(), IntSettingDesc::ChangeValue(), CMD_ERROR, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Get(), GetCompanySettingFromName(), SettingDesc::IsIntSetting(), and settings.

CmdChangeSetting()

CommandCost CmdChangeSetting	(	DoCommandFlag	flags,
		const std::string &	name,
		int32_t	value
	)

Network-safe changing of settings (server-only).

Parameters

flags	operation to perform
name	the name of the setting to change
value	the new value for the setting The new value is properly clamped to its minimum/maximum when setting

Returns

the cost of this operation or an error

See also

_settings

Definition at line 1696 of file settings.cpp.

References SettingDesc::AsIntSetting(), IntSettingDesc::ChangeValue(), CMD_ERROR, DC_EXEC, GetGameSettings(), GetSettingFromName(), SettingDesc::IsEditable(), SettingDesc::IsIntSetting(), SettingDesc::save, SlIsObjectCurrentlyValid(), SaveLoad::version_from, and SaveLoad::version_to.

DeleteGRFPresetFromConfig()

void DeleteGRFPresetFromConfig

(

const char *

config_name

)

Delete a NewGRF configuration by preset name.

Parameters

config_name

Name of the preset.

Definition at line 1572 of file settings.cpp.

References _config_file, IniLoadFile::RemoveGroup(), and IniFile::SaveToDisk().

Referenced by NewGRFWindow::OnClick().

GameLoadConfig()

static void GameLoadConfig ( const IniFile &  ini, const char *  grpname  )

static

Definition at line 969 of file settings.cpp.

GameSaveConfig()

static void GameSaveConfig ( IniFile &  ini, const char *  grpname  )

static

Definition at line 1178 of file settings.cpp.

GenericSettingTables()

static auto & GenericSettingTables ( )

static

List of all the generic setting tables.

There are a few tables that are special and not processed like the rest:

• _currency_settings
• _misc_settings
• _company_settings
• _win32_settings As such, they are not part of this list.

Definition at line 77 of file settings.cpp.

Referenced by GetSettingFromName(), and IConsoleListSettings().

GetCompanySettingFromName()

static const SettingDesc * GetCompanySettingFromName ( std::string_view  name )

static

Given a name of setting, return a company setting description of it.

Parameters

name	Name of the company setting to return a setting description of.

Returns

Pointer to the setting description of setting name if it can be found, nullptr indicates failure to obtain the description.

Definition at line 1656 of file settings.cpp.

References GetSettingFromName().

Referenced by CmdChangeCompanySetting(), and GetSettingFromName().

GetGRFPresetList()

StringList GetGRFPresetList

(

)

Get the list of known NewGrf presets.

Returns

List of preset names.

Definition at line 1521 of file settings.cpp.

References _config_file, IniLoadFile::groups, and IniGroup::name.

Referenced by NewGRFWindow::OnClick(), NewGRFWindow::OnQueryTextFinished(), and SavePresetWindow::SavePresetWindow().

GetSaveLoadFromSettingTable()

void GetSaveLoadFromSettingTable	(	SettingTable	settings,
		std::vector< SaveLoad > &	saveloads
	)

Get the SaveLoad for all settings in the settings table.

Parameters

settings	The settings table to get the SaveLoad objects from.
saveloads	A vector to store the result in.

Definition at line 1641 of file settings.cpp.

References GetSettingDesc(), SettingDesc::save, settings, SlIsObjectCurrentlyValid(), SaveLoad::version_from, and SaveLoad::version_to.

GetSettingFromName() [1/2]

const SettingDesc * GetSettingFromName

(

const std::string_view

name

)

Given a name of any setting, return any setting description of it.

Parameters

name	Name of the setting to return a setting description of.

Returns

Pointer to the setting description of setting name if it can be found, nullptr indicates failure to obtain the description.

Definition at line 1669 of file settings.cpp.

References GenericSettingTables(), GetCompanySettingFromName(), GetSettingFromName(), PrivateSettingTables(), and SecretSettingTables().

GetSettingFromName() [2/2]

static const SettingDesc * GetSettingFromName ( const std::string_view  name, const SettingTable &  settings  )

static

Given a name of setting, return a setting description from the table.

Parameters

name	Name of the setting to return a setting description of.
settings	Table to look in for the setting.

Returns

Pointer to the setting description of setting name if it can be found, nullptr indicates failure to obtain the description.

Definition at line 1616 of file settings.cpp.

References SettingDesc::GetName(), GetSettingDesc(), SettingDesc::save, settings, SlIsObjectCurrentlyValid(), SaveLoad::version_from, and SaveLoad::version_to.

Referenced by CmdChangeSetting(), GetCompanySettingFromName(), NewsTypeData::GetDisplay(), GetSettingFromName(), HandleOldDiffCustom(), IConsoleGetSetting(), SettingEntry::Init(), and NetworkClientListWindow::OnQueryTextFinished().

GraphicsSetLoadConfig()

static void GraphicsSetLoadConfig ( IniFile &  ini )

static

Load BaseGraphics set selection and configuration.

Definition at line 996 of file settings.cpp.

References BSWAP32(), BaseGraphics::Ini::extra_params, IniLoadFile::GetGroup(), IniGroup::GetItem(), ParseIntList(), SetDParamStr(), BaseGraphics::Ini::shortname, ShowErrorMessage(), IniItem::value, and WL_CRITICAL.

Referenced by LoadFromConfig().

GraphicsSetSaveConfig()

static void GraphicsSetSaveConfig ( IniFile &  ini )

static

Save BaseGraphics set selection and configuration.

Definition at line 1211 of file settings.cpp.

References BSWAP32(), IniGroup::Clear(), IniLoadFile::GetOrCreateGroup(), IniGroup::GetOrCreateItem(), BaseMedia< GraphicsSet >::GetUsedSet(), GRFBuildParamList(), BaseSet< T, Tnum_files, Tsearch_in_tars >::name, GRFConfig::param, IniItem::SetValue(), BaseSet< T, Tnum_files, Tsearch_in_tars >::shortname, and GRFConfig::version.

Referenced by SaveToConfig().

GRFLoadConfig()

static GRFConfig * GRFLoadConfig ( const IniFile &  ini, const char *  grpname, bool  is_static  )

static

Load a GRF configuration.

Parameters

ini	The configuration to read from.
grpname	Group name containing the configuration of the GRF.
is_static	GRF is static.

Definition at line 1031 of file settings.cpp.

References ConvertHexToBytes(), FGCM_EXACT, FGCM_NEWEST_VALID, GRFConfig::filename, FillGRFDetails(), FindGRFConfig(), FioCheckFileExists(), GRFConfig::flags, GCF_INVALID, GCF_STATIC, GCF_SYSTEM, GCF_UNSAFE, GCS_NOT_FOUND, IniLoadFile::GetGroup(), GRFIdentifier::grfid, HasBit(), GRFConfig::ident, IniGroup::items, IniItem::name, NETWORK_MAX_GRF_COUNT, NEWGRF_DIR, GRFConfig::next, ParseIntList(), SetBit(), SetDParam(), SetDParamStr(), ShowErrorMessage(), GRFConfig::status, IniItem::value, and WL_CRITICAL.

Referenced by LoadFromConfig(), and LoadGRFPresetFromConfig().

GRFSaveConfig()

static void GRFSaveConfig ( IniFile &  ini, const char *  grpname, const GRFConfig *  list  )

static

Definition at line 1230 of file settings.cpp.

HandleOldDiffCustom()

void HandleOldDiffCustom

(

bool

savegame

)

Reading of the old diff_custom array and transforming it to the new format.

Parameters

savegame

is it read from the config or savegame. In the latter case we are sure there is an array; in the former case we have to check that.

Definition at line 36 of file settings_sl.cpp.

References _settings_game, _settings_newgame, SettingDesc::AsIntSetting(), GetSettingFromName(), IsSavegameVersionBefore(), IntSettingDesc::MakeValueValidAndWrite(), and SLV_4.

Referenced by OPTSChunkHandler::Load(), and LoadFromConfig().

HandleSettingDescs()

static void HandleSettingDescs ( IniFile &  generic_ini, IniFile &  private_ini, IniFile &  secrets_ini, SettingDescProc *  proc, SettingDescProcList *  proc_list, bool  only_startup = false  )

static

Definition at line 1244 of file settings.cpp.

IConsoleGetSetting()

void IConsoleGetSetting	(	const char *	name,
		bool	force_newgame
	)

Output value of a specific setting to the console.

Parameters

name	Name of the setting to output its value
force_newgame	force the newgame settings

Definition at line 1894 of file settings.cpp.

References _settings_game, _settings_newgame, SettingDesc::AsIntSetting(), SettingDesc::AsStringSetting(), CC_ERROR, CC_INFO, SettingDesc::flags, SettingDesc::FormatValue(), SettingDesc::GetName(), GetSettingFromName(), IConsolePrint(), SettingDesc::IsIntSetting(), SettingDesc::IsStringSetting(), IntSettingDesc::max, IntSettingDesc::min, StringSettingDesc::Read(), and SF_GUI_0_IS_SPECIAL.

IConsoleListSettings()

void IConsoleListSettings

(

const char *

prefilter

)

List all settings and their value to the console.

Parameters

prefilter

If not nullptr, only list settings with names that begin with prefilter prefix

Definition at line 1929 of file settings.cpp.

References CC_HELP, GenericSettingTables(), IConsolePrint(), PrivateSettingTables(), and SecretSettingTables().

IConsoleListSettingsTable()

static void IConsoleListSettingsTable ( const SettingTable &  table, const char *  prefilter  )

static

Definition at line 1914 of file settings.cpp.

IConsoleSetSetting() [1/2]

void IConsoleSetSetting	(	const char *	name,
		const char *	value,
		bool	force_newgame
	)

Definition at line 1851 of file settings.cpp.

IConsoleSetSetting() [2/2]

void IConsoleSetSetting	(	const char *	name,
		int	value
	)

Definition at line 1882 of file settings.cpp.

IniLoadSettingList()

static void IniLoadSettingList ( IniFile &  ini, const char *  grpname, StringList &  list  )

static

Loads all items from a 'grpname' section into a list The list parameter can be a nullptr pointer, in this case nothing will be saved and a callback function should be defined that will take over the list-handling and store the data itself somewhere.

Parameters

ini	IniFile handle to the ini file with the source data
grpname	character string identifying the section-header of the ini file that will be parsed
list	new list with entries of the given section

Definition at line 824 of file settings.cpp.

References IniLoadFile::GetGroup(), and IniGroup::items.

Referenced by LoadFromConfig().

IniLoadSettings()

static void IniLoadSettings ( IniFile &  ini, const SettingTable &  settings_table, const char *  grpname, void *  object, bool  only_startup  )

static

Load values from a group of an IniFile structure into the internal representation.

Parameters

ini	pointer to IniFile structure that holds administrative information
settings_table	table with SettingDesc structures whose internally pointed variables will be given values
grpname	the group of the IniFile to search in for the new values
object	pointer to the object been loaded
only_startup	load only the startup settings set

Definition at line 614 of file settings.cpp.

References IniLoadFile::GetGroup(), IniGroup::GetItem(), SettingDesc::GetName(), GetSettingDesc(), SettingDesc::ParseValue(), SettingDesc::save, SlIsObjectCurrentlyValid(), SettingDesc::startup, SaveLoad::version_from, and SaveLoad::version_to.

Referenced by IniLoadWindowSettings(), and LoadFromConfig().

IniLoadWindowSettings()

void IniLoadWindowSettings	(	IniFile &	ini,
		const char *	grpname,
		void *	desc
	)

Load a WindowDesc from config.

Parameters

ini	IniFile handle to the ini file with the source data
grpname	character string identifying the section-header of the ini file that will be parsed
desc	Destination WindowDesc

Definition at line 862 of file settings.cpp.

References IniLoadSettings().

Referenced by WindowDesc::LoadFromConfig().

IniSaveSettingList()

static void IniSaveSettingList ( IniFile &  ini, const char *  grpname, StringList &  list  )

static

Saves all items from a list into the 'grpname' section The list parameter can be a nullptr pointer, in this case a callback function should be defined that will provide the source data to be saved.

Parameters

ini	IniFile handle to the ini file where the destination data is saved
grpname	character string identifying the section-header of the ini file
list	pointer to an string(pointer) array that will be used as the source to be saved into the relevant ini section

Definition at line 846 of file settings.cpp.

References IniGroup::Clear(), IniLoadFile::GetOrCreateGroup(), IniGroup::GetOrCreateItem(), and IniItem::SetValue().

Referenced by SaveToConfig().

IniSaveSettings()

static void IniSaveSettings ( IniFile &  ini, const SettingTable &  settings_table, const char *  grpname, void *  object, bool    )

static

Save the values of settings to the inifile.

Parameters

ini	pointer to IniFile structure
sd	read-only SettingDesc structure which contains the unmodified, loaded values of the configuration file and various information about it
grpname	holds the name of the group (eg. [network]) where these will be saved
object	pointer to the object been saved The function works as follows: for each item in the SettingDesc structure we have a look if the value has changed since we started the game (the original values are reloaded when saving). If settings indeed have changed, we get these and save them.

Definition at line 694 of file settings.cpp.

References SettingDesc::flags, SettingDesc::FormatValue(), SettingDesc::GetName(), IniLoadFile::GetOrCreateGroup(), GetSettingDesc(), SettingDesc::IsSameValue(), SettingDesc::save, SF_NOT_IN_CONFIG, SlIsObjectCurrentlyValid(), IniItem::value, SaveLoad::version_from, and SaveLoad::version_to.

Referenced by IniSaveWindowSettings(), and SaveToConfig().

IniSaveWindowSettings()

void IniSaveWindowSettings	(	IniFile &	ini,
		const char *	grpname,
		void *	desc
	)

Save a WindowDesc to config.

Parameters

ini	IniFile handle to the ini file where the destination data is saved
grpname	character string identifying the section-header of the ini file
desc	Source WindowDesc

Definition at line 873 of file settings.cpp.

References IniSaveSettings().

Referenced by WindowDesc::SaveToConfig().

IsConversionNeeded()

bool IsConversionNeeded	(	const ConfigIniFile &	ini,
		const std::string &	group,
		const std::string &	old_var,
		const std::string &	new_var,
		const IniItem **	old_item
	)

Check whether a conversion should be done, and based on what old setting information.

To prevent errors when switching back and forth between older and newer version of OpenTTD, the type of a setting is never changed. Instead, the setting is renamed, and this function is used to check whether a conversion between the old and new setting is required.

This checks if the new setting doesn't exist, and if the old does.

Doing it this way means that if you switch to an older client, the old setting is used, and only on the first time starting a new client, the old setting is converted to the new. After that, they are independent of each other. And you can safely, without errors on either, switch between old and new client.

Parameters

	ini	The ini-file to use.
	group	The group the setting is in.
	old_var	The old name of the setting.
	new_var	The new name of the setting.
[out]	old_item	The old item to base upgrading on.

Returns

Whether upgrading should happen; if false, old_item is a nullptr.

Definition at line 1326 of file settings.cpp.

References IniLoadFile::GetGroup(), and IniGroup::GetItem().

Referenced by LoadFromConfig().

IsSignedVarMemType()

static bool IsSignedVarMemType ( VarType  vt )

static

Definition at line 121 of file settings.cpp.

LoadFromConfig()

void LoadFromConfig

(

bool

startup

)

Load the values from the configuration files.

Parameters

startup

Load the minimal amount of the configuration to "bootstrap" the blitter and such.

Definition at line 1354 of file settings.cpp.

References _config_file, _favs_file, _grfconfig_newgame, _grfconfig_static, _private_file, _secrets_file, _settings_client, _settings_error_list, _settings_newgame, GUISettings::autosave_interval, DebugReconsiderSendRemoteMessages(), FindWindowById(), IniLoadFile::GetGroup(), IniGroup::GetItem(), GraphicsSetLoadConfig(), GRFLoadConfig(), ClientSettings::gui, HandleOldDiffCustom(), IFV_AUTOSAVE_RENAME, IFV_GAME_TYPE, IFV_LINKGRAPH_SECONDS, IFV_NETWORK_PRIVATE_SETTINGS, IFV_PRIVATE_SECRETS, IFV_RIGHT_CLICK_CLOSE, IniLoadSettingList(), IniLoadSettings(), IsConversionNeeded(), GameSettings::linkgraph, ClientSettings::network, BoolSettingDesc::ParseSingleValue(), OneOfManySettingDesc::ParseSingleValue(), PickerLoadConfig(), PrepareOldDiffCustom(), LinkGraphSettings::recalc_interval, LinkGraphSettings::recalc_time, ResetCurrencies(), GUISettings::right_click_wnd_close, ScheduleErrorMessage(), TimerGameConst< struct Calendar >::SECONDS_PER_DAY, NetworkSettings::server_game_type, ShowFirstError(), NetworkSettings::use_relay_service, ValidateSettings(), IniItem::value, and WC_ERRMSG.

Referenced by AfterNewGRFScan::OnNewGRFsScanned(), and openttd_main().

LoadGRFPresetFromConfig()

GRFConfig * LoadGRFPresetFromConfig

(

const char *

config_name

)

Load a NewGRF configuration by preset-name.

Parameters

config_name

Name of the preset.

Returns

NewGRF configuration.

See also

GetGRFPresetList

Definition at line 1541 of file settings.cpp.

References _config_file, and GRFLoadConfig().

Referenced by NewGRFWindow::OnDropdownSelect().

LoadIntList()

static bool LoadIntList ( const char *  str, void *  array, int  nelems, VarType  type  )

static

Load parsed string-values into an integer-array (intlist)

Parameters

str	the string that contains the values (and will be parsed)
array	pointer to the integer-arrays that will be filled
nelems	the number of elements the array holds.
type	the type of elements the array holds (eg INT8, UINT16, etc.)

Returns

return true on success and false on error

Definition at line 294 of file settings.cpp.

References ParseIntList(), SlVarSize(), and WriteValue().

Referenced by ListSettingDesc::ParseValue().

LoadVersionFromConfig()

static IniFileVersion LoadVersionFromConfig ( const IniFile &  ini )

static

Definition at line 1143 of file settings.cpp.

LookupManyOfMany()

static size_t LookupManyOfMany ( const std::vector< std::string > &  many, const char *  str  )

static

Find the set-integer value MANYofMANY type in a string.

Parameters

many	full domain of values the MANYofMANY setting can have
str	the current string value of the setting, each individual of separated by a whitespace,tab or | character

Returns

the 'fully' set integer, or SIZE_MAX if a set is not found

Definition at line 220 of file settings.cpp.

References OneOfManySettingDesc::ParseSingleValue(), and SetBit().

Referenced by ManyOfManySettingDesc::ParseValue().

ParseIntList()

static std::optional< std::vector< uint32_t > > ParseIntList ( const char *  p )

static

Parse a string into a vector of uint32s.

Parameters

p	the string to be parsed. Each element in the list is separated by a comma or a space character

Returns

std::optional with a vector of parsed integers. The optional is empty upon an error.

Definition at line 249 of file settings.cpp.

Referenced by GraphicsSetLoadConfig(), GRFLoadConfig(), and LoadIntList().

PrepareOldDiffCustom()

void PrepareOldDiffCustom

(

)

Prepare for reading and old diff_custom by zero-ing the memory.

Definition at line 25 of file settings_sl.cpp.

Referenced by OPTSChunkHandler::Load(), and LoadFromConfig().

PrivateSettingTables()

static auto & PrivateSettingTables ( )

static

List of all the private setting tables.

Definition at line 99 of file settings.cpp.

Referenced by GetSettingFromName(), IConsoleListSettings(), and SaveToConfig().

RemoveEntriesFromIni()

static void RemoveEntriesFromIni ( IniFile &  ini, const SettingTable &  table  )

static

Remove all entries from a settings table from an ini-file.

This is only useful if those entries are moved to another file, and you want to clean up what is left behind.

Parameters

ini	The ini file to remove the entries from.
table	The table to look for entries to remove.

Definition at line 1285 of file settings.cpp.

References IniLoadFile::GetGroup(), SettingDesc::GetName(), GetSettingDesc(), and IniGroup::RemoveItem().

Referenced by SaveToConfig().

SaveGRFPresetToConfig()

void SaveGRFPresetToConfig	(	const char *	config_name,
		GRFConfig *	config
	)

Save a NewGRF configuration with a preset name.

Parameters

config_name	Name of the preset.
config	NewGRF configuration to save.

See also

GetGRFPresetList

Definition at line 1558 of file settings.cpp.

References _config_file, and IniFile::SaveToDisk().

Referenced by NewGRFWindow::OnQueryTextFinished().

SaveToConfig()

void SaveToConfig

(

)

Save the values to the configuration file.

Definition at line 1447 of file settings.cpp.

References _config_file, _favs_file, _grfconfig_newgame, _grfconfig_static, _private_file, _secrets_file, IniGroup::comment, IniLoadFile::GetGroup(), GraphicsSetSaveConfig(), IFV_0, IFV_NETWORK_PRIVATE_SETTINGS, IFV_REMOVE_GENERATION_SEED, IniSaveSettingList(), IniSaveSettings(), PickerSaveConfig(), PrivateSettingTables(), RemoveEntriesFromIni(), IniLoadFile::RemoveGroup(), IniGroup::RemoveItem(), IniFile::SaveToDisk(), SaveVersionInConfig(), and SecretSettingTables().

Referenced by IntSettingDesc::ChangeValue(), StringSettingDesc::ChangeValue(), and DEF_CONSOLE_CMD().

SaveVersionInConfig()

static void SaveVersionInConfig ( IniFile &  ini )

static

Save the version of OpenTTD to the ini file.

Parameters

ini	the ini to write to

Definition at line 1200 of file settings.cpp.

References IniLoadFile::GetOrCreateGroup(), IniGroup::GetOrCreateItem(), INIFILE_VERSION, and IniItem::SetValue().

Referenced by SaveToConfig().

SecretSettingTables()

static auto & SecretSettingTables ( )

static

List of all the secrets setting tables.

Definition at line 110 of file settings.cpp.

Referenced by GetSettingFromName(), IConsoleListSettings(), and SaveToConfig().

SetDefaultCompanySettings()

void SetDefaultCompanySettings

(

CompanyID

cid

)

Set the company settings for a new company to their default values.

Definition at line 1783 of file settings.cpp.

References SettingDesc::AsIntSetting(), IntSettingDesc::def, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Get(), GetSettingDesc(), IntSettingDesc::MakeValueValidAndWrite(), and CompanyProperties::settings.

Referenced by DoStartupNewCompany().

SetSettingValue() [1/2]

bool SetSettingValue	(	const IntSettingDesc *	sd,
		int32_t	value,
		bool	force_newgame
	)

Top function to save the new value of an element of the Settings struct.

Parameters

index	offset in the SettingDesc array of the Settings struct which identifies the setting member we want to change
value	new value of the setting
force_newgame	force the newgame settings

Definition at line 1744 of file settings.cpp.

References _local_company, _network_server, _networking, _settings_client, _settings_newgame, SettingDesc::AsIntSetting(), IntSettingDesc::ChangeValue(), ClientSettings::company, SettingDesc::flags, GetGameSettings(), SettingDesc::GetName(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), SF_NO_NETWORK_SYNC, and SF_PER_COMPANY.

Referenced by GameSettingsWindow::OnClick(), GameSettingsWindow::OnDropdownSelect(), NetworkClientListWindow::OnQueryTextFinished(), and GameSettingsWindow::OnQueryTextFinished().

SetSettingValue() [2/2]

bool SetSettingValue	(	const StringSettingDesc *	sd,
		std::string	value,
		bool	force_newgame
	)

Set a setting value with a string.

Parameters

sd	the setting to change.
value	the value to write
force_newgame	force the newgame settings

Note

Strings WILL NOT be synced over the network

Definition at line 1819 of file settings.cpp.

References _settings_game, _settings_newgame, SettingDesc::AsStringSetting(), StringSettingDesc::ChangeValue(), SaveLoad::conv, SettingDesc::flags, GetVarMemType(), SettingDesc::save, SF_NO_NETWORK_SYNC, and SLE_VAR_STRQ.

SyncCompanySettings()

void SyncCompanySettings

(

)

Sync all company settings in a multiplayer game.

Definition at line 1795 of file settings.cpp.

References _current_company, _local_company, _settings_client, SettingDesc::AsIntSetting(), ClientSettings::company, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Get(), SettingDesc::GetName(), GetSettingDesc(), and IntSettingDesc::Read().

Referenced by CmdCompanyCtrl().

ValidateSettings()

static void ValidateSettings ( )

static

Checks if any settings are set to incorrect values, and sets them to correct values in that case.

Definition at line 931 of file settings.cpp.

References _settings_newgame, CUSTOM_SEA_LEVEL_MIN_PERCENTAGE, CUSTOM_SEA_LEVEL_NUMBER_DIFFICULTY, GameSettings::difficulty, GameSettings::game_creation, GameCreationSettings::land_generator, LG_ORIGINAL, and DifficultySettings::quantity_sea_lakes.

Referenced by LoadFromConfig().

Variable Documentation

_config_file

std::string _config_file

Configuration file of OpenTTD.

Definition at line 60 of file settings.cpp.

Referenced by DeleteGRFPresetFromConfig(), DetermineBasePaths(), DeterminePaths(), GetGRFPresetList(), LoadFromConfig(), LoadGRFPresetFromConfig(), openttd_main(), SaveGRFPresetToConfig(), and SaveToConfig().

_favs_file

std::string _favs_file

Picker favourites configuration file of OpenTTD.

Definition at line 63 of file settings.cpp.

Referenced by DeterminePaths(), LoadFromConfig(), and SaveToConfig().

_old_vds

VehicleDefaultSettings _old_vds

Used for loading default vehicles settings from old savegames.

Old vehicle settings, which were game settings before, and are company settings now.

Definition at line 59 of file settings.cpp.

Referenced by AfterLoadGame().

_private_file

std::string _private_file

Private configuration file of OpenTTD.

Definition at line 61 of file settings.cpp.

Referenced by DeterminePaths(), LoadFromConfig(), and SaveToConfig().

_secrets_file

std::string _secrets_file

Secrets configuration file of OpenTTD.

Definition at line 62 of file settings.cpp.

Referenced by DeterminePaths(), LoadFromConfig(), and SaveToConfig().

_settings_client

ClientSettings _settings_client

The current settings for this game.

Definition at line 56 of file settings.cpp.

Referenced by AddCustomRefreshRates(), AdjustGUIZoom(), AfterLoadGame(), AgeVehicle(), ServerNetworkAdminSocketHandler::AllowConnection(), AmbientSoundEffectCallback(), AnimationBase< Tbase, Tspec, Tobj, Textra, GetCallback, Tframehelper >::AnimateTile(), TimetableWindow::BuildArrivalDepartureList(), GameOptionsWindow::BuildDropDownList(), BuildLandLegend(), BuildLinkStatsLegend(), BuildOwnerLegend(), MusicSystem::BuildPlaylists(), BuildRailClick_Remove(), CalcRaildirsDrawstyle(), CcBuildBridge(), CcBuildRailTunnel(), CcBuildRoadTunnel(), CcRoadStop(), AnimationBase< Tbase, Tspec, Tobj, Textra, GetCallback, Tframehelper >::ChangeAnimationFrame(), ChangeAutosaveFrequency(), ChangeNetworkRestartTime(), MusicSystem::ChangePlaylist(), ChangePopulation(), ChangeTimekeepingUnits(), CheckClientAndServerName(), CheckMinActiveClients(), CheckOrders(), CheckPauseOnJoin(), CheckRedrawStationCoverage(), BuildRailStationWindow::CheckSelectedSize(), CheckSoftLimit(), MusicSystem::CheckStatus(), CheckTrainCollision(), CheckTrainStayInDepot(), ClearPathReservation(), BuildAirToolbarWindow::Close(), BuildDocksToolbarWindow::Close(), BuildRailToolbarWindow::Close(), BuildRoadToolbarWindow::Close(), CommonRaiseLowerBigLand(), CompanyServiceInterval(), Order::ConvertFromOldSavegame(), CrashAirplane(), DebugReconsiderSendRemoteMessages(), DebugSendRemoteMessages(), DEF_CONSOLE_CMD(), DisasterTick_Aircraft(), DisasterTick_Big_Ufo_Destroyer(), DisasterTick_Ufo(), DisasterTick_Zeppeliner(), DispatchRightClickEvent(), DistributeQueue(), DoAutoOrNetsave(), GRFFileScanner::DoScan(), DoZoomInOutWindow(), TimetableWindow::DrawArrivalDeparturePanel(), DrawBridgeMiddle(), LinkGraphOverlay::DrawContent(), BaseGraphWindow::DrawGraph(), DrawOrderString(), DrawSpriteToRgbaBuffer(), TimetableWindow::DrawSummaryPanel(), DrawTile_Road(), DrawTile_TunnelBridge(), DrawTrackBits(), BaseVehicleListWindow::DrawVehicleListItems(), DrawVehiclePurchaseInfo(), LinkGraphLegendWindow::DrawWidget(), MusicWindow::DrawWidget(), NetworkStartServerWindow::DrawWidget(), ScanProgressWindow::DrawWidget(), GameOptionsWindow::DrawWidget(), Blitter_8bppOptimized::Encode(), FiosNumberedSaveName::Filename(), FloodVehicle(), GenerateDefaultSaveName(), GenerateRockyArea(), GenericPlaceSignals(), GetDefaultServiceInterval(), GetLogPrefix(), GetOrderCmdFromTile(), GetSmallMapContoursPixels(), GetSmallMapIndustriesPixels(), GetSmallMapOwnerPixels(), GetSmallMapRoutesPixels(), GetSmallMapVehiclesPixels(), HandleAutoscroll(), HandleAutoSignalPlacement(), HandleMouseEvents(), Vehicle::HandlePathfindingResult(), HandlePlacePushButton(), HandleViewportScroll(), HandleWindowDragging(), HandleZoomMessage(), InitializeRailGUI(), InitializeWindowViewport(), MusicSystem::IsPlaying(), MusicSystem::IsShuffle(), LoadFromConfig(), LoadUnloadVehicle(), VideoDriver_Null::MainLoop(), MenuClickSettings(), NetworkAutoCleanCompanies(), NetworkCheckRestartMapYear(), NetworkClientJoinGame(), NetworkClientPreferTeamChat(), NetworkInitChatMessage(), NetworkMaxCompaniesAllowed(), NetworkServer_Tick(), NetworkServerSendChat(), NetworkUDPInitialize(), NetworkUpdateServerGameType(), NetworkValidateOurClientName(), NewsItem::NewsItem(), MusicSystem::Next(), BuildAirportWindow::OnClick(), BuildDocksStationWindow::OnClick(), BuildDocksDepotWindow::OnClick(), SaveLoadWindow::OnClick(), IndustryCargoesWindow::OnClick(), MusicWindow::OnClick(), NetworkGameWindow::OnClick(), NetworkStartServerWindow::OnClick(), NetworkClientListWindow::OnClick(), NetworkAskRelayWindow::OnClick(), NetworkAskSurveyWindow::OnClick(), BuildObjectWindow::OnClick(), PickerWindow::OnClick(), BuildRailStationWindow::OnClick(), BuildSignalWindow::OnClick(), BuildRailDepotWindow::OnClick(), BuildRoadToolbarWindow::OnClick(), BuildRoadDepotWindow::OnClick(), BuildRoadStationWindow::OnClick(), GameOptionsWindow::OnClick(), SmallMapWindow::OnClick(), ScenarioEditorLandscapeGenerationWindow::OnClick(), TimetableWindow::OnClick(), TransparenciesWindow::OnClick(), BuildTreesWindow::OnClick(), NetworkStartServerWindow::OnDropdownSelect(), NetworkClientListWindow::OnDropdownSelect(), GameOptionsWindow::OnDropdownSelect(), GameSettingsWindow::OnDropdownSelect(), ScenarioEditorToolbarWindow::OnDropdownSelect(), NetworkGameWindow::OnEditboxChanged(), MainWindow::OnHotkey(), SelectGameWindow::OnInit(), BuildRailStationWindow::OnInit(), ScriptDebugWindow::OnInit(), SelectCompanyLiveryWindow::OnInvalidateData(), SaveLoadWindow::OnInvalidateData(), MusicTrackSelectionWindow::OnInvalidateData(), MusicWindow::OnInvalidateData(), SpriteAlignerWindow::OnInvalidateData(), NewGRFWindow::OnInvalidateData(), BuildSignalWindow::OnInvalidateData(), ScriptDebugWindow::OnInvalidateData(), GameOptionsWindow::OnInvalidateData(), IndustryViewWindow::OnMouseWheel(), MainWindow::OnMouseWheel(), SmallMapWindow::OnMouseWheel(), TownViewWindow::OnMouseWheel(), VehicleViewWindow::OnMouseWheel(), ExtraViewportWindow::OnMouseWheel(), AfterNewGRFScan::OnNewGRFsScanned(), BuildDocksStationWindow::OnPaint(), BuildRailStationWindow::OnPaint(), BuildRoadStationWindow::OnPaint(), BuildRailToolbarWindow::OnPlaceMouseUp(), BuildRoadToolbarWindow::OnPlaceMouseUp(), BuildIndustryWindow::OnPlaceObject(), OrdersWindow::OnPlaceObject(), NetworkGameWindow::OnQueryTextFinished(), NetworkStartServerWindow::OnQueryTextFinished(), SmallMapWindow::OnScroll(), OnTick_Companies(), OrdersWindow::OrderClick_NearestDepot(), PlaceExtraDepotRail(), PlaceRail_Station(), MusicSystem::Play(), PlayVehicleSound(), VideoDriver_SDL_Base::PollEvent(), PopupMainToolbarMenu(), PositionMainToolbar(), PositionNetworkChatWindow(), PositionNewsMessage(), PositionStatusbar(), MusicSystem::Prev(), GSConfigWindow::RebuildVisibleSettings(), ScriptSettingsWindow::RebuildVisibleSettings(), ServerNetworkAdminSocketHandler::Receive_ADMIN_JOIN(), ServerNetworkGameSocketHandler::Receive_CLIENT_COMMAND(), ServerNetworkGameSocketHandler::Receive_CLIENT_IDENTIFY(), ServerNetworkGameSocketHandler::Receive_CLIENT_JOIN(), ServerNetworkGameSocketHandler::Receive_CLIENT_RCON(), ClientNetworkCoordinatorSocketHandler::Receive_GC_ERROR(), ClientNetworkCoordinatorSocketHandler::Receive_GC_REGISTER_ACK(), ClientNetworkCoordinatorSocketHandler::Receive_GC_TURN_CONNECT(), ClientNetworkGameSocketHandler::Receive_SERVER_AUTH_REQUEST(), ClientNetworkCoordinatorSocketHandler::Register(), ScriptScanner::RegisterScript(), ScriptConfig::ResetEditableSettings(), ResetSignalVariant(), MusicSystem::SaveCustomPlaylist(), SaveOrLoad(), SearchLumberMillTrees(), StationViewWindow::SelectGroupBy(), StationViewWindow::SelectSortBy(), StationViewWindow::SelectSortOrder(), ServerNetworkGameSocketHandler::SendConfigUpdate(), ClientNetworkCoordinatorSocketHandler::SendReceive(), ServerNetworkAdminSocketHandler::SendWelcome(), ServerNetworkGameSocketHandler::ServerNetworkGameSocketHandler(), ServiceIntervalSettingsValueText(), SetDefaultRailGui(), SetSettingValue(), BuildSignalWindow::SetSignalUIMode(), MusicTrackSelectionWindow::SetStringParameters(), NetworkStartServerWindow::SetStringParameters(), NetworkClientListWindow::SetStringParameters(), BuildSignalWindow::SetStringParameters(), GameOptionsWindow::SetStringParameters(), GRFConfig::SetSuitablePalette(), SetTimetableParams(), SetupScreenshotViewport(), NWidgetLeaf::SetupSmallestSize(), SetupWidgetDimensions(), ShowErrorMessage(), ShowMeasurementTooltips(), ShowNewspaper(), ShowSelectBaseStationIfNeeded(), ShowTicker(), MusicSystem::Shuffle(), MusicSystem::Stop(), SurveySettings(), SyncCompanySettings(), TicksPerTimetableUnit(), ToggleBoundingBoxes(), ToggleDirtyBlocks(), ToggleWidgetOutlines(), ToolbarFastForwardClick(), ToolbarOptionsClick(), TrainController(), NetworkSurveyHandler::Transmit(), TruncateBuffer(), TryPathReserve(), TryReserveRailTrack(), UnreserveRailTrack(), MusicSystem::Unshuffle(), UpdateAllServiceInterval(), UpdateGUIZoom(), UpdateLevelCrossingTile(), BuildTreesWindow::UpdateMode(), ScanProgressWindow::UpdateNewGRFScanStatus(), TimetableWindow::UpdateSelectionStates(), UpdateVehicleTimetable(), UpdateViewportPosition(), Town::UpdateVirtCoord(), NetworkClientListWindow::UpdateWidgetSize(), TimetableWindow::UpdateWidgetSize(), VehicleEnterDepot(), VehicleIsAboveLatenessThreshold(), and VpSelectTilesWithMethod().

_settings_error_list

ErrorList _settings_error_list

static

Errors while loading minimal settings.

Definition at line 65 of file settings.cpp.

Referenced by LoadFromConfig(), IntSettingDesc::ParseValue(), BoolSettingDesc::ParseValue(), OneOfManySettingDesc::ParseValue(), ManyOfManySettingDesc::ParseValue(), and ListSettingDesc::ParseValue().

_settings_game

GameSettings _settings_game

Game settings of a running game or the scenario editor.

The current settings for this game.

Definition at line 57 of file settings.cpp.

Referenced by _GenerateWorld(), AddAcceptedCargoOfHouse(), AffectSpeedByZChange(), AfterLoadGame(), AfterLoadVehiclesPhase2(), AfterNewGRFScan::AfterNewGRFScan(), AircraftController(), AircraftEventHandler_AtTerminal(), AutoslopeEnabled(), Subsidy::AwardTo(), BuildLandLegend(), BuildRailClick_Remove(), CalcEngineReliability(), CalculateDesertLine(), CalculateRefitMasks(), CalculateSnowLine(), CanBuildVehicleInfrastructure(), CanExpandRailStation(), CanRoadContinueIntoNextTile(), AI::CanStartNew(), ChangeIndustryProduction(), ChangeMinutesPerYear(), CheckAllowRemoveRoad(), CheckAllowRemoveTunnelBridge(), CheckBridgeAvailability(), CheckBuildableTile(), CheckCompanyHasMoney(), CheckFlatLandRoadStop(), CheckforTownRating(), CheckIfAuthorityAllowsNewStation(), CheckIfCanLevelIndustryPlatform(), CheckIfIndustryTileSlopes(), CheckIfTrainNeedsService(), CheckIndustryCloseDownProtection(), CheckNewIndustry_Farm(), CheckNewIndustry_Forest(), CheckNewIndustry_OilRefinery(), CheckNewIndustry_OilRig(), CheckNewTrain(), CheckNextTrainTile(), CheckRailSlope(), CheckRoadSlope(), CheckTakeoverVehicleLimit(), CheckTrainAttachment(), CheckTrainStayInDepot(), ClearTile_Town(), ClickChangeMaxHlCheat(), CmdBuildAirport(), CmdBuildBridge(), CmdBuildDock(), CmdBuildIndustry(), CmdBuildRailStation(), CmdBuildRailWaypoint(), CmdBuildRoad(), CmdBuildRoadDepot(), CmdBuildRoadStop(), CmdBuildRoadVehicle(), CmdBuildRoadWaypoint(), CmdBuildSingleRail(), CmdBuildSingleSignal(), CmdBuildTrainDepot(), CmdBuildTunnel(), CmdConvertRail(), CmdConvertRoad(), CmdFoundTown(), CmdGiveMoney(), CmdLevelLand(), CmdPlantTree(), CmdRefitVehicle(), CmdReverseTrainDirection(), CmdTerraformLand(), CompaniesGenStatistics(), Company::Company(), CompanyCheckBankrupt(), Train::ConsistChanged(), CreateNewIndustryHelper(), CreateRivers(), DeleteStaleLinks(), DeliverGoods(), DisplayVehicleSortDropDown(), DistanceFromEdgeDir(), DoCreateTown(), LinkGraphOverlay::DrawContent(), CompanyInfrastructureWindow::DrawCountLine(), StationViewWindow::DrawEntries(), DrawRoadAsSnowDesert(), SmallMapWindow::DrawSmallMapColumn(), DrawTrainDetails(), CompanyInfrastructureWindow::DrawWidget(), StatusBarWindow::DrawWidget(), TownViewWindow::DrawWidget(), VehicleDetailsWindow::DrawWidget(), IndustryBuildData::EconomyMonthlyLoop(), ExtendTrainReservation(), FinaliseEngineArray(), FinaliseHouseArray(), FindSpring(), FindStationsNearby(), FindSubsidyIndustryCargoRoute(), FindSubsidyTownCargoRoute(), FindTownForIndustry(), FlatEmptyWorld(), FlowRiver(), FollowTrainReservation(), ForAllStationsAroundTiles(), FormatString(), FreightWagonMult(), AI::GameLoop(), ScriptInstance::GameLoop(), GenerateIndustries(), GenerateLandscape(), GenerateStationName(), GenerateTerrainPerlin(), GenerateTownName(), GenerateTowns(), GenerateTrees(), GenerateWorld(), GetAcceptanceAroundTiles(), GetAirportNoiseLevelForDistance(), GetAmplitude(), GetAvailableMoney(), Station::GetCatchmentRadius(), GetClosestWaterDistance(), GetCompanyRailTypes(), GetCompanyRoadTypes(), AIConfig::GetConfig(), GameConfig::GetConfig(), IndustrySpec::GetConstructionCost(), RoadVehicle::GetCurrentMaxSpeed(), Train::GetCurrentMaxSpeed(), Train::GetCurveSpeedLimit(), TownViewWindow::GetDesiredInfoHeight(), TownAuthorityWindow::GetEnabledActions(), GetFreeUnitNumber(), GetGameSettings(), GetGlobalVariable(), GetIndustryGamePlayProbability(), Engine::GetLifeLengthInDays(), GetLoadAmount(), GetMaskOfTownActions(), GetMaxTreeSpriteSize(), GetNewEngine(), GetNewEngineID(), GetNormalGrowthRate(), GetNumberOfIndustries(), GetOtherAqueductEnd(), GetProductionAroundTiles(), GetRailTypes(), GetRandomTreeType(), GetRoadTypes(), GetScaledIndustryGenerationProbability(), RoadVehicle::GetSlopeSteepness(), Train::GetSlopeSteepness(), GetSmallMapVegetationPixels(), GetSnowLine(), GetTerrainType(), GetTileCatchmentRadius(), TownScopeResolver::GetVariable(), GetVelocityUnits(), GfxLoadSprites(), GlobalVarChangeInfo(), GrayscaleToMapHeights(), GrowTownInTile(), GUIPlaceProcDragXY(), Vehicle::HandleBreakdown(), HandleOldDiffCustom(), HasRailCatenaryDrawn(), HeightMapCoastLines(), HeightMapNormalize(), HeightMapSineTransform(), HighestSnowLine(), HighlightTownLocalAuthorityTiles(), IndustryCargoesWindow::HousesCanAccept(), IConsoleGetSetting(), IndustriesChangeInfo(), InitializeGRFSpecial(), InitLoading(), int_noise(), InverseRemapCoords2(), AirportSpec::IsAvailable(), IsCommandAllowedWhilePaused(), Engine::IsEnabled(), ObjectSpec::IsEverAvailable(), IsInnerTile(), IsRoadAllowedHere(), IsValidTileForWaypoint(), IsVehicleTypeDisabled(), OPTSChunkHandler::Load(), PATSChunkHandler::Load(), LoadNewGRF(), LoadSpriteTables(), LoadTownData(), LoadUnloadVehicle(), LowestSnowLine(), MakeLake(), MakeTreeTypeButtons(), Town::MaxTownNoise(), MaybeCrashAirplane(), MenuClickTown(), Gamelog::Mode(), Vehicle::NeedsServicing(), BuildIndustryWindow::OnClick(), FoundTownWindow::OnClick(), LandInfoWindow::OnInit(), FoundTownWindow::OnInit(), BuildVehicleWindow::OnInvalidateData(), BuildAirportWindow::OnPaint(), CompanyWindow::OnPaint(), BuildDocksStationWindow::OnPaint(), BuildRailStationWindow::OnPaint(), BuildRoadStationWindow::OnPaint(), ScenarioEditorToolbarWindow::OnPaint(), BuildObjectWindow::OnPlaceMouseUp(), TerraformToolbarWindow::OnPlaceMouseUp(), OnTick_Companies(), OnTick_LinkGraph(), ParamSet(), ScriptInstance::Pause(), CargoPayment::PayTransfer(), CYapfCostRailT< Types >::PfCalcCost(), PlaceRail_Station(), PlaceRail_Waypoint(), PlaceRoad_BusStation(), PlaceRoad_TruckStation(), PlaceRoad_Waypoint(), PlaceTreesRandomly(), PopulateStationsNearby(), SmallMapWindow::RebuildColourIndexIfNecessary(), Station::RecomputeCatchment(), RecomputePrices(), RemoveAirport(), RemoveRoad(), ReplaceChain(), AI::ResetConfig(), ResetIndustries(), ResetNewGRFData(), ReverseTrainDirection(), RoadFindPathToDest(), RoadVehAccelerationModelChanged(), PATSChunkHandler::Save(), ScaleByCargoScale(), ScaleByInverseCargoScale(), ServerNetworkAdminSocketHandler::SendWelcome(), HousePickerCallbacks::SetClimateMask(), SetSettingValue(), SetStartingYear(), CompanyFinancesWindow::SetStringParameters(), BuildIndustryWindow::SetStringParameters(), ScenarioEditorToolbarWindow::SetStringParameters(), SetupScreenshotViewport(), SetupSubsidyDecodeParam(), SetYearEngineAgingStops(), StationViewWindow::ShowCargo(), Vehicle::ShowVisualEffect(), SplitGroundSpriteForOverlay(), StartupOneEngine(), StateGameLoop(), StateGameLoop_LinkGraphPauseControl(), StationJoinerNeeded(), SurveySettings(), TerraformTileHeight(), TestAutoslopeOnRailTile(), Gamelog::TestMode(), TGPGetMaxHeight(), TileAddWrap(), TileLoop_Town(), ToolbarScenDatePanel(), TownActionBuyRights(), TownActionFundBuildings(), TownActionRoadRebuild(), TownAllowedToBuildRoads(), TownHouseChangeInfo(), TrainController(), TrainDetailsCapacityTab(), TrainDetailsCargoTab(), TryBuildTownHouse(), TryFoundTownNearby(), AI::Uninitialize(), Game::Uninitialize(), UpdateAircraftSpeed(), UpdateLandscapingLimits(), UpdateLoadUnloadTicks(), RoadVehicle::UpdateSpeed(), Train::UpdateSpeed(), UpdateTownGrowth(), CompanyInfrastructureWindow::UpdateWidgetSize(), IndustrySpec::UsesOriginalEconomy(), TimerGameEconomy::UsingWallclockUnits(), VehicleServiceInDepot(), ViewportAddLandscape(), YapfRoadVehicleChooseTrack(), YapfRoadVehicleFindNearestDepot(), YapfTrainCheckReverse(), YapfTrainChooseTrack(), YapfTrainFindNearestDepot(), YapfTrainFindNearestSafeTile(), and LinkGraphJob::~LinkGraphJob().

_settings_newgame

GameSettings _settings_newgame

Game settings for new games (updated from the intro screen).

The settings values that are used for new games and/or modified in config file.

Definition at line 58 of file settings.cpp.

Referenced by AfterLoadGame(), ChangeMinutesPerYear(), ChangeTimekeepingUnits(), AIConfig::GetConfig(), GameConfig::GetConfig(), GetGameSettings(), GetMapHeightLimit(), HandleOldDiffCustom(), IConsoleGetSetting(), SettingEntry::IsVisibleByRestrictionMode(), LoadFromConfig(), NetworkRestartMap(), GenerateLandscapeWindow::OnClick(), CreateScenarioWindow::OnClick(), GenerateLandscapeWindow::OnDropdownSelect(), CreateScenarioWindow::OnDropdownSelect(), GenerateLandscapeWindow::OnInvalidateData(), SelectGameWindow::OnInvalidateData(), AfterNewGRFScan::OnNewGRFsScanned(), CreateScenarioWindow::OnPaint(), GenerateLandscapeWindow::OnQueryTextFinished(), CreateScenarioWindow::OnQueryTextFinished(), AI::ResetConfig(), SetNewLandscapeType(), SetSettingValue(), SetSettingValue(), GenerateLandscapeWindow::SetStringParameters(), CreateScenarioWindow::SetStringParameters(), StartNewGameWithoutGUI(), AI::Uninitialize(), Game::Uninitialize(), TimerGameEconomy::UsingWallclockUnits(), and ValidateSettings().

INIFILE_VERSION

const uint16_t INIFILE_VERSION = (IniFileVersion)(IFV_MAX_VERSION - 1)

Current ini-file version of OpenTTD.

Definition at line 176 of file settings.cpp.

Referenced by SaveVersionInConfig().