OpenTTD Source 20241224-master-gf74b0cf984
newgrf_sl.cpp
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
6 */
7
10#include "../stdafx.h"
11
12#include "saveload.h"
14
15#include "newgrf_sl.h"
16#include "../fios.h"
17
18#include "../safeguards.h"
19
22 SLE_VAR(EntityIDMapping, grfid, SLE_UINT32),
23 SLE_CONDVAR(EntityIDMapping, entity_id, SLE_FILE_U8 | SLE_VAR_U16, SL_MIN_VERSION, SLV_EXTEND_ENTITY_MAPPING),
25 SLE_CONDVAR(EntityIDMapping, substitute_id, SLE_FILE_U8 | SLE_VAR_U16, SL_MIN_VERSION, SLV_EXTEND_ENTITY_MAPPING),
27};
28
33{
35
36 for (uint i = 0; i < this->mapping.GetMaxMapping(); i++) {
37 if (this->mapping.mappings[i].grfid == 0 &&
38 this->mapping.mappings[i].entity_id == 0) continue;
39 SlSetArrayIndex(i);
40 SlObject(&this->mapping.mappings[i], _newgrf_mapping_desc);
41 }
42}
43
48{
49 const std::vector<SaveLoad> slt = SlCompatTableHeader(_newgrf_mapping_desc, _newgrf_mapping_sl_compat);
50
51 /* Clear the current mapping stored.
52 * This will create the manager if ever it is not yet done */
53 this->mapping.ResetMapping();
54
55 uint max_id = this->mapping.GetMaxMapping();
56
57 int index;
58 while ((index = SlIterateArray()) != -1) {
59 if ((uint)index >= max_id) SlErrorCorrupt("Too many NewGRF entity mappings");
60 SlObject(&this->mapping.mappings[index], slt);
61 }
62}
63
65 NGRFChunkHandler() : ChunkHandler('NGRF', CH_TABLE) {}
66
67 static inline std::array<uint32_t, GRFConfig::MAX_NUM_PARAMS> param;
68 static inline uint8_t num_params;
69
70 static inline const SaveLoad description[] = {
71 SLE_SSTR(GRFConfig, filename, SLE_STR),
72 SLE_VAR(GRFConfig, ident.grfid, SLE_UINT32),
73 SLE_ARR(GRFConfig, ident.md5sum, SLE_UINT8, 16),
74 SLE_CONDVAR(GRFConfig, version, SLE_UINT32, SLV_151, SL_MAX_VERSION),
75 SLEG_ARR("param", param, SLE_UINT32, std::size(param)),
76 SLEG_VAR("num_params", num_params, SLE_UINT8),
77 SLE_CONDVAR(GRFConfig, palette, SLE_UINT8, SLV_101, SL_MAX_VERSION),
78 };
79
80 void SaveParameters(const GRFConfig &config) const
81 {
82 /* Transfer config to fixed array, ensure unused entries are blanked. */
83 param.fill(0);
84 num_params = static_cast<uint8_t>(std::size(config.param));
85 std::copy(std::begin(config.param), std::end(config.param), std::begin(param));
86 }
87
88 void Save() const override
89 {
90 SlTableHeader(description);
91
92 int index = 0;
93
94 for (GRFConfig *c = _grfconfig; c != nullptr; c = c->next) {
95 if (HasBit(c->flags, GCF_STATIC) || HasBit(c->flags, GCF_INIT_ONLY)) continue;
96 this->SaveParameters(*c);
97 SlSetArrayIndex(index++);
98 SlObject(c, description);
99 }
100 }
101
102 void LoadParameters(GRFConfig &config) const
103 {
104 /* Transfer used part of fixed array to config. */
105 auto last = std::begin(param) + std::min<size_t>(std::size(param), num_params);
106 config.param.assign(std::begin(param), last);
107 }
108
109 void LoadCommon(GRFConfig *&grfconfig) const
110 {
111 const std::vector<SaveLoad> slt = SlCompatTableHeader(description, _grfconfig_sl_compat);
112
113 ClearGRFConfigList(&grfconfig);
114 while (SlIterateArray() != -1) {
115 GRFConfig *c = new GRFConfig();
116 SlObject(c, slt);
118 this->LoadParameters(*c);
119 AppendToGRFConfigList(&grfconfig, c);
120 }
121 }
122
123 void Load() const override
124 {
125 this->LoadCommon(_grfconfig);
126
127 if (_game_mode == GM_MENU) {
128 /* Intro game must not have NewGRF. */
129 if (_grfconfig != nullptr) SlErrorCorrupt("The intro game must not use NewGRF");
130
131 /* Activate intro NewGRFs (townnames) */
132 ResetGRFConfig(false);
133 } else {
134 /* Append static NewGRF configuration */
136 }
137 }
138
139 void LoadCheck(size_t) const override
140 {
141 this->LoadCommon(_load_check_data.grfconfig);
142 }
143};
144
145static const NGRFChunkHandler NGRF;
146static const ChunkHandlerRef newgrf_chunk_handlers[] = {
147 NGRF,
148};
149
150extern const ChunkHandlerTable _newgrf_chunk_handlers(newgrf_chunk_handlers);
debug_inline constexpr bool HasBit(const T x, const uint8_t y)
Checks if a bit in a value is set.
void ResetMapping()
Resets the mapping, which is used while initializing game.
std::vector< EntityIDMapping > mappings
mapping of ids from grf files. Public out of convenience
LoadCheckData _load_check_data
Data loaded from save during SL_LOAD_CHECK.
Definition fios_gui.cpp:41
void ClearGRFConfigList(GRFConfig **config)
Clear a GRF Config list, freeing all nodes.
void AppendToGRFConfigList(GRFConfig **dst, GRFConfig *el)
Appends an element to a list of GRFs.
GRFConfig * _grfconfig
First item in list of current GRF set up.
void ResetGRFConfig(bool defaults)
Reset the current GRF Config to either blank or newgame settings.
void AppendStaticGRFConfigs(GRFConfig **dst)
Appends the static GRFs to a list of GRFs.
@ GCF_INIT_ONLY
GRF file is processed up to GLS_INIT.
@ GCF_STATIC
GRF file is used statically (can be used in any MP game)
static const SaveLoad _newgrf_mapping_desc[]
Save and load the mapping between a spec and the NewGRF it came from.
Definition newgrf_sl.cpp:21
Code handling saving and loading of NewGRF mappings.
Loading of newgrf chunks before table headers were added.
const SaveLoadCompat _grfconfig_sl_compat[]
Original field order for _newgrf_desc.
const SaveLoadCompat _newgrf_mapping_sl_compat[]
Original field order for _newgrf_mapping_desc.
std::vector< SaveLoad > SlCompatTableHeader(const SaveLoadTable &slt, const SaveLoadCompatTable &slct)
Load a table header in a savegame compatible way.
int SlIterateArray()
Iterate through the elements of an array and read the whole thing.
Definition saveload.cpp:659
void SlErrorCorrupt(const std::string &msg)
Error handler for corrupt savegames.
Definition saveload.cpp:351
void SlObject(void *object, const SaveLoadTable &slt)
Main SaveLoad function.
std::vector< SaveLoad > SlTableHeader(const SaveLoadTable &slt)
Save or Load a table header.
Functions/types related to saving and loading games.
std::reference_wrapper< const ChunkHandler > ChunkHandlerRef
A reference to ChunkHandler.
Definition saveload.h:509
std::span< const ChunkHandlerRef > ChunkHandlerTable
A table of ChunkHandler entries.
Definition saveload.h:512
#define SLE_ARR(base, variable, type, length)
Storage of fixed-size array of SL_VAR elements in every version of a savegame.
Definition saveload.h:1028
#define SLEG_VAR(name, variable, type)
Storage of a global variable in every savegame version.
Definition saveload.h:1186
#define SLEG_ARR(name, variable, type, length)
Storage of a global fixed-size array of SL_VAR elements in every savegame version.
Definition saveload.h:1203
#define SLE_CONDVAR(base, variable, type, from, to)
Storage of a variable in some savegame versions.
Definition saveload.h:868
bool IsSavegameVersionBefore(SaveLoadVersion major, uint8_t minor=0)
Checks whether the savegame is below major.
Definition saveload.h:1263
#define SLE_SSTR(base, variable, type)
Storage of a std::string in every savegame version.
Definition saveload.h:1046
@ SL_MAX_VERSION
Highest possible saveload version.
Definition saveload.h:399
@ SL_MIN_VERSION
First savegame version.
Definition saveload.h:31
@ SLV_151
151 20918
Definition saveload.h:224
@ SLV_101
101 14233
Definition saveload.h:164
@ SLV_EXTEND_ENTITY_MAPPING
311 PR#10672 Extend entity mapping range.
Definition saveload.h:353
#define SLE_VAR(base, variable, type)
Storage of a variable in every version of a savegame.
Definition saveload.h:1002
Handlers and description of chunk.
Definition saveload.h:463
Maps an entity id stored on the map to a GRF file.
Information about GRF, used in the game and (part of it) in savegames.
std::vector< uint32_t > param
GRF parameters.
struct GRFConfig * next
NOSAVE: Next item in the linked list.
void SetSuitablePalette()
Set the palette of this GRFConfig to something suitable.
GRFConfig * grfconfig
NewGrf configuration from save.
Definition fios.h:45
void LoadCheck(size_t) const override
Load the chunk for game preview.
void Save() const override
Save the chunk.
Definition newgrf_sl.cpp:88
void Load() const override
Load the chunk.
void Load() const override
Load a GRF ID + local id -> OpenTTD's id mapping.
Definition newgrf_sl.cpp:47
void Save() const override
Save a GRF ID + local id -> OpenTTD's id mapping.
Definition newgrf_sl.cpp:32
SaveLoad type struct.
Definition saveload.h:717