Functions related to setting/changing the settings. More...

#include "company_type.h"
#include "string_type.h"
#include "newgrf_config.h"

Functions
void	IConsoleSetSetting (std::string_view name, std::string_view value, bool force_newgame=false)

void	IConsoleSetSetting (std::string_view name, int32_t value)

void	IConsoleGetSetting (std::string_view name, bool force_newgame=false)
	Output value of a specific setting to the console.

void	IConsoleListSettings (std::string_view prefilter)
	List all settings and their value to the console.

void	LoadFromConfig (bool minimal=false)
	Load the values from the configuration files.

void	SaveToConfig ()
	Save the values to the configuration file.

void	IniLoadWindowSettings (IniFile &ini, std::string_view grpname, WindowDesc *desc)
	Load a WindowDesc from config.

void	IniSaveWindowSettings (IniFile &ini, std::string_view grpname, WindowDesc *desc)
	Save a WindowDesc to config.

StringList	GetGRFPresetList ()
	Get the list of known NewGrf presets.

GRFConfigList	LoadGRFPresetFromConfig (std::string_view config_name)
	Load a NewGRF configuration by preset-name.

void	SaveGRFPresetToConfig (std::string_view config_name, GRFConfigList &config)
	Save a NewGRF configuration with a preset name.

void	DeleteGRFPresetFromConfig (std::string_view config_name)
	Delete a NewGRF configuration by preset name.

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.

Detailed Description

Functions related to setting/changing the settings.

Definition in file settings_func.h.

Function Documentation

◆ DeleteGRFPresetFromConfig()

void DeleteGRFPresetFromConfig ( std::string_view config_name )

Delete a NewGRF configuration by preset name.

Parameters

config_name Name of the preset.

Definition at line 1592 of file settings.cpp.

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

Referenced by NewGRFWindow::OnClick().

◆ GetGRFPresetList()

StringList GetGRFPresetList ( )

Get the list of known NewGrf presets.

Returns: List of preset names.

Definition at line 1541 of file settings.cpp.

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

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

◆ IConsoleGetSetting()

void IConsoleGetSetting	(	std::string_view	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 1967 of file settings.cpp.

References _settings_game, _settings_newgame, SettingDesc::AsIntSetting(), SettingDesc::AsStringSetting(), CC_ERROR, CC_INFO, SettingDesc::flags, SettingDesc::FormatValue(), IntSettingDesc::GetDefaultValue(), SettingDesc::GetName(), IntSettingDesc::GetRange(), GetSettingFromName(), GuiZeroIsSpecial, IConsolePrint(), SettingDesc::IsIntSetting(), SettingDesc::IsStringSetting(), PerCompany, StringSettingDesc::Read(), and BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test().

◆ IConsoleListSettings()

void IConsoleListSettings ( std::string_view 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 2005 of file settings.cpp.

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

◆ IConsoleSetSetting()

void IConsoleSetSetting	(	std::string_view	name,
		std::string_view	value,
		bool	force_newgame = `false`
	)

Definition at line 1923 of file settings.cpp.

◆ IniLoadWindowSettings()

void IniLoadWindowSettings	(	IniFile &	ini,
		std::string_view	grpname,
		WindowDesc *	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 872 of file settings.cpp.

References IniLoadSettings().

Referenced by WindowDesc::LoadFromConfig().

◆ IniSaveWindowSettings()

void IniSaveWindowSettings	(	IniFile &	ini,
		std::string_view	grpname,
		WindowDesc *	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 883 of file settings.cpp.

References IniSaveSettings().

Referenced by WindowDesc::SaveToConfig().