OpenTTD Source  20241108-master-g80f628063a
newgrf.h
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 #ifndef NEWGRF_H
11 #define NEWGRF_H
12 
13 #include "cargotype.h"
14 #include "rail_type.h"
15 #include "road_type.h"
16 #include "fileio_type.h"
17 #include "newgrf_text_type.h"
18 #include "core/bitmath_func.hpp"
19 #include "core/alloc_type.hpp"
20 #include "core/mem_func.hpp"
21 
27  CF_WATERSLOPE,
28  CF_LOCKS,
29  CF_DIKES,
30  CF_ICON,
31  CF_DOCKS,
32  CF_RIVER_SLOPE,
33  CF_RIVER_EDGE,
34  CF_RIVER_GUI,
35  CF_BUOY,
36  CF_END,
37 };
38 
41  uint8_t callback_mask;
42  uint8_t flags;
43 };
44 
45 enum GrfLoadingStage {
46  GLS_FILESCAN,
47  GLS_SAFETYSCAN,
48  GLS_LABELSCAN,
49  GLS_INIT,
50  GLS_RESERVE,
51  GLS_ACTIVATION,
52  GLS_END,
53 };
54 
55 DECLARE_POSTFIX_INCREMENT(GrfLoadingStage)
56 
57 enum GrfMiscBit {
58  GMB_DESERT_TREES_FIELDS = 0, // Unsupported.
59  GMB_DESERT_PAVED_ROADS = 1,
60  GMB_FIELD_BOUNDING_BOX = 2, // Unsupported.
62  GMB_AMBIENT_SOUND_CALLBACK = 4,
63  GMB_CATENARY_ON_3RD_TRACK = 5, // Unsupported.
64  GMB_SECOND_ROCKY_TILE_SET = 6,
65 };
66 
68  GSF_TRAINS,
69  GSF_ROADVEHICLES,
70  GSF_SHIPS,
71  GSF_AIRCRAFT,
72  GSF_STATIONS,
73  GSF_CANALS,
74  GSF_BRIDGES,
75  GSF_HOUSES,
76  GSF_GLOBALVAR,
77  GSF_INDUSTRYTILES,
78  GSF_INDUSTRIES,
79  GSF_CARGOES,
80  GSF_SOUNDFX,
81  GSF_AIRPORTS,
82  GSF_SIGNALS,
83  GSF_OBJECTS,
84  GSF_RAILTYPES,
85  GSF_AIRPORTTILES,
86  GSF_ROADTYPES,
87  GSF_TRAMTYPES,
88  GSF_ROADSTOPS,
89  GSF_END,
90 
91  GSF_FAKE_TOWNS = GSF_END,
93 
94  GSF_INVALID = 0xFF,
95 };
96 
97 static const uint32_t INVALID_GRFID = 0xFFFFFFFF;
98 
99 struct GRFLabel {
100  uint8_t label;
101  uint32_t nfo_line;
102  size_t pos;
103 
104  GRFLabel(uint8_t label, uint32_t nfo_line, size_t pos) : label(label), nfo_line(nfo_line), pos(pos) {}
105 };
106 
109  std::string filename;
110  uint32_t grfid;
111  uint8_t grf_version;
112 
113  uint sound_offset;
114  uint16_t num_sounds;
115 
116  std::vector<std::unique_ptr<struct StationSpec>> stations;
117  std::vector<std::unique_ptr<struct HouseSpec>> housespec;
118  std::vector<std::unique_ptr<struct IndustrySpec>> industryspec;
119  std::vector<std::unique_ptr<struct IndustryTileSpec>> indtspec;
120  std::vector<std::unique_ptr<struct ObjectSpec>> objectspec;
121  std::vector<std::unique_ptr<struct AirportSpec>> airportspec;
122  std::vector<std::unique_ptr<struct AirportTileSpec>> airtspec;
123  std::vector<std::unique_ptr<struct RoadStopSpec>> roadstops;
124 
125  std::array<uint32_t, 0x80> param;
126  uint param_end;
127 
128  std::vector<GRFLabel> labels;
129 
130  std::vector<CargoLabel> cargo_list;
131  std::array<uint8_t, NUM_CARGO> cargo_map{};
132 
133  std::vector<RailTypeLabel> railtype_list;
134  RailType railtype_map[RAILTYPE_END];
135 
136  std::vector<RoadTypeLabel> roadtype_list;
137  RoadType roadtype_map[ROADTYPE_END];
138 
139  std::vector<RoadTypeLabel> tramtype_list;
140  RoadType tramtype_map[ROADTYPE_END];
141 
143 
144  std::unordered_map<uint8_t, LanguageMap> language_map;
145 
148 
149  uint32_t grf_features;
150  PriceMultipliers price_base_multipliers;
151 
152  GRFFile(const struct GRFConfig *config);
153 
155  uint32_t GetParam(uint number) const
156  {
157  /* Note: We implicitly test for number < this->param.size() and return 0 for invalid parameters.
158  * In fact this is the more important test, as param is zeroed anyway. */
159  assert(this->param_end <= this->param.size());
160  return (number < this->param_end) ? this->param[number] : 0;
161  }
162 };
163 
169 };
170 
175 };
176 
178  bool has_2CC;
179  uint64_t used_liveries;
182 };
183 
189 inline bool HasGrfMiscBit(GrfMiscBit bit)
190 {
191  extern uint8_t _misc_grf_features;
192  return HasBit(_misc_grf_features, bit);
193 }
194 
195 /* Indicates which are the newgrf features currently loaded ingame */
197 
198 void LoadNewGRFFile(struct GRFConfig *config, GrfLoadingStage stage, Subdirectory subdir, bool temporary);
199 void LoadNewGRF(SpriteID load_index, uint num_baseset);
200 void ReloadNewGRFData(); // in saveload/afterload.cpp
201 void ResetNewGRFData();
203 
204 void GrfMsgI(int severity, const std::string &msg);
205 #define GrfMsg(severity, format_string, ...) do { if ((severity) == 0 || _debug_grf_level >= (severity)) GrfMsgI(severity, fmt::format(FMT_STRING(format_string) __VA_OPT__(,) __VA_ARGS__)); } while (false)
206 
207 bool GetGlobalVariable(uint8_t param, uint32_t *value, const GRFFile *grffile);
208 
209 StringID MapGRFStringID(uint32_t grfid, StringID str);
210 void ShowNewGRFError();
211 
212 #endif /* NEWGRF_H */
Helper types related to the allocation of memory.
Functions related to bit mathematics.
constexpr debug_inline bool HasBit(const T x, const uint8_t y)
Checks if a bit in a value is set.
Types/functions related to cargoes.
Base class that provides memory initialization on dynamically created objects.
Definition: alloc_type.hpp:86
#define DECLARE_POSTFIX_INCREMENT(enum_type)
Some enums need to have allowed incrementing (i.e.
Definition: enum_type.hpp:18
Types for Standard In/Out file operations.
Subdirectory
The different kinds of subdirectories OpenTTD uses.
Definition: fileio_type.h:115
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition: gfx_type.h:18
Functions related to memory operations.
uint8_t _misc_grf_features
Miscellaneous GRF features, set by Action 0x0D, parameter 0x9E.
Definition: newgrf.cpp:78
bool GetGlobalVariable(uint8_t param, uint32_t *value, const GRFFile *grffile)
Reads a variable common to VarAction2 and Action7/9/D.
Definition: newgrf.cpp:6506
StringID MapGRFStringID(uint32_t grfid, StringID str)
Used when setting an object's property to map to the GRF's strings while taking in consideration the ...
Definition: newgrf.cpp:559
void ResetPersistentNewGRFData()
Reset NewGRF data which is stored persistently in savegames.
Definition: newgrf.cpp:8853
GrfSpecFeature
Definition: newgrf.h:67
@ GSF_FAKE_TOWNS
Fake town GrfSpecFeature for NewGRF debugging (parent scope)
Definition: newgrf.h:91
@ GSF_INVALID
An invalid spec feature.
Definition: newgrf.h:94
@ GSF_FAKE_END
End of the fake features.
Definition: newgrf.h:92
bool HasGrfMiscBit(GrfMiscBit bit)
Check for grf miscellaneous bits.
Definition: newgrf.h:189
void LoadNewGRFFile(struct GRFConfig *config, GrfLoadingStage stage, Subdirectory subdir, bool temporary)
Load a particular NewGRF.
Definition: newgrf.cpp:9694
GrfMiscBit
Definition: newgrf.h:57
@ GMB_TRAIN_WIDTH_32_PIXELS
Use 32 pixels per train vehicle in depot gui and vehicle details. Never set in the global variable;.
Definition: newgrf.h:61
GRFLoadedFeatures _loaded_newgrf_features
Indicates which are the newgrf features currently loaded ingame.
Definition: newgrf.cpp:84
void LoadNewGRF(SpriteID load_index, uint num_baseset)
Load all the NewGRFs.
Definition: newgrf.cpp:10017
void ResetNewGRFData()
Reset all NewGRF loaded data.
Definition: newgrf.cpp:8755
TramReplacement
Definition: newgrf.h:171
@ TRAMWAY_REPLACE_DEPOT_WITH_TRACK
Electrified depot graphics with tram track were loaded.
Definition: newgrf.h:173
@ TRAMWAY_REPLACE_DEPOT_NO_TRACK
Electrified depot graphics without tram track were loaded.
Definition: newgrf.h:174
@ TRAMWAY_REPLACE_DEPOT_NONE
No tram depot graphics were loaded.
Definition: newgrf.h:172
ShoreReplacement
Definition: newgrf.h:164
@ SHORE_REPLACE_ACTION_A
Shore sprites were replaced by ActionA (using grass tiles for the corner-shores).
Definition: newgrf.h:167
@ SHORE_REPLACE_NONE
No shore sprites were replaced.
Definition: newgrf.h:165
@ SHORE_REPLACE_ONLY_NEW
Only corner-shores were loaded by Action5 (openttd(w/d).grf only).
Definition: newgrf.h:168
@ SHORE_REPLACE_ACTION_5
Shore sprites were replaced by Action5.
Definition: newgrf.h:166
void GrfMsgI(int severity, const std::string &msg)
Debug() function dedicated to newGRF debugging messages Function is essentially the same as Debug(grf...
Definition: newgrf.cpp:389
CanalFeature
List of different canal 'features'.
Definition: newgrf.h:26
void ShowNewGRFError()
Show the first NewGRF error we can find.
Definition: newgrf_gui.cpp:45
void ReloadNewGRFData()
Reload all NewGRF files during a running game.
Definition: afterload.cpp:3364
Header of Action 04 "universal holder" structure.
The different types of rail.
RailType
Enumeration for all possible railtypes.
Definition: rail_type.h:27
@ RAILTYPE_END
Used for iterations.
Definition: rail_type.h:33
Enums and other types related to roads.
RoadType
The different roadtypes we support.
Definition: road_type.h:25
@ ROADTYPE_END
Used for iterations.
Definition: road_type.h:29
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
Definition: strings_type.h:16
Canal properties local to the NewGRF.
Definition: newgrf.h:40
uint8_t callback_mask
Bitmask of canal callbacks that have to be called.
Definition: newgrf.h:41
uint8_t flags
Flags controlling display.
Definition: newgrf.h:42
Information about GRF, used in the game and (part of it) in savegames.
Dynamic data of a loaded NewGRF.
Definition: newgrf.h:108
uint param_end
one more than the highest set parameter
Definition: newgrf.h:126
std::array< uint8_t, NUM_CARGO > cargo_map
Inverse cargo translation table (CargoID -> local ID)
Definition: newgrf.h:131
std::vector< RailTypeLabel > railtype_list
Railtype translation table.
Definition: newgrf.h:133
uint32_t GetParam(uint number) const
Get GRF Parameter with range checking.
Definition: newgrf.h:155
CanalProperties canal_local_properties[CF_END]
Canal properties as set by this NewGRF.
Definition: newgrf.h:142
std::vector< RoadTypeLabel > roadtype_list
Roadtype translation table (road)
Definition: newgrf.h:136
uint32_t grf_features
Bitset of GrfSpecFeature the grf uses.
Definition: newgrf.h:149
GRFFile(const struct GRFConfig *config)
Constructor for GRFFile.
Definition: newgrf.cpp:8902
std::vector< RoadTypeLabel > tramtype_list
Roadtype translation table (tram)
Definition: newgrf.h:139
std::vector< CargoLabel > cargo_list
Cargo translation table (local ID -> label)
Definition: newgrf.h:130
uint traininfo_vehicle_width
Width (in pixels) of a 8/8 train vehicle in depot GUI and vehicle details.
Definition: newgrf.h:147
int traininfo_vehicle_pitch
Vertical offset for drawing train images in depot GUI and vehicle details.
Definition: newgrf.h:146
std::unordered_map< uint8_t, LanguageMap > language_map
Mappings related to the languages.
Definition: newgrf.h:144
std::vector< GRFLabel > labels
List of labels.
Definition: newgrf.h:128
PriceMultipliers price_base_multipliers
Price base multipliers as set by the grf.
Definition: newgrf.h:150
bool has_2CC
Set if any vehicle is loaded which uses 2cc (two company colours).
Definition: newgrf.h:178
ShoreReplacement shore
In which way shore sprites were replaced.
Definition: newgrf.h:180
uint64_t used_liveries
Bitmask of LiveryScheme used by the defined engines.
Definition: newgrf.h:179
TramReplacement tram
In which way tram depots were replaced.
Definition: newgrf.h:181