OpenTTD Source 20260311-master-g511d3794ce
newgrf_airport.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 <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
6 */
7
9
10#include "stdafx.h"
11#include "debug.h"
13#include "newgrf_badge.h"
14#include "newgrf_spritegroup.h"
15#include "newgrf_text.h"
16#include "station_base.h"
17#include "town.h"
18
19#include "table/strings.h"
20
21#include "newgrf_class_func.h"
22
23#include "safeguards.h"
24
30template <>
32{
33 AirportClass::Get(AirportClass::Allocate('SMAL'))->name = STR_AIRPORT_CLASS_SMALL;
34 AirportClass::Get(AirportClass::Allocate('LARG'))->name = STR_AIRPORT_CLASS_LARGE;
35 AirportClass::Get(AirportClass::Allocate('HUB_'))->name = STR_AIRPORT_CLASS_HUB;
36 AirportClass::Get(AirportClass::Allocate('HELI'))->name = STR_AIRPORT_CLASS_HELIPORTS;
37}
38
39template <>
41{
42 return true;
43}
44
45/* Instantiate AirportClass. */
47
48
50
52
59/* static */ const AirportSpec *AirportSpec::Get(uint8_t type)
60{
61 assert(type < lengthof(AirportSpec::specs));
62 const AirportSpec *as = &AirportSpec::specs[type];
63 if (type >= NEW_AIRPORT_OFFSET && !as->enabled) {
64 if (_airport_mngr.GetGRFID(type) == 0) return as;
65 uint8_t subst_id = _airport_mngr.GetSubstituteID(type);
66 if (subst_id == AT_INVALID) return as;
67 as = &AirportSpec::specs[subst_id];
68 }
70 return as;
71}
72
80{
81 assert(type < lengthof(AirportSpec::specs));
82 return &AirportSpec::specs[type];
83}
84
90{
91 if (!this->enabled) return false;
93 if (_settings_game.station.never_expire_airports) return true;
94 return TimerGameCalendar::year <= this->max_year;
95}
96
103bool AirportSpec::IsWithinMapBounds(uint8_t table, TileIndex tile) const
104{
105 if (table >= this->layouts.size()) return false;
106
107 uint8_t w = this->size_x;
108 uint8_t h = this->size_y;
109 if (this->layouts[table].rotation == DIR_E || this->layouts[table].rotation == DIR_W) std::swap(w, h);
110
111 return TileX(tile) + w < Map::SizeX() &&
112 TileY(tile) + h < Map::SizeY();
113}
114
119{
121
122 auto insert = std::copy(std::begin(_origin_airport_specs), std::end(_origin_airport_specs), std::begin(AirportSpec::specs));
123 std::fill(insert, std::end(AirportSpec::specs), AirportSpec{});
124
125 _airport_mngr.ResetOverride();
126}
127
132{
133 for (int i = 0; i < NUM_AIRPORTS; i++) {
135 if (as->enabled) AirportClass::Assign(as);
136 }
137}
138
139
140void AirportOverrideManager::SetEntitySpec(AirportSpec &&as)
141{
142 uint8_t airport_id = this->AddEntityID(as.grf_prop.local_id, as.grf_prop.grfid, as.grf_prop.subst_id);
143
144 if (airport_id == this->invalid_id) {
145 GrfMsg(1, "Airport.SetEntitySpec: Too many airports allocated. Ignoring.");
146 return;
147 }
148
149 AirportSpec::specs[airport_id] = std::move(as);
150
151 /* Now add the overrides. */
152 for (int i = 0; i < this->max_offset; i++) {
153 AirportSpec *overridden_as = AirportSpec::GetWithoutOverride(i);
154
155 if (this->entity_overrides[i] != AirportSpec::specs[airport_id].grf_prop.local_id || this->grfid_overrides[i] != AirportSpec::specs[airport_id].grf_prop.grfid) continue;
156
157 overridden_as->grf_prop.override_id = airport_id;
158 overridden_as->enabled = false;
159 this->entity_overrides[i] = this->invalid_id;
160 this->grfid_overrides[i] = 0;
161 }
162}
163
164/* virtual */ uint32_t AirportScopeResolver::GetVariable(uint8_t variable, [[maybe_unused]] uint32_t parameter, bool &available) const
165{
166 switch (variable) {
167 case 0x40: return this->layout;
168
169 case 0x7A: return GetBadgeVariableResult(*this->ro.grffile, this->spec->badges, parameter);
170 }
171
172 if (this->st == nullptr) {
173 available = false;
174 return UINT_MAX;
175 }
176
177 switch (variable) {
178 /* Get a variable from the persistent storage */
179 case 0x7C: return (this->st->airport.psa != nullptr) ? this->st->airport.psa->GetValue(parameter) : 0;
180
181 case 0xF0: return this->st->facilities.base();
182 case 0xFA: return ClampTo<uint16_t>(this->st->build_date - CalendarTime::DAYS_TILL_ORIGINAL_BASE_YEAR);
183 }
184
185 return this->st->GetNewGRFVariable(this->ro, variable, parameter, available);
186}
187
189{
190 return GSF_AIRPORTS;
191}
192
194{
195 return this->airport_scope.spec->grf_prop.local_id;
196}
197
198/* virtual */ uint32_t AirportScopeResolver::GetRandomBits() const
199{
200 return this->st == nullptr ? 0 : this->st->random_bits;
201}
202
208/* virtual */ void AirportScopeResolver::StorePSA(uint pos, int32_t value)
209{
210 if (this->st == nullptr) return;
211
212 if (this->st->airport.psa == nullptr) {
213 /* There is no need to create a storage if the value is zero. */
214 if (value == 0) return;
215
216 /* Create storage on first modification. */
217 uint32_t grfid = (this->ro.grffile != nullptr) ? this->ro.grffile->grfid : 0;
219 this->st->airport.psa = PersistentStorage::Create(grfid, GSF_AIRPORTS, this->st->airport.tile);
220 }
221 this->st->airport.psa->StoreValue(pos, value);
222}
223
230{
231 if (!this->town_scope.has_value()) {
232 Town *t = nullptr;
233 if (this->airport_scope.st != nullptr) {
234 t = this->airport_scope.st->town;
235 } else if (this->airport_scope.tile != INVALID_TILE) {
236 t = ClosestTownFromTile(this->airport_scope.tile, UINT_MAX);
237 }
238 if (t == nullptr) return nullptr;
239 this->town_scope.emplace(*this, t, this->airport_scope.st == nullptr);
240 }
241 return &*this->town_scope;
242}
243
255 CallbackID callback, uint32_t param1, uint32_t param2)
256 : ResolverObject(spec->grf_prop.grffile, callback, param1, param2), airport_scope(*this, tile, st, spec, layout)
257{
258 this->root_spritegroup = spec->grf_prop.GetSpriteGroup(st != nullptr);
259}
260
261SpriteID GetCustomAirportSprite(const AirportSpec *as, uint8_t layout)
262{
263 AirportResolverObject object(INVALID_TILE, nullptr, as, layout);
264 const auto *group = object.Resolve<ResultSpriteGroup>();
265 if (group == nullptr || group->num_sprites == 0) return as->preview_sprite;
266
267 return group->sprite;
268}
269
270uint16_t GetAirportCallback(CallbackID callback, uint32_t param1, uint32_t param2, Station *st, TileIndex tile, std::span<int32_t> regs100)
271{
272 AirportResolverObject object(tile, st, AirportSpec::Get(st->airport.type), st->airport.layout, callback, param1, param2);
273 return object.ResolveCallback(regs100);
274}
275
283StringID GetAirportTextCallback(const AirportSpec *as, uint8_t layout, uint16_t callback)
284{
285 AirportResolverObject object(INVALID_TILE, nullptr, as, layout, (CallbackID)callback);
286 std::array<int32_t, 1> regs100;
287 uint16_t cb_res = object.ResolveCallback(regs100);
288 if (cb_res == CALLBACK_FAILED || cb_res == 0x400) return STR_UNDEFINED;
289 if (cb_res == 0x40F) {
290 return GetGRFStringID(as->grf_prop.grfid, static_cast<GRFStringID>(regs100[0]));
291 }
292 if (cb_res > 0x400) {
293 ErrorUnknownCallbackResult(as->grf_prop.grfid, callback, cb_res);
294 return STR_UNDEFINED;
295 }
296
298}
@ AT_INVALID
Invalid airport.
Definition airport.h:42
@ NUM_AIRPORTS
Maximal number of airports in total.
Definition airport.h:41
@ NEW_AIRPORT_OFFSET
Number of the first newgrf airport.
Definition airport.h:39
const AirportSpec _origin_airport_specs[]
The helidepot and helistation have ATP_TTDP_SMALL because they are at ground level.
Struct containing information relating to NewGRF classes for stations and airports.
static AirportClassID Allocate(uint32_t global_id)
static void Assign(AirportSpec *spec)
static NewGRFClass * Get(AirportClassID class_index)
StringID name
Name of this class.
uint16_t invalid_id
ID used to detected invalid entities.
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.
static Year year
Current year, starting at 0.
static constexpr TimerGame< struct Calendar >::Date DAYS_TILL_ORIGINAL_BASE_YEAR
Functions related to debugging.
@ DIR_W
West.
@ DIR_E
East.
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition gfx_type.h:17
static uint TileY(TileIndex tile)
Get the Y component of a tile.
Definition map_func.h:429
static uint TileX(TileIndex tile)
Get the X component of a tile.
Definition map_func.h:419
constexpr To ClampTo(From value)
Clamp the given value down to lie within the requested type.
GrfSpecFeature
Definition newgrf.h:71
void BindAirportSpecs()
Tie all airportspecs to their class.
StringID GetAirportTextCallback(const AirportSpec *as, uint8_t layout, uint16_t callback)
Get a custom text for the airport.
uint32_t GetBadgeVariableResult(const GRFFile &grffile, std::span< const BadgeID > badges, uint32_t parameter)
Test for a matching badge in a list of badges, returning the number of matching bits.
Functions related to NewGRF badges.
CallbackID
List of implemented NewGRF callbacks.
static const uint CALLBACK_FAILED
Different values for Callback result evaluations.
Implementation of the NewGRF class' functions.
void ErrorUnknownCallbackResult(uint32_t grfid, uint16_t cbid, uint16_t cb_res)
Record that a NewGRF returned an unknown/invalid callback result.
Action 2 handling.
StringID GetGRFStringID(uint32_t grfid, GRFStringID stringid)
Returns the index for this stringid associated with its grfID.
Header of Action 04 "universal holder" structure and functions.
StrongType::Typedef< uint32_t, struct GRFStringIDTag, StrongType::Compare, StrongType::Integer > GRFStringID
Type for GRF-internal string IDs.
static constexpr GRFStringID GRFSTR_MISC_GRF_TEXT
Miscellaneous GRF text range.
A number of safeguards to prevent using unsafe methods.
GameSettings _settings_game
Game settings of a running game or the scenario editor.
Definition settings.cpp:61
Base classes/functions for stations.
Definition of base types and functions in a cross-platform compatible way.
#define lengthof(array)
Return the length of an fixed size array.
Definition stdafx.h:271
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
Resolver object for airports.
GrfSpecFeature GetFeature() const override
Get the feature number being resolved for.
AirportResolverObject(TileIndex tile, Station *st, const AirportSpec *spec, uint8_t layout, CallbackID callback=CBID_NO_CALLBACK, uint32_t callback_param1=0, uint32_t callback_param2=0)
Constructor of the airport resolver.
TownScopeResolver * GetTown()
Get the town scope associated with a station, if it exists.
uint32_t GetDebugID() const override
Get an identifier for the item being resolved.
std::optional< TownScopeResolver > town_scope
The town scope resolver (created on the first call).
uint32_t GetRandomBits() const override
Get a few random bits.
uint8_t layout
Layout of the airport to build.
void StorePSA(uint pos, int32_t value) override
Store a value into the object's persistent storage.
uint32_t GetVariable(uint8_t variable, uint32_t parameter, bool &available) const override
Get a variable value.
struct Station * st
Station of the airport for which the callback is run, or nullptr for build gui.
Defines the data structure for an airport.
SubstituteGRFFileProps grf_prop
Properties related to the grf file.
SpriteID preview_sprite
preview sprite for this airport
TimerGameCalendar::Year min_year
first year the airport is available
static void ResetAirports()
This function initializes the airportspec array.
std::vector< AirportTileLayout > layouts
List of layouts composing the airport.
static AirportSpec specs[NUM_AIRPORTS]
Specs of the airports.
bool IsWithinMapBounds(uint8_t table, TileIndex index) const
Check if the airport would be within the map bounds at the given tile.
static AirportSpec * GetWithoutOverride(uint8_t type)
Retrieve airport spec for the given airport.
TimerGameCalendar::Year max_year
last year the airport is available
bool enabled
Entity still available (by default true). Newgrf can disable it, though.
uint8_t size_y
size of airport in y direction
uint8_t size_x
size of airport in x direction
static const AirportSpec * Get(uint8_t type)
Retrieve airport spec for the given airport.
bool IsAvailable() const
Check whether this airport is available to build.
uint8_t type
Type of this airport,.
uint8_t layout
Airport layout number.
uint32_t grfid
grfid that introduced this entity.
static uint SizeX()
Get the size of the map along the X.
Definition map_func.h:262
static uint SizeY()
Get the size of the map along the Y.
Definition map_func.h:271
const GRFFile * grffile
GRFFile the resolved SpriteGroup belongs to.
ResolverObject(const GRFFile *grffile, CallbackID callback=CBID_NO_CALLBACK, uint32_t callback_param1=0, uint32_t callback_param2=0)
Resolver constructor.
CallbackID callback
Callback being resolved.
const SpriteGroup * root_spritegroup
Root SpriteGroup to use for resolving.
A result sprite group returns the first SpriteID and the number of sprites in the set.
ResolverObject & ro
Surrounding resolver object.
const struct SpriteGroup * GetSpriteGroup(bool entity_exists) const
Get the standard sprite group.
Station data structure.
Airport airport
Tile area the airport covers.
uint16_t override_id
The id of the entity been replaced by.
Scope resolver for a town.
Definition newgrf_town.h:22
Town data structure.
Definition town.h:63
StrongType::Typedef< uint32_t, struct TileIndexTag, StrongType::Compare, StrongType::Integer, StrongType::Compatible< int32_t >, StrongType::Compatible< int64_t > > TileIndex
The index/ID of a Tile.
Definition tile_type.h:92
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
Definition tile_type.h:100
Definition of the game-calendar-timer.
Base of the town class.
Town * ClosestTownFromTile(TileIndex tile, uint threshold)
Return the town closest (in distance or ownership) to a given tile, within a given threshold.