OpenTTD Source 20241224-master-gf74b0cf984
newgrf_airporttiles.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#include "debug.h"
12#include "newgrf_airporttiles.h"
13#include "newgrf_spritegroup.h"
14#include "newgrf_sound.h"
15#include "station_base.h"
16#include "water.h"
17#include "landscape.h"
18#include "company_base.h"
19#include "town.h"
20#include "table/strings.h"
21#include "table/airporttiles.h"
23
24#include "safeguards.h"
25
26extern uint32_t GetRelativePosition(TileIndex tile, TileIndex ind_tile);
27
28AirportTileSpec AirportTileSpec::tiles[NUM_AIRPORTTILES];
29
31
38{
39 /* should be assert(gfx < lengthof(tiles)), but that gives compiler warnings
40 * since it's always true if the following holds: */
41 static_assert(MAX_UVALUE(StationGfx) + 1 == lengthof(tiles));
42 return &AirportTileSpec::tiles[gfx];
43}
44
54
59{
60 auto insert = std::copy(std::begin(_origin_airporttile_specs), std::end(_origin_airporttile_specs), std::begin(AirportTileSpec::tiles));
61 std::fill(insert, std::end(AirportTileSpec::tiles), AirportTileSpec{});
62
63 /* Reset any overrides that have been set. */
64 _airporttile_mngr.ResetOverride();
65}
66
67void AirportTileOverrideManager::SetEntitySpec(const AirportTileSpec *airpts)
68{
69 StationGfx airpt_id = this->AddEntityID(airpts->grf_prop.local_id, airpts->grf_prop.grfid, airpts->grf_prop.subst_id);
70
71 if (airpt_id == this->invalid_id) {
72 GrfMsg(1, "AirportTile.SetEntitySpec: Too many airport tiles allocated. Ignoring.");
73 return;
74 }
75
76 AirportTileSpec::tiles[airpt_id] = *airpts;
77
78 /* Now add the overrides. */
79 for (int i = 0; i < this->max_offset; i++) {
80 AirportTileSpec *overridden_airpts = &AirportTileSpec::tiles[i];
81
82 if (this->entity_overrides[i] != airpts->grf_prop.local_id || this->grfid_overrides[i] != airpts->grf_prop.grfid) continue;
83
84 overridden_airpts->grf_prop.override = airpt_id;
85 overridden_airpts->enabled = false;
86 this->entity_overrides[i] = this->invalid_id;
87 this->grfid_overrides[i] = 0;
88 }
89}
90
101
110static uint32_t GetNearbyAirportTileInformation(uint8_t parameter, TileIndex tile, StationID index, bool grf_version8)
111{
112 if (parameter != 0) tile = GetNearbyTile(parameter, tile); // only perform if it is required
113 bool is_same_airport = (IsTileType(tile, MP_STATION) && IsAirport(tile) && GetStationIndex(tile) == index);
114
115 return GetNearbyTileInformation(tile, grf_version8) | (is_same_airport ? 1 : 0) << 8;
116}
117
118
127static uint32_t GetAirportTileIDAtOffset(TileIndex tile, const Station *st, uint32_t cur_grfid)
128{
129 if (!st->TileBelongsToAirport(tile)) {
130 return 0xFFFF;
131 }
132
133 StationGfx gfx = GetAirportGfx(tile);
134 const AirportTileSpec *ats = AirportTileSpec::Get(gfx);
135
136 if (gfx < NEW_AIRPORTTILE_OFFSET) { // Does it belongs to an old type?
137 /* It is an old tile. We have to see if it's been overridden */
138 if (ats->grf_prop.override == INVALID_AIRPORTTILE) { // has it been overridden?
139 return 0xFF << 8 | gfx; // no. Tag FF + the gfx id of that tile
140 }
141 /* Overridden */
143
144 if (tile_ovr->grf_prop.grfid == cur_grfid) {
145 return tile_ovr->grf_prop.local_id; // same grf file
146 } else {
147 return 0xFFFE; // not the same grf file
148 }
149 }
150 /* Not an 'old type' tile */
151 if (ats->grf_prop.spritegroup[0] != nullptr) { // tile has a spritegroup ?
152 if (ats->grf_prop.grfid == cur_grfid) { // same airport, same grf ?
153 return ats->grf_prop.local_id;
154 } else {
155 return 0xFFFE; // Defined in another grf file
156 }
157 }
158 /* The tile has no spritegroup */
159 return 0xFF << 8 | ats->grf_prop.subst_id; // so just give it the substitute
160}
161
162/* virtual */ uint32_t AirportTileScopeResolver::GetVariable(uint8_t variable, [[maybe_unused]] uint32_t parameter, bool &available) const
163{
164 assert(this->st != nullptr);
165
166 switch (variable) {
167 /* Terrain type */
168 case 0x41: return GetTerrainType(this->tile);
169
170 /* Current town zone of the tile in the nearest town */
171 case 0x42: return GetTownRadiusGroup(ClosestTownFromTile(this->tile, UINT_MAX), this->tile);
172
173 /* Position relative to most northern airport tile. */
174 case 0x43: return GetRelativePosition(this->tile, this->st->airport.tile);
175
176 /* Animation frame of tile */
177 case 0x44: return GetAnimationFrame(this->tile);
178
179 /* Land info of nearby tiles */
180 case 0x60: return GetNearbyAirportTileInformation(parameter, this->tile, this->st->index, this->ro.grffile->grf_version >= 8);
181
182 /* Animation stage of nearby tiles */
183 case 0x61: {
184 TileIndex tile = GetNearbyTile(parameter, this->tile);
185 if (this->st->TileBelongsToAirport(tile)) {
186 return GetAnimationFrame(tile);
187 }
188 return UINT_MAX;
189 }
190
191 /* Get airport tile ID at offset */
192 case 0x62: return GetAirportTileIDAtOffset(GetNearbyTile(parameter, this->tile), this->st, this->ro.grffile->grfid);
193 }
194
195 Debug(grf, 1, "Unhandled airport tile variable 0x{:X}", variable);
196
197 available = false;
198 return UINT_MAX;
199}
200
201/* virtual */ uint32_t AirportTileScopeResolver::GetRandomBits() const
202{
203 return (this->st == nullptr ? 0 : this->st->random_bits) | (this->tile == INVALID_TILE ? 0 : GetStationTileRandomBits(this->tile) << 16);
204}
205
216 CallbackID callback, uint32_t callback_param1, uint32_t callback_param2)
217 : ResolverObject(ats->grf_prop.grffile, callback, callback_param1, callback_param2),
218 tiles_scope(*this, ats, tile, st),
219 airport_scope(*this, tile, st, st != nullptr ? AirportSpec::Get(st->airport.type) : nullptr, st != nullptr ? st->airport.layout : 0)
220{
221 this->root_spritegroup = ats->grf_prop.spritegroup[0];
222}
223
225{
226 return GSF_AIRPORTTILES;
227}
228
230{
231 return this->tiles_scope.ats->grf_prop.local_id;
232}
233
234uint16_t GetAirportTileCallback(CallbackID callback, uint32_t param1, uint32_t param2, const AirportTileSpec *ats, Station *st, TileIndex tile, [[maybe_unused]] int extra_data = 0)
235{
236 AirportTileResolverObject object(ats, tile, st, callback, param1, param2);
237 return object.ResolveCallback();
238}
239
240static void AirportDrawTileLayout(const TileInfo *ti, const TileLayoutSpriteGroup *group, uint8_t colour)
241{
242 const DrawTileSprites *dts = group->ProcessRegisters(nullptr);
243
244 SpriteID image = dts->ground.sprite;
245 SpriteID pal = dts->ground.pal;
246
247 if (GB(image, 0, SPRITE_WIDTH) != 0) {
248 if (image == SPR_FLAT_WATER_TILE && IsTileOnWater(ti->tile)) {
249 DrawWaterClassGround(ti);
250 } else {
251 DrawGroundSprite(image, GroundSpritePaletteTransform(image, pal, GENERAL_SPRITE_COLOUR(colour)));
252 }
253 }
254
255 DrawNewGRFTileSeq(ti, dts, TO_BUILDINGS, 0, GENERAL_SPRITE_COLOUR(colour));
256}
257
258bool DrawNewAirportTile(TileInfo *ti, Station *st, const AirportTileSpec *airts)
259{
260 if (ti->tileh != SLOPE_FLAT) {
261 bool draw_old_one = true;
263 /* Called to determine the type (if any) of foundation to draw */
264 uint32_t callback_res = GetAirportTileCallback(CBID_AIRPTILE_DRAW_FOUNDATIONS, 0, 0, airts, st, ti->tile);
265 if (callback_res != CALLBACK_FAILED) draw_old_one = ConvertBooleanCallback(airts->grf_prop.grffile, CBID_AIRPTILE_DRAW_FOUNDATIONS, callback_res);
266 }
267
268 if (draw_old_one) DrawFoundation(ti, FOUNDATION_LEVELED);
269 }
270
271 AirportTileResolverObject object(airts, ti->tile, st);
272 const SpriteGroup *group = object.Resolve();
273 if (group == nullptr || group->type != SGT_TILELAYOUT) {
274 return false;
275 }
276
277 const TileLayoutSpriteGroup *tlgroup = (const TileLayoutSpriteGroup *)group;
278 AirportDrawTileLayout(ti, tlgroup, Company::Get(st->owner)->colour);
279 return true;
280}
281
283struct AirportTileAnimationBase : public AnimationBase<AirportTileAnimationBase, AirportTileSpec, Station, int, GetAirportTileCallback, TileAnimationFrameAnimationHelper<Station> > {
284 static const CallbackID cb_animation_speed = CBID_AIRPTILE_ANIMATION_SPEED;
285 static const CallbackID cb_animation_next_frame = CBID_AIRPTILE_ANIM_NEXT_FRAME;
286
287 static const AirportTileCallbackMask cbm_animation_speed = CBM_AIRT_ANIM_SPEED;
288 static const AirportTileCallbackMask cbm_animation_next_frame = CBM_AIRT_ANIM_NEXT_FRAME;
289};
290
291void AnimateAirportTile(TileIndex tile)
292{
294 if (ats == nullptr) return;
295
297}
298
299void AirportTileAnimationTrigger(Station *st, TileIndex tile, AirpAnimationTrigger trigger, CargoID cargo_type)
300{
302 if (!HasBit(ats->animation.triggers, trigger)) return;
303
304 AirportTileAnimationBase::ChangeAnimationFrame(CBID_AIRPTILE_ANIM_START_STOP, ats, st, tile, Random(), (uint8_t)trigger | (cargo_type << 8));
305}
306
307void AirportAnimationTrigger(Station *st, AirpAnimationTrigger trigger, CargoID cargo_type)
308{
309 if (st->airport.tile == INVALID_TILE) return;
310
311 for (TileIndex tile : st->airport) {
312 if (st->TileBelongsToAirport(tile)) AirportTileAnimationTrigger(st, tile, trigger, cargo_type);
313 }
314}
315
static const uint INVALID_AIRPORTTILE
id for an invalid airport tile
Definition airport.h:25
static const uint NEW_AIRPORTTILE_OFFSET
offset of first newgrf airport tile
Definition airport.h:24
static const uint NUM_AIRPORTTILES
Total number of airport tiles.
Definition airport.h:23
Tables with airporttile defaults.
static const AirportTileSpec _origin_airporttile_specs[]
All default airport tiles.
debug_inline constexpr bool HasBit(const T x, const uint8_t y)
Checks if a bit in a value is set.
debug_inline static constexpr uint GB(const T x, const uint8_t s, const uint8_t n)
Fetch n bits from x, started at bit s.
uint8_t CargoID
Cargo slots to indicate a cargo type within a game.
Definition cargo_type.h:22
uint16_t invalid_id
ID used to detected invalid entities.
void ResetOverride()
Resets the override, which is used while initializing game.
uint16_t max_offset
what is the length of the original entity's array of specs
virtual uint16_t AddEntityID(uint16_t grf_local_id, uint32_t grfid, uint16_t substitute_id)
Reserves a place in the mapping array for an entity to be installed.
Definition of stuff that is very close to a company, like the company struct itself.
Functions related to debugging.
#define Debug(category, level, format_string,...)
Ouptut a line of debugging information.
Definition debug.h:37
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition gfx_type.h:18
void DrawFoundation(TileInfo *ti, Foundation f)
Draw foundation f at tile ti.
Functions related to OTTD's landscape.
GrfSpecFeature
Definition newgrf.h:67
uint8_t StationGfx
Copy from station_map.h.
StationGfx GetTranslatedAirportTileID(StationGfx gfx)
Do airporttile gfx ID translation for NewGRFs.
uint32_t GetRelativePosition(TileIndex tile, TileIndex ind_tile)
This is the position of the tile relative to the northernmost tile of the industry.
static uint32_t GetAirportTileIDAtOffset(TileIndex tile, const Station *st, uint32_t cur_grfid)
Make an analysis of a tile and check whether it belongs to the same airport, and/or the same grf file...
static uint32_t GetNearbyAirportTileInformation(uint8_t parameter, TileIndex tile, StationID index, bool grf_version8)
Based on newhouses/newindustries equivalent, but adapted for airports.
NewGRF handling of airport tiles.
Function implementations related to NewGRF animation.
AirpAnimationTrigger
Animation triggers for airport tiles.
AirportTileCallbackMask
Callback masks for airport tiles.
@ CBM_AIRT_ANIM_SPEED
decides animation speed
@ CBM_AIRT_DRAW_FOUNDATIONS
decides if default foundations need to be drawn
@ CBM_AIRT_ANIM_NEXT_FRAME
decides next animation frame
CallbackID
List of implemented NewGRF callbacks.
@ CBID_AIRPTILE_DRAW_FOUNDATIONS
Called to determine the type (if any) of foundation to draw for an airport tile.
@ CBID_AIRPTILE_ANIM_START_STOP
Called for periodically starting or stopping the animation.
@ CBID_AIRPTILE_ANIMATION_SPEED
Called to indicate how long the current animation frame should last.
@ CBID_AIRPTILE_ANIM_NEXT_FRAME
Called to determine airport tile next animation frame.
static const uint CALLBACK_FAILED
Different values for Callback result evaluations.
uint32_t GetNearbyTileInformation(TileIndex tile, bool grf_version8)
Common part of station var 0x67, house var 0x62, indtile var 0x60, industry var 0x62.
bool ConvertBooleanCallback(const GRFFile *grffile, uint16_t cbid, uint16_t cb_res)
Converts a callback result into a boolean.
uint32_t GetTerrainType(TileIndex tile, TileContext context)
Function used by houses (and soon industries) to get information on type of "terrain" the tile it is ...
TileIndex GetNearbyTile(uint8_t parameter, TileIndex tile, bool signed_offsets, Axis axis)
Get the tile at the given offset.
Functions related to NewGRF provided sounds.
Action 2 handling.
A number of safeguards to prevent using unsafe methods.
@ SLOPE_FLAT
a flat tile
Definition slope_type.h:49
@ FOUNDATION_LEVELED
The tile is leveled up to a flat slope.
Definition slope_type.h:95
void DrawNewGRFTileSeq(const struct TileInfo *ti, const DrawTileSprites *dts, TransparencyOption to, uint32_t stage, PaletteID default_palette)
Draw NewGRF industrytile or house sprite layout.
Definition sprite.h:124
PaletteID GroundSpritePaletteTransform(SpriteID image, PaletteID pal, PaletteID default_pal)
Applies PALETTE_MODIFIER_COLOUR to a palette entry of a ground sprite.
Definition sprite.h:168
static constexpr uint8_t SPRITE_WIDTH
number of bits for the sprite number
Definition sprites.h:1535
Base classes/functions for stations.
bool IsAirport(Tile t)
Is this station tile an airport?
uint8_t GetStationTileRandomBits(Tile t)
Get the random bits of a station tile.
StationID GetStationIndex(Tile t)
Get StationID from a tile.
Definition station_map.h:28
StationGfx GetAirportGfx(Tile t)
Get the station graphics of this airport tile.
Definition of base types and functions in a cross-platform compatible way.
#define MAX_UVALUE(type)
The largest value that can be entered in a variable.
Definition stdafx.h:343
#define lengthof(array)
Return the length of an fixed size array.
Definition stdafx.h:280
Defines the data structure for an airport.
Helper class for animation control.
Resolver for tiles of an airport.
AirportTileScopeResolver tiles_scope
Scope resolver for the tiles.
GrfSpecFeature GetFeature() const override
Get the feature number being resolved for.
uint32_t GetDebugID() const override
Get an identifier for the item being resolved.
AirportTileResolverObject(const AirportTileSpec *ats, TileIndex tile, Station *st, CallbackID callback=CBID_NO_CALLBACK, uint32_t callback_param1=0, uint32_t callback_param2=0)
Constructor of the resolver for airport tiles.
struct Station * st
Station of the airport for which the callback is run, or nullptr for build gui.
uint32_t GetVariable(uint8_t variable, uint32_t parameter, bool &available) const override
Get a variable value.
TileIndex tile
Tile for the callback, only valid for airporttile callbacks.
uint32_t GetRandomBits() const override
Get a few random bits.
Defines the data structure of each individual tile of an airport.
bool enabled
entity still available (by default true). newgrf can disable it, though
static const AirportTileSpec * Get(StationGfx gfx)
Retrieve airport tile spec for the given airport tile.
AnimationInfo animation
Information about the animation.
static const AirportTileSpec * GetByTile(TileIndex tile)
Retrieve airport tile spec for the given airport tile.
GRFFileProps grf_prop
properties related the the grf file
static void ResetAirportTiles()
This function initializes the tile array of AirportTileSpec.
uint8_t animation_special_flags
Extra flags to influence the animation.
uint8_t callback_mask
Bitmask telling which grf callback is set.
Helper class for a unified approach to NewGRF animation.
static void AnimateTile(const AirportTileSpec *spec, Station *obj, TileIndex tile, bool random_animation, int extra_data=0)
Animate a single tile.
static void ChangeAnimationFrame(CallbackID cb, const AirportTileSpec *spec, Station *obj, TileIndex tile, uint32_t random_bits, uint32_t trigger, int extra_data=0)
Check a callback to determine what the next animation step is and execute that step.
uint16_t triggers
The triggers that trigger animation.
Owner owner
The owner of this station.
static BaseStation * GetByTile(TileIndex tile)
Get the base station belonging to a specific tile.
uint16_t random_bits
Random bits assigned to this station.
Ground palette sprite of a tile, together with its sprite layout.
Definition sprite.h:58
PalSpriteID ground
Palette and sprite for the ground.
Definition sprite.h:59
uint16_t local_id
id defined by the grf file for this entity
uint32_t grfid
grfid that introduced this entity.
const struct GRFFile * grffile
grf file that introduced this entity
std::array< const struct SpriteGroup *, Tcnt > spritegroup
pointers to the different sprites of the entity
uint16_t override
id of the entity been replaced by
TileIndex tile
The base tile of the area.
SpriteID sprite
The 'real' sprite.
Definition gfx_type.h:24
PaletteID pal
The palette (use PAL_NONE) if not needed)
Definition gfx_type.h:25
Tindex index
Index of this pool item.
static Titem * Get(size_t index)
Returns Titem with given index.
Interface for SpriteGroup-s to access the gamestate.
const GRFFile * grffile
GRFFile the resolved SpriteGroup belongs to.
const SpriteGroup * root_spritegroup
Root SpriteGroup to use for resolving.
ResolverObject & ro
Surrounding resolver object.
virtual const SpriteGroup * Resolve(ResolverObject &object) const
Base sprite group resolver.
Station data structure.
Airport airport
Tile area the airport covers.
Tile information, used while rendering the tile.
Definition tile_cmd.h:43
Slope tileh
Slope of the tile.
Definition tile_cmd.h:46
TileIndex tile
Tile index.
Definition tile_cmd.h:47
Action 2 sprite layout for houses, industry tiles, objects and airport tiles.
const DrawTileSprites * ProcessRegisters(uint8_t *stage) const
Process registers and the construction stage into the sprite layout.
uint8_t GetAnimationFrame(Tile t)
Get the current animation frame.
Definition tile_map.h:250
static debug_inline bool IsTileType(Tile tile, TileType type)
Checks if a tile is a given tiletype.
Definition tile_map.h:150
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
Definition tile_type.h:95
@ MP_STATION
A tile of a station.
Definition tile_type.h:53
Base of the town class.
HouseZonesBits GetTownRadiusGroup(const Town *t, TileIndex tile)
Returns the bit corresponding to the town zone of the specified tile.
Town * ClosestTownFromTile(TileIndex tile, uint threshold)
Return the town closest (in distance or ownership) to a given tile, within a given threshold.
@ TO_BUILDINGS
company buildings - depots, stations, HQ, ...
void DrawGroundSprite(SpriteID image, PaletteID pal, const SubSprite *sub, int extra_offs_x, int extra_offs_y)
Draws a ground sprite for the current tile.
Definition viewport.cpp:587
Functions related to water (management)
bool IsTileOnWater(Tile t)
Tests if the tile was built on water.
Definition water_map.h:136