OpenTTD
newgrf_commons.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 
13 #ifndef NEWGRF_COMMONS_H
14 #define NEWGRF_COMMONS_H
15 
16 #include "sprite.h"
17 #include "core/alloc_type.hpp"
18 #include "core/smallvec_type.hpp"
19 #include "command_type.h"
20 #include "direction_type.h"
21 #include "company_type.h"
22 
28 };
29 
34  TLF_NOTHING = 0x00,
35 
36  TLF_DODRAW = 0x01,
37  TLF_SPRITE = 0x02,
38  TLF_PALETTE = 0x04,
40 
42  TLF_BB_Z_OFFSET = 0x20,
43 
46 
49 
50  TLF_KNOWN_FLAGS = 0xFF,
51 
54 
57 
60 
63 
66 };
68 
69 
75 static inline uint GetConstructionStageOffset(uint construction_stage, uint num_sprites)
76 {
77  assert(num_sprites > 0);
78  if (num_sprites > 4) num_sprites = 4;
79  switch (construction_stage) {
80  case 0: return 0;
81  case 1: return num_sprites > 2 ? 1 : 0;
82  case 2: return num_sprites > 2 ? num_sprites - 2 : 0;
83  case 3: return num_sprites - 1;
84  default: NOT_REACHED();
85  }
86 }
87 
93  uint8 dodraw;
94  uint8 sprite;
95  uint8 palette;
98  union {
99  uint8 parent[3];
100  uint8 child[2];
101  } delta;
102  uint8 sprite_var10;
104 };
105 
106 static const uint TLR_MAX_VAR10 = 7;
107 
114  const TileLayoutRegisters *registers;
115 
121 
122  void Allocate(uint num_sprites);
123  void AllocateRegisters();
124  void Clone(const DrawTileSeqStruct *source);
125  void Clone(const NewGRFSpriteLayout *source);
126 
131  void Clone(const DrawTileSprites *source)
132  {
133  assert(source != nullptr && this != source);
134  this->ground = source->ground;
135  this->Clone(source->seq);
136  }
137 
138  virtual ~NewGRFSpriteLayout()
139  {
140  free(this->seq);
141  free(this->registers);
142  }
143 
150  bool NeedsPreprocessing() const
151  {
152  return this->registers != nullptr;
153  }
154 
155  uint32 PrepareLayout(uint32 orig_offset, uint32 newgrf_ground_offset, uint32 newgrf_offset, uint constr_stage, bool separate_ground) const;
156  void ProcessRegisters(uint8 resolved_var10, uint32 resolved_sprite, bool separate_ground) const;
157 
164  {
165  DrawTileSeqStruct *front = result_seq.data();
166  *ground = front->image;
167  return front + 1;
168  }
169 
170 private:
171  static std::vector<DrawTileSeqStruct> result_seq;
172 };
173 
187  uint32 grfid;
188  uint8 entity_id;
190 };
191 
193 protected:
194  uint16 *entity_overrides;
195  uint32 *grfid_overrides;
196 
197  uint16 max_offset;
199 
200  uint16 invalid_ID;
201  virtual bool CheckValidNewID(uint16 testid) { return true; }
202 
203 public:
205 
206  OverrideManagerBase(uint16 offset, uint16 maximum, uint16 invalid);
207  virtual ~OverrideManagerBase();
208 
209  void ResetOverride();
210  void ResetMapping();
211 
212  void Add(uint8 local_id, uint32 grfid, uint entity_type);
213  virtual uint16 AddEntityID(byte grf_local_id, uint32 grfid, byte substitute_id);
214 
215  uint32 GetGRFID(uint16 entity_id) const;
216  uint16 GetSubstituteID(uint16 entity_id) const;
217  virtual uint16 GetID(uint8 grf_local_id, uint32 grfid) const;
218 
219  inline uint16 GetMaxMapping() const { return max_new_entities; }
220  inline uint16 GetMaxOffset() const { return max_offset; }
221 };
222 
223 
224 struct HouseSpec;
226 public:
227  HouseOverrideManager(uint16 offset, uint16 maximum, uint16 invalid) :
228  OverrideManagerBase(offset, maximum, invalid) {}
229 
230  void SetEntitySpec(const HouseSpec *hs);
231 };
232 
233 
234 struct IndustrySpec;
236 public:
237  IndustryOverrideManager(uint16 offset, uint16 maximum, uint16 invalid) :
238  OverrideManagerBase(offset, maximum, invalid) {}
239 
240  uint16 AddEntityID(byte grf_local_id, uint32 grfid, byte substitute_id) override;
241  uint16 GetID(uint8 grf_local_id, uint32 grfid) const override;
242 
243  void SetEntitySpec(IndustrySpec *inds);
244 };
245 
246 
247 struct IndustryTileSpec;
249 protected:
250  virtual bool CheckValidNewID(uint16 testid) { return testid != 0xFF; }
251 public:
252  IndustryTileOverrideManager(uint16 offset, uint16 maximum, uint16 invalid) :
253  OverrideManagerBase(offset, maximum, invalid) {}
254 
255  void SetEntitySpec(const IndustryTileSpec *indts);
256 };
257 
258 struct AirportSpec;
260 public:
261  AirportOverrideManager(uint16 offset, uint16 maximum, uint16 invalid) :
262  OverrideManagerBase(offset, maximum, invalid) {}
263 
264  void SetEntitySpec(AirportSpec *inds);
265 };
266 
267 struct AirportTileSpec;
269 protected:
270  virtual bool CheckValidNewID(uint16 testid) { return testid != 0xFF; }
271 public:
272  AirportTileOverrideManager(uint16 offset, uint16 maximum, uint16 invalid) :
273  OverrideManagerBase(offset, maximum, invalid) {}
274 
275  void SetEntitySpec(const AirportTileSpec *ats);
276 };
277 
278 struct ObjectSpec;
280 protected:
281  virtual bool CheckValidNewID(uint16 testid) { return testid != 0xFF; }
282 public:
283  ObjectOverrideManager(uint16 offset, uint16 maximum, uint16 invalid) :
284  OverrideManagerBase(offset, maximum, invalid) {}
285 
286  void SetEntitySpec(ObjectSpec *spec);
287 };
288 
289 extern HouseOverrideManager _house_mngr;
290 extern IndustryOverrideManager _industry_mngr;
291 extern IndustryTileOverrideManager _industile_mngr;
292 extern AirportOverrideManager _airport_mngr;
293 extern AirportTileOverrideManager _airporttile_mngr;
295 
296 uint32 GetTerrainType(TileIndex tile, TileContext context = TCX_NORMAL);
297 TileIndex GetNearbyTile(byte parameter, TileIndex tile, bool signed_offsets = true, Axis axis = INVALID_AXIS);
298 uint32 GetNearbyTileInformation(TileIndex tile, bool grf_version8);
299 uint32 GetCompanyInfo(CompanyID owner, const struct Livery *l = nullptr);
300 CommandCost GetErrorMessageFromLocationCallbackResult(uint16 cb_res, const GRFFile *grffile, StringID default_error);
301 
302 void ErrorUnknownCallbackResult(uint32 grfid, uint16 cbid, uint16 cb_res);
303 bool ConvertBooleanCallback(const struct GRFFile *grffile, uint16 cbid, uint16 cb_res);
304 bool Convert8bitBooleanCallback(const struct GRFFile *grffile, uint16 cbid, uint16 cb_res);
305 
310 template <size_t Tcnt>
312  GRFFilePropsBase() : local_id(0), grffile(0)
313  {
314  /* The lack of some compilers to provide default constructors complying to the specs
315  * requires us to zero the stuff ourself. */
316  memset(spritegroup, 0, sizeof(spritegroup));
317  }
318 
319  uint16 local_id;
320  const struct GRFFile *grffile;
321  const struct SpriteGroup *spritegroup[Tcnt];
322 };
323 
327  GRFFileProps(uint16 subst_id = 0) :
328  GRFFilePropsBase<1>(), subst_id(subst_id), override(subst_id)
329  {
330  }
331 
332  uint16 subst_id;
333  uint16 override;
334 };
335 
336 #endif /* NEWGRF_COMMONS_H */
Owner
Enum for all companies/owners.
Definition: company_type.h:18
DECLARE_ENUM_AS_BIT_SET(GenderEthnicity) enum CompanyManagerFaceVariable
Bitgroups of the CompanyManagerFace variable.
Different types to &#39;show&#39; directions.
Add signed offset to child sprite Y positions from register TileLayoutRegisters::delta.child[1].
uint16 invalid_ID
ID used to detected invalid entities;.
Simple vector class that allows allocating an item without the need to copy this->data needlessly...
TileLayoutFlags
Flags to enable register usage in sprite layouts.
uint32 GetTerrainType(TileIndex tile, TileContext context=TCX_NORMAL)
Function used by houses (and soon industries) to get information on type of "terrain" the tile it is ...
Add signed offset to bounding box X and Y positions from register TileLayoutRegisters::delta.parent[0..1].
uint16 max_palette_offset
Maximum offset to add to the palette. (limited by size of the spriteset)
Resolve sprite with a specific value in variable 10.
Flags which require resolving the action-1-2-3 chain for the sprite, even if it is no action-1 sprite...
Combination of a palette sprite and a &#39;real&#39; sprite.
Definition: gfx_type.h:22
Add signed offset to palette from register TileLayoutRegisters::palette.
Flags which do not work for the (first) ground sprite.
Add signed offset to sprite from register TileLayoutRegisters::sprite.
Allow incrementing of ObjectClassID variables.
Definition: newgrf_object.h:58
const DrawTileSeqStruct * GetLayout(PalSpriteID *ground) const
Returns the result spritelayout after preprocessing.
Nothing special.
Helper types related to the allocation of memory.
Common return value for all commands.
Definition: command_type.h:23
Types related to commands.
const DrawTileSeqStruct * seq
Array of child sprites. Terminated with a terminator entry.
Definition: sprite.h:60
uint32 grfid
The GRF ID of the file the entity belongs to.
Only draw sprite if value of register TileLayoutRegisters::dodraw is non-zero.
Querying information about stuff on the bridge (via some bridgehead).
uint8 palette_var10
Value for variable 10 when resolving the palette.
uint16 max_new_entities
what is the amount of entities, old and new summed
Querying information about the upper part of a tile with halftile foundation.
uint16 max_sprite_offset
Maximum offset to add to the sprite. (limited by size of the spriteset)
Ground palette sprite of a tile, together with its sprite layout.
Definition: sprite.h:58
uint8 substitute_id
The (original) entity ID to use if this GRF is not available.
uint consistent_max_offset
Number of sprites in all referenced spritesets.
Maps an entity id stored on the map to a GRF file.
Data related to the handling of grf files.
bool ConvertBooleanCallback(const GRFFile *grffile, uint16 cbid, uint16 cb_res)
Converts a callback result into a boolean.
TileIndex GetNearbyTile(byte parameter, TileIndex tile, bool signed_offsets=true, Axis axis=INVALID_AXIS)
Get the tile at the given offset.
Information about a particular livery.
Definition: livery.h:78
uint8 sprite_var10
Value for variable 10 when resolving the sprite.
Defines the data structure for constructing industry.
Definition: industrytype.h:106
uint8 sprite
Register specifying a signed offset for the sprite.
Add signed offset to bounding box Z positions from register TileLayoutRegisters::delta.parent[2].
Flags which are still required after loading the GRF.
NewGRF supplied spritelayout.
Base class that provides memory initialization on dynamically created objects.
Definition: alloc_type.hpp:85
bool Convert8bitBooleanCallback(const GRFFile *grffile, uint16 cbid, uint16 cb_res)
Converts a callback result into a boolean.
uint32 StringID
Numeric value that represents a string, independent of the selected language.
Definition: strings_type.h:16
Flags which require resolving the action-1-2-3 chain for the palette, even if it is no action-1 palet...
Known flags. Any unknown set flag will disable the GRF.
uint8 entity_id
The entity ID within the GRF file.
Resolve palette with a specific value in variable 10.
GRFFileProps(uint16 subst_id=0)
Set all default data constructor for the props.
Additional modifiers for items in sprite layouts.
EntityIDMapping * mapping_ID
mapping of ids from grf files. Public out of convenience
PalSpriteID ground
Palette and sprite for the ground.
Definition: sprite.h:59
uint8 child[2]
Registers for signed offsets for the position of child sprites.
void ErrorUnknownCallbackResult(uint32 grfid, uint16 cbid, uint16 cb_res)
Record that a NewGRF returned an unknown/invalid callback result.
bool NeedsPreprocessing() const
Tests whether this spritelayout needs preprocessing by PrepareLayout() and ProcessRegisters(), or whether it can be used directly.
uint32 TileIndex
The index/ID of a Tile.
Definition: tile_type.h:78
Add signed offset to child sprite X positions from register TileLayoutRegisters::delta.child[0].
uint32 GetCompanyInfo(CompanyID owner, const Livery *l)
Returns company information like in vehicle var 43 or station var 43.
Data related to the handling of grf files.
Base for drawing complex sprites.
Defines the data structure of each individual tile of an airport.
uint16 local_id
id defined by the grf file for this entity
Types related to companies.
static const uint TLR_MAX_VAR10
Maximum value for var 10.
static void free(const void *ptr)
Version of the standard free that accepts const pointers.
Definition: depend.cpp:129
const struct GRFFile * grffile
grf file that introduced this entity
static uint GetConstructionStageOffset(uint construction_stage, uint num_sprites)
Determines which sprite to use from a spriteset for a specific construction stage.
Defines the data structure of each individual tile of an industry.
Definition: industrytype.h:155
CommandCost GetErrorMessageFromLocationCallbackResult(uint16 cb_res, const GRFFile *grffile, StringID default_error)
Get the error message from a shape/location/slope check callback result.
Defines the data structure for an airport.
uint16 max_offset
what is the length of the original entity&#39;s array of specs
Flag for an invalid Axis.
uint8 parent[3]
Registers for signed offsets for the bounding box position of parent sprites.
uint32 GetNearbyTileInformation(TileIndex tile, bool grf_version8)
Common part of station var 0x67, house var 0x62, indtile var 0x60, industry var 0x62.
uint8 dodraw
Register deciding whether the sprite shall be drawn at all. Non-zero means drawing.
A tile child sprite and palette to draw for stations etc, with 3D bounding box.
Definition: sprite.h:25
Palette is from Action 1 (moved to SPRITE_MODIFIER_CUSTOM_SPRITE in palette during loading)...
void Clone(const DrawTileSprites *source)
Clone a spritelayout.
Axis
Allow incrementing of DiagDirDiff variables.
static std::vector< DrawTileSeqStruct > result_seq
Temporary storage when preprocessing spritelayouts.
ObjectOverrideManager _object_mngr
The override manager for our objects.
uint8 palette
Register specifying a signed offset for the palette.
TileLayoutFlags flags
Flags defining which members are valid and to be used.
Dynamic data of a loaded NewGRF.
Definition: newgrf.h:105
Flags which refer to using multiple action-1-2-3 chains.
TileContext
Context for tile accesses.