Files @ r25958:603d75b53498
Branch filter:

Location: cpp/openttd-patchpack/source/src/newgrf_airport.cpp - annotation

Patric Stout
Doc: update multiplayer documentation with latest changes (#9552)

Although several places were fixed during the PR making the change,
not all made it in this document.

While at it, removed all kinds of Markdown warnings by an excessive
usage of spacebar in this document.
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r15534:64974155b7a6
r14618:a194334b4a3a
r14618:a194334b4a3a
r15688:5bb1558218af
r14618:a194334b4a3a
r15688:5bb1558218af
r15688:5bb1558218af
r15688:5bb1558218af
r15730:99440cf75a72
r14618:a194334b4a3a
r21383:942c32fb8b0e
r21383:942c32fb8b0e
r19738:837a139219f0
r19732:0e2e01cf2be7
r23607:36c15679007d
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r22756:8ffd1846f871
r22756:8ffd1846f871
r22756:8ffd1846f871
r22756:8ffd1846f871
r23607:36c15679007d
r22756:8ffd1846f871
r22756:8ffd1846f871
r22756:8ffd1846f871
r22756:8ffd1846f871
r22756:8ffd1846f871
r22756:8ffd1846f871
r22756:8ffd1846f871
r19732:0e2e01cf2be7
r23497:a0ab44ebd2fa
r23497:a0ab44ebd2fa
r23497:a0ab44ebd2fa
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r23497:a0ab44ebd2fa
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19737:d7c69e3b4bd4
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r24069:49625df81342
r24069:49625df81342
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r15730:99440cf75a72
r15730:99440cf75a72
r15730:99440cf75a72
r15730:99440cf75a72
r15730:99440cf75a72
r15730:99440cf75a72
r15730:99440cf75a72
r15730:99440cf75a72
r19259:e556e5a2d55f
r19259:e556e5a2d55f
r19259:e556e5a2d55f
r19259:e556e5a2d55f
r15730:99440cf75a72
r15730:99440cf75a72
r19266:a55aa4bf5bd3
r19266:a55aa4bf5bd3
r19266:a55aa4bf5bd3
r19266:a55aa4bf5bd3
r19266:a55aa4bf5bd3
r19266:a55aa4bf5bd3
r15730:99440cf75a72
r15730:99440cf75a72
r14727:9ddd9a15dd3b
r14851:b3915c863ff3
r14851:b3915c863ff3
r16362:9d8d927a8276
r14725:026b6e13b803
r14618:a194334b4a3a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14725:026b6e13b803
r14851:b3915c863ff3
r14851:b3915c863ff3
r23567:b1a6d3e60ba8
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14618:a194334b4a3a
r14618:a194334b4a3a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r14726:e42b5d6d3c6a
r16362:9d8d927a8276
r14618:a194334b4a3a
r14618:a194334b4a3a
r14729:e9e99770f7ff
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14618:a194334b4a3a
r14725:026b6e13b803
r14725:026b6e13b803
r23570:fd1a0734432c
r23838:bfeaabaa7b1d
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r23570:fd1a0734432c
r17674:8ba1e586d6d1
r14725:026b6e13b803
r14725:026b6e13b803
r14725:026b6e13b803
r14725:026b6e13b803
r14725:026b6e13b803
r14850:537311950e1a
r14851:b3915c863ff3
r14851:b3915c863ff3
r14725:026b6e13b803
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r15730:99440cf75a72
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14727:9ddd9a15dd3b
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r14851:b3915c863ff3
r19732:0e2e01cf2be7
r15688:5bb1558218af
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r15688:5bb1558218af
r15688:5bb1558218af
r23607:36c15679007d
r15688:5bb1558218af
r15688:5bb1558218af
r15688:5bb1558218af
r15688:5bb1558218af
r15688:5bb1558218af
r15698:7bcb15e75458
r23607:36c15679007d
r15698:7bcb15e75458
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r15688:5bb1558218af
r15688:5bb1558218af
r19732:0e2e01cf2be7
r15688:5bb1558218af
r15688:5bb1558218af
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r24069:49625df81342
r19732:0e2e01cf2be7
r15688:5bb1558218af
r23607:36c15679007d
r15688:5bb1558218af
r15688:5bb1558218af
r17768:a8b4e13e2113
r17768:a8b4e13e2113
r17768:a8b4e13e2113
r17768:a8b4e13e2113
r17768:a8b4e13e2113
r19732:0e2e01cf2be7
r17768:a8b4e13e2113
r23607:36c15679007d
r17772:ce3cc7016cdc
r23607:36c15679007d
r17772:ce3cc7016cdc
r17772:ce3cc7016cdc
r17772:ce3cc7016cdc
r17772:ce3cc7016cdc
r23607:36c15679007d
r17772:ce3cc7016cdc
r21091:6d0d361e1c1e
r17772:ce3cc7016cdc
r19732:0e2e01cf2be7
r17768:a8b4e13e2113
r17768:a8b4e13e2113
r19738:837a139219f0
r19738:837a139219f0
r19738:837a139219f0
r23607:36c15679007d
r19738:837a139219f0
r19738:837a139219f0
r19738:837a139219f0
r19738:837a139219f0
r19738:837a139219f0
r19738:837a139219f0
r19732:0e2e01cf2be7
r19732:0e2e01cf2be7
r21008:be2e3d3c935b
r15688:5bb1558218af
r21299:8973364c4b52
r19732:0e2e01cf2be7
r15688:5bb1558218af
r15693:10940496c385
r15693:10940496c385
r23607:36c15679007d
r21299:8973364c4b52
r23607:36c15679007d
r15693:10940496c385
r15693:10940496c385
r15693:10940496c385
r15693:10940496c385
r15688:5bb1558218af
r15688:5bb1558218af
r19732:0e2e01cf2be7
r21299:8973364c4b52
r15688:5bb1558218af
r15695:b17629bb1837
r17629:21e9dfd343cd
r17629:21e9dfd343cd
r17629:21e9dfd343cd
r17629:21e9dfd343cd
r17629:21e9dfd343cd
r17629:21e9dfd343cd
r17629:21e9dfd343cd
r15695:b17629bb1837
r15695:b17629bb1837
r23607:36c15679007d
r21299:8973364c4b52
r18296:89d34cbdf3a3
r18296:89d34cbdf3a3
r18296:89d34cbdf3a3
r18296:89d34cbdf3a3
r18296:89d34cbdf3a3
r15695:b17629bb1837
r18296:89d34cbdf3a3
r15695:b17629bb1837
/*
 * This file is part of OpenTTD.
 * 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.
 * 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.
 * 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/>.
 */

/** @file newgrf_airport.cpp NewGRF handling of airports. */

#include "stdafx.h"
#include "debug.h"
#include "date_func.h"
#include "newgrf_spritegroup.h"
#include "newgrf_text.h"
#include "station_base.h"
#include "newgrf_class_func.h"

#include "safeguards.h"

/** Resolver for the airport scope. */
struct AirportScopeResolver : public ScopeResolver {
	struct Station *st; ///< Station of the airport for which the callback is run, or \c nullptr for build gui.
	byte airport_id;    ///< Type of airport for which the callback is run.
	byte layout;        ///< Layout of the airport to build.
	TileIndex tile;     ///< Tile for the callback, only valid for airporttile callbacks.

	/**
	 * Constructor of the scope resolver for an airport.
	 * @param ro Surrounding resolver.
	 * @param tile %Tile for the callback, only valid for airporttile callbacks.
	 * @param st %Station of the airport for which the callback is run, or \c nullptr for build gui.
	 * @param airport_id Type of airport for which the callback is run.
	 * @param layout Layout of the airport to build.
	 */
	AirportScopeResolver(ResolverObject &ro, TileIndex tile, Station *st, byte airport_id, byte layout)
			: ScopeResolver(ro), st(st), airport_id(airport_id), layout(layout), tile(tile)
	{
	}

	uint32 GetRandomBits() const override;
	uint32 GetVariable(byte variable, uint32 parameter, bool *available) const override;
	void StorePSA(uint pos, int32 value) override;
};

/** Resolver object for airports. */
struct AirportResolverObject : public ResolverObject {
	AirportScopeResolver airport_scope;

	AirportResolverObject(TileIndex tile, Station *st, byte airport_id, byte layout,
			CallbackID callback = CBID_NO_CALLBACK, uint32 callback_param1 = 0, uint32 callback_param2 = 0);

	ScopeResolver *GetScope(VarSpriteGroupScope scope = VSG_SCOPE_SELF, byte relative = 0) override
	{
		switch (scope) {
			case VSG_SCOPE_SELF: return &this->airport_scope;
			default: return ResolverObject::GetScope(scope, relative);
		}
	}

	GrfSpecFeature GetFeature() const override;
	uint32 GetDebugID() const override;
};

/**
 * Reset airport classes to their default state.
 * This includes initialising the defaults classes with an empty
 * entry, for standard airports.
 */
template <typename Tspec, typename Tid, Tid Tmax>
/* static */ void NewGRFClass<Tspec, Tid, Tmax>::InsertDefaults()
{
	AirportClass::Get(AirportClass::Allocate('SMAL'))->name = STR_AIRPORT_CLASS_SMALL;
	AirportClass::Get(AirportClass::Allocate('LARG'))->name = STR_AIRPORT_CLASS_LARGE;
	AirportClass::Get(AirportClass::Allocate('HUB_'))->name = STR_AIRPORT_CLASS_HUB;
	AirportClass::Get(AirportClass::Allocate('HELI'))->name = STR_AIRPORT_CLASS_HELIPORTS;
}

template <typename Tspec, typename Tid, Tid Tmax>
bool NewGRFClass<Tspec, Tid, Tmax>::IsUIAvailable(uint index) const
{
	return true;
}

INSTANTIATE_NEWGRF_CLASS_METHODS(AirportClass, AirportSpec, AirportClassID, APC_MAX)


AirportOverrideManager _airport_mngr(NEW_AIRPORT_OFFSET, NUM_AIRPORTS, AT_INVALID);

AirportSpec AirportSpec::specs[NUM_AIRPORTS]; ///< Airport specifications.

/**
 * Retrieve airport spec for the given airport. If an override is available
 *  it is returned.
 * @param type index of airport
 * @return A pointer to the corresponding AirportSpec
 */
/* static */ const AirportSpec *AirportSpec::Get(byte type)
{
	assert(type < lengthof(AirportSpec::specs));
	const AirportSpec *as = &AirportSpec::specs[type];
	if (type >= NEW_AIRPORT_OFFSET && !as->enabled) {
		if (_airport_mngr.GetGRFID(type) == 0) return as;
		byte subst_id = _airport_mngr.GetSubstituteID(type);
		if (subst_id == AT_INVALID) return as;
		as = &AirportSpec::specs[subst_id];
	}
	if (as->grf_prop.override != AT_INVALID) return &AirportSpec::specs[as->grf_prop.override];
	return as;
}

/**
 * Retrieve airport spec for the given airport. Even if an override is
 *  available the base spec is returned.
 * @param type index of airport
 * @return A pointer to the corresponding AirportSpec
 */
/* static */ AirportSpec *AirportSpec::GetWithoutOverride(byte type)
{
	assert(type < lengthof(AirportSpec::specs));
	return &AirportSpec::specs[type];
}

/** Check whether this airport is available to build. */
bool AirportSpec::IsAvailable() const
{
	if (!this->enabled) return false;
	if (_cur_year < this->min_year) return false;
	if (_settings_game.station.never_expire_airports) return true;
	return _cur_year <= this->max_year;
}

/**
 * Check if the airport would be within the map bounds at the given tile.
 * @param table Selected layout table. This affects airport rotation, and therefore dimensions.
 * @param tile Top corner of the airport.
 * @return true iff the airport would be within the map bounds at the given tile.
 */
bool AirportSpec::IsWithinMapBounds(byte table, TileIndex tile) const
{
	if (table >= this->num_table) return false;

	byte w = this->size_x;
	byte h = this->size_y;
	if (this->rotation[table] == DIR_E || this->rotation[table] == DIR_W) Swap(w, h);

	return TileX(tile) + w < MapSizeX() &&
		TileY(tile) + h < MapSizeY();
}

/**
 * This function initializes the airportspec array.
 */
void AirportSpec::ResetAirports()
{
	extern const AirportSpec _origin_airport_specs[];
	memset(&AirportSpec::specs, 0, sizeof(AirportSpec::specs));
	memcpy(&AirportSpec::specs, &_origin_airport_specs, sizeof(AirportSpec) * NEW_AIRPORT_OFFSET);

	_airport_mngr.ResetOverride();
}

/**
 * Tie all airportspecs to their class.
 */
void BindAirportSpecs()
{
	for (int i = 0; i < NUM_AIRPORTS; i++) {
		AirportSpec *as = AirportSpec::GetWithoutOverride(i);
		if (as->enabled) AirportClass::Assign(as);
	}
}


void AirportOverrideManager::SetEntitySpec(AirportSpec *as)
{
	byte airport_id = this->AddEntityID(as->grf_prop.local_id, as->grf_prop.grffile->grfid, as->grf_prop.subst_id);

	if (airport_id == invalid_ID) {
		grfmsg(1, "Airport.SetEntitySpec: Too many airports allocated. Ignoring.");
		return;
	}

	memcpy(AirportSpec::GetWithoutOverride(airport_id), as, sizeof(*as));

	/* Now add the overrides. */
	for (int i = 0; i < max_offset; i++) {
		AirportSpec *overridden_as = AirportSpec::GetWithoutOverride(i);

		if (entity_overrides[i] != as->grf_prop.local_id || grfid_overrides[i] != as->grf_prop.grffile->grfid) continue;

		overridden_as->grf_prop.override = airport_id;
		overridden_as->enabled = false;
		entity_overrides[i] = invalid_ID;
		grfid_overrides[i] = 0;
	}
}

/* virtual */ uint32 AirportScopeResolver::GetVariable(byte variable, uint32 parameter, bool *available) const
{
	switch (variable) {
		case 0x40: return this->layout;
	}

	if (this->st == nullptr) {
		*available = false;
		return UINT_MAX;
	}

	switch (variable) {
		/* Get a variable from the persistent storage */
		case 0x7C: return (this->st->airport.psa != nullptr) ? this->st->airport.psa->GetValue(parameter) : 0;

		case 0xF0: return this->st->facilities;
		case 0xFA: return Clamp(this->st->build_date - DAYS_TILL_ORIGINAL_BASE_YEAR, 0, 65535);
	}

	return this->st->GetNewGRFVariable(this->ro, variable, parameter, available);
}

GrfSpecFeature AirportResolverObject::GetFeature() const
{
	return GSF_AIRPORTS;
}

uint32 AirportResolverObject::GetDebugID() const
{
	return AirportSpec::Get(this->airport_scope.airport_id)->grf_prop.local_id;
}

/* virtual */ uint32 AirportScopeResolver::GetRandomBits() const
{
	return this->st == nullptr ? 0 : this->st->random_bits;
}

/**
 * Store a value into the object's persistent storage.
 * @param pos Position in the persistent storage to use.
 * @param value Value to store.
 */
/* virtual */ void AirportScopeResolver::StorePSA(uint pos, int32 value)
{
	if (this->st == nullptr) return;

	if (this->st->airport.psa == nullptr) {
		/* There is no need to create a storage if the value is zero. */
		if (value == 0) return;

		/* Create storage on first modification. */
		uint32 grfid = (this->ro.grffile != nullptr) ? this->ro.grffile->grfid : 0;
		assert(PersistentStorage::CanAllocateItem());
		this->st->airport.psa = new PersistentStorage(grfid, GSF_AIRPORTS, this->st->airport.tile);
	}
	this->st->airport.psa->StoreValue(pos, value);
}

/**
 * Constructor of the airport resolver.
 * @param tile %Tile for the callback, only valid for airporttile callbacks.
 * @param st %Station of the airport for which the callback is run, or \c nullptr for build gui.
 * @param airport_id Type of airport for which the callback is run.
 * @param layout Layout of the airport to build.
 * @param callback Callback ID.
 * @param param1 First parameter (var 10) of the callback.
 * @param param2 Second parameter (var 18) of the callback.
 */
AirportResolverObject::AirportResolverObject(TileIndex tile, Station *st, byte airport_id, byte layout,
		CallbackID callback, uint32 param1, uint32 param2)
	: ResolverObject(AirportSpec::Get(airport_id)->grf_prop.grffile, callback, param1, param2), airport_scope(*this, tile, st, airport_id, layout)
{
	this->root_spritegroup = AirportSpec::Get(airport_id)->grf_prop.spritegroup[0];
}

SpriteID GetCustomAirportSprite(const AirportSpec *as, byte layout)
{
	AirportResolverObject object(INVALID_TILE, nullptr, as->GetIndex(), layout);
	const SpriteGroup *group = object.Resolve();
	if (group == nullptr) return as->preview_sprite;

	return group->GetResult();
}

uint16 GetAirportCallback(CallbackID callback, uint32 param1, uint32 param2, Station *st, TileIndex tile)
{
	AirportResolverObject object(tile, st, st->airport.type, st->airport.layout, callback, param1, param2);
	return object.ResolveCallback();
}

/**
 * Get a custom text for the airport.
 * @param as The airport type's specification.
 * @param layout The layout index.
 * @param callback The callback to call.
 * @return The custom text.
 */
StringID GetAirportTextCallback(const AirportSpec *as, byte layout, uint16 callback)
{
	AirportResolverObject object(INVALID_TILE, nullptr, as->GetIndex(), layout, (CallbackID)callback);
	uint16 cb_res = object.ResolveCallback();
	if (cb_res == CALLBACK_FAILED || cb_res == 0x400) return STR_UNDEFINED;
	if (cb_res > 0x400) {
		ErrorUnknownCallbackResult(as->grf_prop.grffile->grfid, callback, cb_res);
		return STR_UNDEFINED;
	}

	return GetGRFStringID(as->grf_prop.grffile->grfid, 0xD000 + cb_res);
}