Class defining several overloaded accessors so we don't have to cast base stations that often. More...

#include <base_station_base.h>

Inheritance diagram for SpecializedStation< T, Tis_waypoint >:

Public Member Functions
	SpecializedStation (TileIndex tile)
	Set station type correctly.

Public Member Functions inherited from BaseStation
	BaseStation (TileIndex tile)
	Initialize the base station.

virtual bool	TileBelongsToRailStation (TileIndex tile) const =0
	Check whether a specific tile belongs to this station.

virtual uint32_t	GetNewGRFVariable (const struct ResolverObject &object, uint8_t variable, uint8_t parameter, bool &available) const =0
	Helper function to get a NewGRF variable that isn't implemented by the base class.

virtual void	UpdateVirtCoord ()=0
	Update the coordinated of the sign (as shown in the viewport).

const std::string &	GetCachedName () const

virtual void	MoveSign (TileIndex new_xy)

virtual void	GetTileArea (TileArea *ta, StationType type) const =0
	Get the tile area for a given station type.

virtual uint	GetPlatformLength (TileIndex tile) const =0
	Obtain the length of a platform.

virtual uint	GetPlatformLength (TileIndex tile, DiagDirection dir) const =0
	Determines the REMAINING length of a platform, starting at (and including) the given tile.

bool	IsInUse () const
	Check whether the base station currently is in use; in use means that it is not scheduled for deletion and that it still has some facilities left.

uint8_t	GetRoadStopRandomBits (TileIndex tile) const

uint8_t	GetRoadStopAnimationFrame (TileIndex tile) const

void	SetRoadStopRandomBits (TileIndex tile, uint8_t random_bits)

bool	SetRoadStopAnimationFrame (TileIndex tile, uint8_t frame)

void	RemoveRoadStopTileData (TileIndex tile)

Public Member Functions inherited from Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >
void *	operator new (size_t size)
	Allocates space for new Titem.

void *	operator new (size_t size, Tindex index)
	Allocates space for new Titem with given index.

void *	operator new (size_t, void *ptr)
	Allocates space for new Titem at given memory address.

void	operator delete (void *p, size_t size)
	Marks Titem as free.

Static Public Member Functions
static bool	IsExpected (const BaseStation *st)
	Helper for checking whether the given station is of this type.

static bool	IsValidID (auto index)
	Tests whether given index is a valid index for station of this type.

static T *	Get (auto index)
	Gets station with given index.

static T *	GetIfValid (auto index)
	Returns station if the index is a valid index for this station type.

static T *	GetByTile (TileIndex tile)
	Get the station belonging to a specific tile.

static T *	From (BaseStation *st)
	Converts a BaseStation to SpecializedStation with type checking.

static const T *	From (const BaseStation *st)
	Converts a const BaseStation to const SpecializedStation with type checking.

static Pool::IterateWrapper< T >	Iterate (size_t from=0)
	Returns an iterable ensemble of all valid stations of type T.

Static Public Member Functions inherited from BaseStation
static BaseStation *	GetByTile (TileIndex tile)
	Get the base station belonging to a specific tile.

static void	PostDestructor (size_t index)
	Invalidating of the JoinStation window has to be done after removing item from the pool.

Static Public Member Functions inherited from Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >
static bool	CanAllocateItem (size_t n=1)
	Helper functions so we can use PoolItem::Function() instead of _poolitem_pool.Function()

static bool	CleaningPool ()
	Returns current state of pool cleaning - yes or no.

static bool	IsValidID (auto index)
	Tests whether given index can be used to get valid (non-nullptr) Titem.

static Titem *	Get (auto index)
	Returns Titem with given index.

static Titem *	GetIfValid (auto index)
	Returns Titem with given index.

static size_t	GetPoolSize ()
	Returns first unused index.

static size_t	GetNumItems ()
	Returns number of valid items in the pool.

static void	PostDestructor (size_t index)
	Dummy function called after destructor of each member.

static Pool::IterateWrapper< Titem >	Iterate (size_t from=0)
	Returns an iterable ensemble of all valid Titem.

Static Public Attributes
static constexpr StationFacilities	EXPECTED_FACIL = Tis_waypoint ? StationFacility::Waypoint : StationFacilities{}
	Specialized type.

Additional Inherited Members
Public Types inherited from Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >
typedef struct Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >	Pool
	Type of the pool this item is going to be part of.

Data Fields inherited from BaseStation
TileIndex	xy = INVALID_TILE
	Base tile of the station.

TrackedViewportSign	sign {}
	NOSAVE: Dimensions of sign.

uint8_t	delete_ctr = 0
	Delete counter. If greater than 0 then it is decremented until it reaches 0; the waypoint is then is deleted.

std::string	name {}
	Custom name.

StringID	string_id = INVALID_STRING_ID
	Default name (town area) of station.

std::string	cached_name
	NOSAVE: Cache of the resolved name of the station, if not using a custom name.

Town *	town = nullptr
	The town this station is associated with.

Owner	owner = INVALID_OWNER
	The owner of this station.

StationFacilities	facilities {}
	The facilities that this station has.

std::vector< SpecMapping< StationSpec > >	speclist {}
	List of rail station specs of this station.

std::vector< SpecMapping< RoadStopSpec > >	roadstop_speclist {}
	List of road stop specs of this station.

TimerGameCalendar::Date	build_date {}
	Date of construction.

uint16_t	random_bits = 0
	Random bits assigned to this station.

StationRandomTriggers	waiting_random_triggers
	Waiting triggers (NewGRF), shared by all station parts/tiles, road stops, ... essentially useless and broken by design.

StationAnimationTriggers	cached_anim_triggers
	NOSAVE: Combined animation trigger bitmask, used to determine if trigger processing should happen.

StationAnimationTriggers	cached_roadstop_anim_triggers
	NOSAVE: Combined animation trigger bitmask for road stops, used to determine if trigger processing should happen.

CargoTypes	cached_cargo_triggers {}
	NOSAVE: Combined cargo trigger bitmask.

CargoTypes	cached_roadstop_cargo_triggers {}
	NOSAVE: Combined cargo trigger bitmask for road stops.

TileArea	train_station {INVALID_TILE, 0, 0}
	Tile area the train 'station' part covers.

StationRect	rect {}
	NOSAVE: Station spread out rectangle maintained by StationRect::xxx() functions.

std::vector< RoadStopTileData >	custom_roadstop_tile_data {}
	List of custom road stop tile data.

Data Fields inherited from Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >
Tindex	index
	Index of this pool item.

Detailed Description

template<class T, bool Tis_waypoint>
struct SpecializedStation< T, Tis_waypoint >

Class defining several overloaded accessors so we don't have to cast base stations that often.

Definition at line 212 of file base_station_base.h.

Constructor & Destructor Documentation

◆ SpecializedStation()

template<class T , bool Tis_waypoint>

SpecializedStation< T, Tis_waypoint >::SpecializedStation ( TileIndex tile )

inline

Set station type correctly.

Parameters

tile	The base tile of the station.

Definition at line 219 of file base_station_base.h.

References SpecializedStation< T, Tis_waypoint >::EXPECTED_FACIL, and BaseStation::facilities.

Member Function Documentation

◆ From() [1/2]

template<class T , bool Tis_waypoint>

static T * SpecializedStation< T, Tis_waypoint >::From ( BaseStation * st )

inlinestatic

Converts a BaseStation to SpecializedStation with type checking.

Parameters

st	BaseStation pointer

Returns: pointer to SpecializedStation

Definition at line 278 of file base_station_base.h.

References SpecializedStation< T, Tis_waypoint >::IsExpected().

◆ From() [2/2]

template<class T , bool Tis_waypoint>

static const T * SpecializedStation< T, Tis_waypoint >::From ( const BaseStation * st )

inlinestatic

Converts a const BaseStation to const SpecializedStation with type checking.

Parameters

st	BaseStation pointer

Returns: pointer to SpecializedStation

Definition at line 289 of file base_station_base.h.

References SpecializedStation< T, Tis_waypoint >::IsExpected().

◆ Get()

template<class T , bool Tis_waypoint>

static T * SpecializedStation< T, Tis_waypoint >::Get ( auto index )

inlinestatic

Gets station with given index.

Returns: pointer to station with given index casted to T *

Definition at line 249 of file base_station_base.h.

References Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >::Get(), and Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >::index.

Referenced by SpecializedStation< T, Tis_waypoint >::GetIfValid().

◆ GetByTile()

template<class T , bool Tis_waypoint>

static T * SpecializedStation< T, Tis_waypoint >::GetByTile ( TileIndex tile )

inlinestatic

Get the station belonging to a specific tile.

Parameters

tile	The tile to get the station from.

Returns: the station associated with that tile.

Definition at line 268 of file base_station_base.h.

References SpecializedStation< T, Tis_waypoint >::GetIfValid(), and GetStationIndex().

◆ GetIfValid()

template<class T , bool Tis_waypoint>

static T * SpecializedStation< T, Tis_waypoint >::GetIfValid ( auto index )

inlinestatic

Returns station if the index is a valid index for this station type.

Returns: pointer to station with given index if it's a station of this type

Definition at line 258 of file base_station_base.h.

References SpecializedStation< T, Tis_waypoint >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >::index, and SpecializedStation< T, Tis_waypoint >::IsValidID().

Referenced by SpecializedStation< T, Tis_waypoint >::GetByTile().

◆ IsExpected()

template<class T , bool Tis_waypoint>

static bool SpecializedStation< T, Tis_waypoint >::IsExpected ( const BaseStation * st )

inlinestatic

Helper for checking whether the given station is of this type.

Parameters

st	the station to check.

Returns: true if the station is the type we expect it to be.

Definition at line 230 of file base_station_base.h.

References BaseStation::facilities, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), and Waypoint.

Referenced by SpecializedStation< T, Tis_waypoint >::From(), SpecializedStation< T, Tis_waypoint >::From(), and SpecializedStation< T, Tis_waypoint >::IsValidID().

◆ IsValidID()

template<class T , bool Tis_waypoint>

static bool SpecializedStation< T, Tis_waypoint >::IsValidID ( auto index )

inlinestatic

Tests whether given index is a valid index for station of this type.

Parameters

index tested index

Returns: is this index valid index of T?

Definition at line 240 of file base_station_base.h.

References Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >::index, SpecializedStation< T, Tis_waypoint >::IsExpected(), and Pool< Titem, Tindex, Tgrowth_step, Tpool_type, Tcache >::PoolItem<&_station_pool >::IsValidID().

Referenced by SpecializedStation< T, Tis_waypoint >::GetIfValid().

◆ Iterate()

template<class T , bool Tis_waypoint>

static Pool::IterateWrapper< T > SpecializedStation< T, Tis_waypoint >::Iterate ( size_t from = 0 )

inlinestatic

Returns an iterable ensemble of all valid stations of type T.

Parameters

from	index of the first station to consider

Returns: an iterable ensemble of all valid stations of type T

Definition at line 300 of file base_station_base.h.

Field Documentation

◆ EXPECTED_FACIL

template<class T , bool Tis_waypoint>

constexpr StationFacilities SpecializedStation< T, Tis_waypoint >::EXPECTED_FACIL = Tis_waypoint ? StationFacility::Waypoint : StationFacilities{}

staticconstexpr

Specialized type.

Definition at line 213 of file base_station_base.h.

Referenced by SpecializedStation< T, Tis_waypoint >::SpecializedStation().

The documentation for this struct was generated from the following file:

src/base_station_base.h

Public Member Functions

Static Public Member Functions

Static Public Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SpecializedStation()

Member Function Documentation

◆ From() [1/2]

◆ From() [2/2]

◆ Get()

◆ GetByTile()

◆ GetIfValid()

◆ IsExpected()

◆ IsValidID()

◆ Iterate()

Field Documentation

◆ EXPECTED_FACIL