Functions to find and configure NewGRFs. More...

#include "strings_type.h"
#include "fileio_type.h"
#include "textfile_type.h"
#include "newgrf_text.h"
#include "3rdparty/md5/md5.h"

Go to the source code of this file.

Data Structures
struct	GRFIdentifier
	Basic data to distinguish a GRF. More...

struct	GRFError
	Information about why GRF had problems during initialisation. More...

struct	GRFParameterInfo
	Information about one grf parameter. More...

struct	GRFConfig
	Information about GRF, used in the game and (part of it) in savegames. More...

struct	NewGRFScanCallback
	Callback for NewGRF scanning. More...

Typedefs
using	GRFConfigFlags = EnumBitSet< GRFConfigFlag, uint8_t >

using	GRFBugs = EnumBitSet< GRFBug, uint8_t >

using	GRFConfigList = std::vector< std::unique_ptr< GRFConfig > >

Enumerations
enum	GRFConfigFlag : uint8_t { System , Unsafe , Static , Compatible , Copy , InitOnly , Reserved , Invalid }
	GRF config bit flags. More...

enum	GRFStatus : uint8_t { GCS_UNKNOWN , GCS_DISABLED , GCS_NOT_FOUND , GCS_INITIALISED , GCS_ACTIVATED }
	Status of GRF. More...

enum class	GRFBug : uint8_t { VehLength = 0 , VehRefit = 1 , VehPoweredWagon = 2 , UnknownCbResult = 3 , VehCapacity = 4 }
	Encountered GRF bugs. More...

enum	GRFListCompatibility : uint8_t { GLC_ALL_GOOD , GLC_COMPATIBLE , GLC_NOT_FOUND }
	Status of post-gameload GRF compatibility check. More...

enum	GRFPalette : uint8_t { GRFP_USE_BIT = 0 , GRFP_GRF_OFFSET = 2 , GRFP_GRF_SIZE = 2 , GRFP_BLT_OFFSET = 4 , GRFP_BLT_SIZE = 1 , GRFP_USE_DOS = 0x0 , GRFP_USE_WINDOWS = 0x1 , GRFP_USE_MASK = 0x1 , GRFP_GRF_UNSET = 0x0 << GRFP_GRF_OFFSET , GRFP_GRF_DOS = 0x1 << GRFP_GRF_OFFSET , GRFP_GRF_WINDOWS = 0x2 << GRFP_GRF_OFFSET , GRFP_GRF_ANY = GRFP_GRF_DOS \| GRFP_GRF_WINDOWS , GRFP_GRF_MASK = GRFP_GRF_ANY , GRFP_BLT_UNSET = 0x0 << GRFP_BLT_OFFSET , GRFP_BLT_32BPP = 0x1 << GRFP_BLT_OFFSET , GRFP_BLT_MASK = GRFP_BLT_32BPP }
	Information that can/has to be stored about a GRF's palette. More...

enum	GRFParameterType : uint8_t { PTYPE_UINT_ENUM , PTYPE_BOOL , PTYPE_END }
	The possible types of a newgrf parameter. More...

enum	FindGRFConfigMode : uint8_t { FGCM_EXACT , FGCM_COMPATIBLE , FGCM_NEWEST , FGCM_NEWEST_VALID , FGCM_ANY }
	Method to find GRFs using FindGRFConfig. More...

Functions
size_t	GRFGetSizeOfDataSection (FileHandle &f)
	Get the data section size of a GRF.

void	ScanNewGRFFiles (NewGRFScanCallback *callback)
	Scan for all NewGRFs.

const GRFConfig *	FindGRFConfig (uint32_t grfid, FindGRFConfigMode mode, const MD5Hash *md5sum=nullptr, uint32_t desired_version=0)
	Find a NewGRF in the scanned list.

GRFConfig *	GetGRFConfig (uint32_t grfid, uint32_t mask=0xFFFFFFFF)
	Retrieve a NewGRF from the current config by its grfid.

void	CopyGRFConfigList (GRFConfigList &dst, const GRFConfigList &src, bool init_only)
	Copy a GRF Config list.

void	AppendStaticGRFConfigs (GRFConfigList &dst)
	Appends the static GRFs to a list of GRFs.

void	AppendToGRFConfigList (GRFConfigList &dst, std::unique_ptr< GRFConfig > &&el)
	Appends an element to a list of GRFs.

void	ClearGRFConfigList (GRFConfigList &config)
	Clear a GRF Config list, freeing all nodes.

void	ResetGRFConfig (bool defaults)
	Reset the current GRF Config to either blank or newgame settings.

GRFListCompatibility	IsGoodGRFConfigList (GRFConfigList &grfconfig)
	Check if all GRFs in the GRF config from a savegame can be loaded.

bool	FillGRFDetails (GRFConfig &config, bool is_static, Subdirectory subdir=NEWGRF_DIR)
	Find the GRFID of a given grf, and calculate its md5sum.

std::string	GRFBuildParamList (const GRFConfig &c)
	Build a string containing space separated parameter values, and terminate.

void	ShowNewGRFSettings (bool editable, bool show_params, bool exec_changes, GRFConfigList &config)
	Setup the NewGRF gui.

void	OpenGRFParameterWindow (bool is_baseset, GRFConfig &c, bool editable)

void	UpdateNewGRFScanStatus (uint num, const char *name)
	Update the NewGRF scan status.

void	UpdateNewGRFConfigPalette (int32_t new_value=0)
	Update the palettes of the graphics from the config file.

Variables
GRFConfigList	_all_grfs
	First item in list of all scanned NewGRFs.

GRFConfigList	_grfconfig
	First item in list of current GRF set up.

GRFConfigList	_grfconfig_newgame
	First item in list of default GRF set up.

GRFConfigList	_grfconfig_static
	First item in list of static GRF set up.

uint	_missing_extra_graphics
	Number of sprites provided by the fallback extra GRF, i.e. missing in the baseset.

Detailed Description

Functions to find and configure NewGRFs.

Definition in file newgrf_config.h.

Typedef Documentation

◆ GRFBugs

using GRFBugs = EnumBitSet<GRFBug, uint8_t>

Definition at line 49 of file newgrf_config.h.

◆ GRFConfigFlags

using GRFConfigFlags = EnumBitSet<GRFConfigFlag, uint8_t>

Definition at line 30 of file newgrf_config.h.

◆ GRFConfigList

using GRFConfigList = std::vector<std::unique_ptr<GRFConfig> >

Definition at line 202 of file newgrf_config.h.

Enumeration Type Documentation

◆ FindGRFConfigMode

enum FindGRFConfigMode : uint8_t

Method to find GRFs using FindGRFConfig.

Enumerator
FGCM_EXACT	Only find Grfs matching md5sum.
FGCM_COMPATIBLE	Find best compatible Grf wrt. desired_version.
FGCM_NEWEST	Find newest Grf.
FGCM_NEWEST_VALID	Find newest Grf, ignoring Grfs with GRFConfigFlag::Invalid set.
FGCM_ANY	Use first found.

Definition at line 205 of file newgrf_config.h.

◆ GRFBug

enum class GRFBug : uint8_t

strong

Encountered GRF bugs.

Enumerator
VehLength	Length of rail vehicle changes when not inside a depot.
VehRefit	Articulated vehicles carry different cargoes resp. are differently refittable than specified in purchase list.
VehPoweredWagon	Powered wagon changed poweredness state when not inside a depot.
UnknownCbResult	A callback returned an unknown/invalid result.
VehCapacity	Capacity of vehicle changes when not refitting or arranging.

Definition at line 42 of file newgrf_config.h.

◆ GRFConfigFlag

enum GRFConfigFlag : uint8_t

GRF config bit flags.

Enumerator
System	GRF file is an openttd-internal system grf.
Unsafe	GRF file is unsafe for static usage.
Static	GRF file is used statically (can be used in any MP game)
Compatible	GRF file does not exactly match the requested GRF (different MD5SUM), but grfid matches)
Copy	The data is copied from a grf in _all_grfs.
InitOnly	GRF file is processed up to GLS_INIT.
Reserved	GRF file passed GLS_RESERVE stage.
Invalid	GRF is unusable with this version of OpenTTD.

Definition at line 20 of file newgrf_config.h.

◆ GRFListCompatibility

enum GRFListCompatibility : uint8_t

Status of post-gameload GRF compatibility check.

Enumerator
GLC_ALL_GOOD	All GRF needed by game are present.
GLC_COMPATIBLE	Compatible (eg. the same ID, but different checksum) GRF found in at least one case.
GLC_NOT_FOUND	At least one GRF couldn't be found (higher priority than GLC_COMPATIBLE)

Definition at line 52 of file newgrf_config.h.

◆ GRFPalette

enum GRFPalette : uint8_t

Information that can/has to be stored about a GRF's palette.

Enumerator
GRFP_USE_BIT	The bit used for storing the palette to use.
GRFP_GRF_OFFSET	The offset of the GRFP_GRF data.
GRFP_GRF_SIZE	The size of the GRFP_GRF data.
GRFP_BLT_OFFSET	The offset of the GRFP_BLT data.
GRFP_BLT_SIZE	The size of the GRFP_BLT data.
GRFP_USE_DOS	The palette state is set to use the DOS palette.
GRFP_USE_WINDOWS	The palette state is set to use the Windows palette.
GRFP_USE_MASK	Bitmask to get only the use palette use states.
GRFP_GRF_UNSET	The NewGRF provided no information.
GRFP_GRF_DOS	The NewGRF says the DOS palette can be used.
GRFP_GRF_WINDOWS	The NewGRF says the Windows palette can be used.
GRFP_GRF_ANY	The NewGRF says any palette can be used.
GRFP_GRF_MASK	Bitmask to get only the NewGRF supplied information.
GRFP_BLT_UNSET	The NewGRF provided no information or doesn't care about a 32 bpp blitter.
GRFP_BLT_32BPP	The NewGRF prefers a 32 bpp blitter.
GRFP_BLT_MASK	Bitmask to only get the blitter information.

Definition at line 59 of file newgrf_config.h.

◆ GRFParameterType

enum GRFParameterType : uint8_t

The possible types of a newgrf parameter.

Enumerator
PTYPE_UINT_ENUM	The parameter allows a range of numbers, each of which can have a special name.
PTYPE_BOOL	The parameter is either 0 or 1.
PTYPE_END	Invalid parameter type.

Definition at line 120 of file newgrf_config.h.

◆ GRFStatus

enum GRFStatus : uint8_t

Status of GRF.

Enumerator
GCS_UNKNOWN	The status of this grf file is unknown.
GCS_DISABLED	GRF file is disabled.
GCS_NOT_FOUND	GRF file was not found in the local cache.
GCS_INITIALISED	GRF file has been initialised.
GCS_ACTIVATED	GRF file has been activated.

Definition at line 33 of file newgrf_config.h.

Function Documentation

◆ AppendStaticGRFConfigs()

void AppendStaticGRFConfigs ( GRFConfigList & dst )

Appends the static GRFs to a list of GRFs.

Parameters

dst	the head of the list to add to

Definition at line 393 of file newgrf_config.cpp.

References _grfconfig_static, AppendGRFConfigList(), and RemoveDuplicatesFromGRFConfigList().

Referenced by NGRFChunkHandler::Load(), and ResetGRFConfig().

◆ AppendToGRFConfigList()

void AppendToGRFConfigList	(	GRFConfigList &	dst,
		std::unique_ptr< GRFConfig > &&	el
	)

Appends an element to a list of GRFs.

Parameters

dst	the head of the list to add to
el	the new tail to be

Definition at line 404 of file newgrf_config.cpp.

References RemoveDuplicatesFromGRFConfigList().

◆ ClearGRFConfigList()

void ClearGRFConfigList ( GRFConfigList & config )

Clear a GRF Config list, freeing all nodes.

Parameters

config Start of the list.

Postcondition: config is set to nullptr.

Definition at line 329 of file newgrf_config.cpp.

Referenced by LoadCheckData::Clear(), CopyGRFConfigList(), DoLoad(), DoScanNewGRFFiles(), NetworkAddServer(), NewGRFWindow::OnDropdownSelect(), ClientNetworkCoordinatorSocketHandler::Receive_GC_LISTING(), QueryNetworkGameSocketHandler::Receive_SERVER_GAME_INFO(), and SaveOrLoad().

◆ CopyGRFConfigList()

void CopyGRFConfigList	(	GRFConfigList &	dst,
		const GRFConfigList &	src,
		bool	init_only
	)

Copy a GRF Config list.

Parameters

dst	The destination list
src	The source list
init_only	the copied GRF will be processed up to GLS_INIT

Definition at line 358 of file newgrf_config.cpp.

References AppendGRFConfigList(), and ClearGRFConfigList().

Referenced by NewGRFWindow::Close(), NewGRFConfirmationCallback(), NewGRFWindow::OnClick(), and ResetGRFConfig().

◆ FillGRFDetails()

bool FillGRFDetails	(	GRFConfig &	config,
		bool	is_static,
		Subdirectory	subdir
	)

Find the GRFID of a given grf, and calculate its md5sum.

Parameters

config	grf to fill.
is_static	grf is static.
subdir	the subdirectory to search in.

Returns: Operation was successfully completed.

Definition at line 297 of file newgrf_config.cpp.

References CalcGRFMD5Sum(), GRFConfig::filename, GRFConfig::FinalizeParameterInfo(), FioCheckFileExists(), GRFConfig::flags, GCS_NOT_FOUND, GRFIdentifier::grfid, GRFConfig::ident, LoadNewGRFFile(), GRFConfig::SetSuitablePalette(), GRFConfig::status, System, EnumBitSet< Tenum, Tstorage >::Test(), and Unsafe.

Referenced by GRFFileScanner::AddFile(), GetDefaultExtraGRFConfig(), GraphicsSet::GetOrCreateExtraConfig(), and GRFLoadConfig().

◆ FindGRFConfig()

const GRFConfig * FindGRFConfig	(	uint32_t	grfid,
		FindGRFConfigMode	mode,
		const MD5Hash *	md5sum,
		uint32_t	desired_version
	)

Find a NewGRF in the scanned list.

Parameters

grfid	GRFID to look for,
mode	Restrictions for matching grfs
md5sum	Expected MD5 sum
desired_version	Requested version

Returns: The matching grf, if it exists in _all_grfs, else nullptr.

Definition at line 603 of file newgrf_config.cpp.

References _all_grfs, FGCM_ANY, FGCM_COMPATIBLE, FGCM_EXACT, FGCM_NEWEST, Invalid, and GRFConfig::version.

Referenced by AddGrfInfo(), ContentInfo::GetTextfile(), GRFLoadConfig(), HasGRFConfig(), IsGoodGRFConfigList(), NetworkAfterNewGRFScan(), NewGRFWindow::OnInvalidateData(), and ClientNetworkGameSocketHandler::Receive_SERVER_CHECK_NEWGRFS().

◆ GetGRFConfig()

GRFConfig * GetGRFConfig	(	uint32_t	grfid,
		uint32_t	mask
	)

Retrieve a NewGRF from the current config by its grfid.

Parameters

grfid	grf to look for.
mask	GRFID mask to allow for partial matching.

Returns: The grf config, if it exists, else nullptr.

Definition at line 629 of file newgrf_config.cpp.

References _grfconfig.

Referenced by DrawVehiclePurchaseInfo(), ErrorUnknownCallbackResult(), ParamSet(), ShowNewGrfVehicleError(), TranslateGRFStrings(), and VehicleLengthChanged().

◆ GRFBuildParamList()

std::string GRFBuildParamList ( const GRFConfig & c )

Build a string containing space separated parameter values, and terminate.

Definition at line 639 of file newgrf_config.cpp.

References GRFConfig::param.

Referenced by GraphicsSetSaveConfig().

◆ GRFGetSizeOfDataSection()

size_t GRFGetSizeOfDataSection ( FileHandle & f )

Get the data section size of a GRF.

Parameters

f GRF.

Returns: Size of the data section or SIZE_MAX if the file has no separate data section.

Definition at line 232 of file newgrf_config.cpp.

References _grf_cont_v2_sig, Debug, and MemCmpT().

Referenced by CalcGRFMD5Sum(), and GraphicsSet::CheckMD5().

◆ IsGoodGRFConfigList()

GRFListCompatibility IsGoodGRFConfigList ( GRFConfigList & grfconfig )

Check if all GRFs in the GRF config from a savegame can be loaded.

Parameters

grfconfig GrfConfig to check

Returns

will return any of the following 3 values:

GLC_ALL_GOOD: No problems occurred, all GRF files were found and loaded
GLC_COMPATIBLE: For one or more GRF's no exact match was found, but a compatible GRF with the same grfid was found and used instead
GLC_NOT_FOUND: For one or more GRF's no match was found at all

Definition at line 430 of file newgrf_config.cpp.

References Compatible, Copy, Debug, FGCM_COMPATIBLE, FGCM_EXACT, GRFConfig::filename, FindGRFConfig(), GRFConfig::flags, FormatArrayAsHex(), GCS_NOT_FOUND, GLC_ALL_GOOD, GLC_COMPATIBLE, GLC_NOT_FOUND, GRFIdentifier::grfid, GRFConfig::has_param_defaults, GRFConfig::ident, Invalid, GRFIdentifier::md5sum, GRFConfig::min_loadable_version, GRFConfig::name, GRFConfig::num_valid_params, GRFConfig::param_info, EnumBitSet< Tenum, Tstorage >::Test(), and GRFConfig::version.

Referenced by AfterLoadGame(), and DoLoad().

◆ OpenGRFParameterWindow()

void OpenGRFParameterWindow	(	bool	is_baseset,
		GRFConfig &	c,
		bool	editable
	)

Definition at line 548 of file newgrf_gui.cpp.

◆ ResetGRFConfig()

void ResetGRFConfig ( bool defaults )

Reset the current GRF Config to either blank or newgame settings.

Definition at line 412 of file newgrf_config.cpp.

References _grfconfig, _grfconfig_newgame, AppendStaticGRFConfigs(), and CopyGRFConfigList().

Referenced by NewGRFWindow::Close(), NGRFChunkHandler::Load(), LoadIntroGame(), NewGRFWindow::OnClick(), and AfterNewGRFScan::OnNewGRFsScanned().

◆ ScanNewGRFFiles()

void ScanNewGRFFiles ( NewGRFScanCallback * callback )

Scan for all NewGRFs.

Parameters

callback The callback to call after the scanning is complete.

Definition at line 585 of file newgrf_config.cpp.

References DoScanNewGRFFiles(), MarkWholeScreenDirty(), and SetModalProgress().

◆ ShowNewGRFSettings()

void ShowNewGRFSettings	(	bool	editable,
		bool	show_params,
		bool	exec_changes,
		GRFConfigList &	config
	)

Setup the NewGRF gui.

Parameters

editable	allow the user to make changes to the grfconfig in the window
show_params	show information about what parameters are set for the grf files
exec_changes	if changes are made to the list (editable is true), apply these changes immediately or only update the list
config	The GRFConfigList that will be shown.

Definition at line 1985 of file newgrf_gui.cpp.

References CloseWindowByClass(), and WC_GAME_OPTIONS.

Referenced by MenuClickSettings(), SaveLoadWindow::OnClick(), GenerateLandscapeWindow::OnClick(), SelectGameWindow::OnClick(), and NetworkGameWindow::OnClick().

◆ UpdateNewGRFConfigPalette()

void UpdateNewGRFConfigPalette ( int32_t new_value )

Update the palettes of the graphics from the config file.

Called when changing the default palette in advanced settings.

Definition at line 220 of file newgrf_config.cpp.

References _all_grfs, _grfconfig_newgame, and _grfconfig_static.

Referenced by AfterNewGRFScan::OnNewGRFsScanned().

◆ UpdateNewGRFScanStatus()

void UpdateNewGRFScanStatus	(	uint	num,
		const char *	name
	)

Update the NewGRF scan status.

Parameters

num	The number of NewGRFs scanned so far.
name	The name of the last scanned NewGRF.

Definition at line 2251 of file newgrf_gui.cpp.

References FindWindowByClass(), ScanProgressWindow::UpdateNewGRFScanStatus(), and WC_MODAL_PROGRESS.

Referenced by GRFFileScanner::AddFile().

Variable Documentation

◆ _all_grfs

GRFConfigList _all_grfs

extern

First item in list of all scanned NewGRFs.

Definition at line 149 of file newgrf_config.cpp.

Referenced by GRFFileScanner::AddFile(), NewGRFWindow::CanUpgradeCurrent(), DoScanNewGRFFiles(), FindGRFConfig(), UpdateNewGRFConfigPalette(), and NewGRFWindow::UpgradeCurrent().

◆ _grfconfig

GRFConfigList _grfconfig

extern

First item in list of current GRF set up.

Definition at line 150 of file newgrf_config.cpp.

Referenced by AfterLoadGame(), DoLoad(), GetGRFConfig(), HandleSavegameLoadCrash(), NGRFChunkHandler::Load(), LoadNewGRF(), MakePNGImage(), MenuClickSettings(), NewGRFConfirmationCallback(), ResetGRFConfig(), ResetNewGRFErrors(), NGRFChunkHandler::Save(), SaveOrLoad(), ServerNetworkGameSocketHandler::SendNewGRFCheck(), ShowNewGRFError(), SurveyGrfs(), and SwitchNewGRFBlitter().

◆ _grfconfig_newgame

GRFConfigList _grfconfig_newgame

extern

First item in list of default GRF set up.

Definition at line 151 of file newgrf_config.cpp.

Referenced by LoadFromConfig(), GenerateLandscapeWindow::OnClick(), SelectGameWindow::OnClick(), ResetGRFConfig(), SaveToConfig(), and UpdateNewGRFConfigPalette().

◆ _grfconfig_static

GRFConfigList _grfconfig_static

extern

First item in list of static GRF set up.

Definition at line 152 of file newgrf_config.cpp.

Referenced by AppendStaticGRFConfigs(), LoadFromConfig(), SaveToConfig(), and UpdateNewGRFConfigPalette().

◆ _missing_extra_graphics

uint _missing_extra_graphics

extern

Number of sprites provided by the fallback extra GRF, i.e. missing in the baseset.

Definition at line 153 of file newgrf_config.cpp.

Referenced by SelectGameWindow::DrawWidget(), SelectGameWindow::OnInit(), and SelectGameWindow::OnResize().

Data Structures

Typedefs

Enumerations

Functions

Variables

Detailed Description

Typedef Documentation

◆ GRFBugs

◆ GRFConfigFlags

◆ GRFConfigList

Enumeration Type Documentation

◆ FindGRFConfigMode

◆ GRFBug

◆ GRFConfigFlag

◆ GRFListCompatibility

◆ GRFPalette

◆ GRFParameterType

◆ GRFStatus

Function Documentation

◆ AppendStaticGRFConfigs()

◆ AppendToGRFConfigList()

◆ ClearGRFConfigList()

◆ CopyGRFConfigList()

◆ FillGRFDetails()

◆ FindGRFConfig()

◆ GetGRFConfig()

◆ GRFBuildParamList()

◆ GRFGetSizeOfDataSection()

◆ IsGoodGRFConfigList()

◆ OpenGRFParameterWindow()

◆ ResetGRFConfig()

◆ ScanNewGRFFiles()

◆ ShowNewGRFSettings()

◆ UpdateNewGRFConfigPalette()

◆ UpdateNewGRFScanStatus()

Variable Documentation

◆ _all_grfs

◆ _grfconfig

◆ _grfconfig_newgame

◆ _grfconfig_static

◆ _missing_extra_graphics