Functions related to stations. More...

#include "sprite.h"
#include "rail_type.h"
#include "road_type.h"
#include "vehicle_type.h"
#include "economy_func.h"
#include "rail.h"
#include "road.h"
#include "linkgraph/linkgraph_type.h"
#include "industry_type.h"

Functions
void	ModifyStationRatingAround (TileIndex tile, Owner owner, int amount, uint radius)
	Forcibly modify station ratings near a given tile.
void	ShowStationViewWindow (StationID station)
	Opens StationViewWindow for given station.
void	UpdateAllStationVirtCoords ()
	Update the virtual coords needed to draw the station sign for all stations.
void	ClearAllStationCachedNames ()
CargoArray	GetProductionAroundTiles (TileIndex tile, int w, int h, int rad)
	Get the cargo types being produced around the tile (in a rectangle).
CargoArray	GetAcceptanceAroundTiles (TileIndex tile, int w, int h, int rad, CargoTypes *always_accepted=nullptr)
	Get the acceptance of cargoes around the tile in 1/8.
void	UpdateStationAcceptance (Station *st, bool show_msg)
	Update the acceptance for a station.
CargoTypes	GetAcceptanceMask (const Station *st)
	Get a mask of the cargo types that the station accepts.
CargoTypes	GetEmptyMask (const Station *st)
	Get a mask of the cargo types that are empty at the station.
void	SetRailStationTileFlags (TileIndex tile, const StationSpec *statspec)
	Set rail station tile flags for the given tile.
const DrawTileSprites *	GetStationTileLayout (StationType st, uint8_t gfx)
	Get station tile layout for a station type and its station gfx.
void	StationPickerDrawSprite (int x, int y, StationType st, RailType railtype, RoadType roadtype, int image)
bool	HasStationInUse (StationID station, bool include_company, CompanyID company)
	Tests whether the company's vehicles have this station in orders.
void	DeleteOilRig (TileIndex t)
void	UpdateStationDockingTiles (Station *st)
void	RemoveDockingTile (TileIndex t)
void	ClearDockingTilesCheckingNeighbours (TileIndex tile)
	Clear docking tile status from tiles around a removed dock, if the tile has no neighbours which would keep it as a docking tile.
void	UpdateAirportsNoise ()
	Recalculate the noise generated by the airports of each town.
bool	SplitGroundSpriteForOverlay (const TileInfo ti, SpriteID ground, RailTrackOffset *overlay_offset)
	Check whether a sprite is a track sprite, which can be replaced by a non-track ground sprite and a rail overlay.
void	IncreaseStats (Station st, const Vehicle v, StationID next_station_id, uint32_t time)
	Increase capacity for all link stats associated with vehicles in the given consist.
void	IncreaseStats (Station *st, CargoType cargo, StationID next_station_id, uint capacity, uint usage, uint32_t time, EdgeUpdateModes modes)
	Increase capacity for a link stat given by station cargo and next hop.
void	RerouteCargo (Station *st, CargoType cargo, StationID avoid, StationID avoid2)
	Reroute cargo of type c at station st or in any vehicles unloading there.
Money	StationMaintenanceCost (uint32_t num)
	Calculates the maintenance cost of a number of station tiles.
Money	AirportMaintenanceCost (Owner owner)
	Calculates the maintenance cost of all airports of a company.

Detailed Description

Functions related to stations.

Definition in file station_func.h.

Function Documentation

◆ AirportMaintenanceCost()

Money AirportMaintenanceCost ( Owner owner )

Calculates the maintenance cost of all airports of a company.

Parameters

owner Company.

Returns: Total cost.

Definition at line 713 of file station.cpp.

References Airport, BaseStation::facilities, InfrastructureAirport, SpecializedStation< Station, false >::Iterate(), BaseStation::owner, and BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test().

Referenced by CompaniesGenStatistics().

◆ ClearAllStationCachedNames()

void ClearAllStationCachedNames ( )

Definition at line 477 of file station_cmd.cpp.

◆ ClearDockingTilesCheckingNeighbours()

void ClearDockingTilesCheckingNeighbours ( TileIndex tile )

Clear docking tile status from tiles around a removed dock, if the tile has no neighbours which would keep it as a docking tile.

Parameters

tile	Ex-dock tile to check.

Definition at line 3004 of file station_cmd.cpp.

References CheckForDockingTile(), DIAGDIR_BEGIN, DIAGDIR_END, IsValidTile(), SetDockingTile(), and TileOffsByDiagDir().

Referenced by RemoveDock().

◆ DeleteOilRig()

void DeleteOilRig ( TileIndex t )

Definition at line 4764 of file station_cmd.cpp.

◆ GetAcceptanceAroundTiles()

CargoArray GetAcceptanceAroundTiles	(	TileIndex	center_tile,
		int	w,
		int	h,
		int	rad,
		CargoTypes *	always_accepted )

Get the acceptance of cargoes around the tile in 1/8.

Parameters

center_tile	Center of the search area
w	X extent of area
h	Y extent of area
rad	Search radius in addition to given area
always_accepted	bitmask of cargo accepted by houses and headquarters; can be nullptr

Definition at line 570 of file station_cmd.cpp.

References _settings_game, OrthogonalTileArea::Expand(), Industry::GetByTile(), Industry, and IsTileType().

Referenced by DrawStationCoverageAreaText().

◆ GetAcceptanceMask()

CargoTypes GetAcceptanceMask ( const Station * st )

Get a mask of the cargo types that the station accepts.

Parameters

st	Station to query

Returns: the expected mask

Definition at line 489 of file station_cmd.cpp.

References GoodsEntry::Acceptance, Station::goods, and SetBit().

Referenced by StationViewWindow::DrawAcceptedCargo(), and UpdateStationAcceptance().

◆ GetEmptyMask()

CargoTypes GetEmptyMask ( const Station * st )

Get a mask of the cargo types that are empty at the station.

Parameters

st	Station to query

Returns: the empty mask

Definition at line 504 of file station_cmd.cpp.

References Station::goods, and SetBit().

Referenced by TriggerRoadStopRandomisation(), and TriggerStationRandomisation().

◆ GetProductionAroundTiles()

CargoArray GetProductionAroundTiles	(	TileIndex	north_tile,
		int	w,
		int	h,
		int	rad )

Get the cargo types being produced around the tile (in a rectangle).

Parameters

north_tile	Northern most tile of area
w	X extent of the area
h	Y extent of the area
rad	Search radius in addition to the given area

Definition at line 533 of file station_cmd.cpp.

References _settings_game, OrthogonalTileArea::Expand(), GetIndustryIndex(), Industry, FlatSet< Tkey, Tcompare >::insert(), IsTileType(), IsValidCargoType(), Industry::neutral_station, and Industry::produced.

Referenced by DrawStationCoverageAreaText().

◆ GetStationTileLayout()

const DrawTileSprites * GetStationTileLayout	(	StationType	st,
		uint8_t	gfx )

Get station tile layout for a station type and its station gfx.

Parameters

st	Station type to draw.
gfx	StationGfx of tile to draw.

Returns: Tile layout to draw.

Definition at line 3118 of file station_cmd.cpp.

References to_underlying().

Referenced by DrawStationTile().

◆ HasStationInUse()

bool HasStationInUse	(	StationID	station,
		bool	include_company,
		CompanyID	company )

Tests whether the company's vehicles have this station in orders.

Parameters

station	station ID
include_company	If true only check vehicles of company, if false only check vehicles of other companies
company	company ID

Definition at line 2862 of file station_cmd.cpp.

References Vehicle::owner.

Referenced by CompanyStationsWindow::BuildStationsList(), and RemoveBuoy().

◆ IncreaseStats() [1/2]

void IncreaseStats	(	Station *	st,
		CargoType	cargo,
		StationID	next_station_id,
		uint	capacity,
		uint	usage,
		uint32_t	time,
		EdgeUpdateModes	modes )

Increase capacity for a link stat given by station cargo and next hop.

Parameters

st	Station to get the link stats from.
cargo	Cargo to increase stat for.
next_station_id	Station the consist will be travelling to next.
capacity	Capacity to add to link stat.
usage	Usage to add to link stat.
time	The travel time for the link.
modes	Update modes to be applied.

Definition at line 4266 of file station_cmd.cpp.

References LinkGraph::AddNode(), Debug, SpecializedStation< Station, false >::Get(), Station::goods, LinkGraphSchedule::instance, GoodsEntry::link_graph, LinkGraph::Merge(), GoodsEntry::node, and LinkGraph::Size().

Referenced by Vehicle::BeginLoading(), IncreaseStats(), and LinkRefresher::RefreshStats().

◆ IncreaseStats() [2/2]

void IncreaseStats	(	Station *	st,
		const Vehicle *	front,
		StationID	next_station_id,
		uint32_t	time )

Increase capacity for all link stats associated with vehicles in the given consist.

Parameters

st	Station to get the link stats from.
front	First vehicle in the consist.
next_station_id	Station the consist will be travelling to next.
time	The travel time for the links.

Definition at line 4319 of file station_cmd.cpp.

References Vehicle::cargo, Vehicle::cargo_type, Increase, IncreaseStats(), Vehicle::Next(), Vehicle::refit_cap, and VehicleCargoList::StoredCount().

◆ ModifyStationRatingAround()

void ModifyStationRatingAround	(	TileIndex	tile,
		Owner	owner,
		int	amount,
		uint	radius )

Forcibly modify station ratings near a given tile.

Used when a crash hurts a company's station ratings nearby, or when local authority actions affect nearby ratings.

Parameters

tile	The center of the ratings change area.
owner	The station owner whose stations are affected.
amount	The amount to change the rating.
radius	The radius to search for stations, from the origin tile.

Definition at line 4393 of file station_cmd.cpp.

References BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Any(), ClampTo(), DistanceManhattan(), ForAllStationsRadius(), Station::goods, BaseStation::owner, GoodsEntry::rating, GoodsEntry::status, and BaseStation::xy.

Referenced by CheckTrainCollision(), CrashAirplane(), TownActionAdvertiseLarge(), TownActionAdvertiseMedium(), TownActionAdvertiseSmall(), and TownActionBuyRights().

◆ RemoveDockingTile()

void RemoveDockingTile ( TileIndex t )

Definition at line 2983 of file station_cmd.cpp.

◆ RerouteCargo()

void RerouteCargo	(	Station *	st,
		CargoType	cargo,
		StationID	avoid,
		StationID	avoid2 )

Reroute cargo of type c at station st or in any vehicles unloading there.

Make sure the cargo's new next hop is neither "avoid" nor "avoid2".

Parameters

st	Station to be rerouted at.
cargo	Type of cargo.
avoid	Original next hop of cargo, avoid this.
avoid2	Another station to be avoided when rerouting.

Definition at line 4147 of file station_cmd.cpp.

References GoodsEntry::GoodsEntryData::cargo, GoodsEntry::GetData(), Station::goods, GoodsEntry::HasData(), Vehicle::Next(), and StationCargoList::Reroute().

Referenced by DeleteStaleLinks(), LinkGraphJob::~LinkGraphJob(), and Station::~Station().

◆ SetRailStationTileFlags()

void SetRailStationTileFlags	(	TileIndex	tile,
		const StationSpec *	statspec )

Set rail station tile flags for the given tile.

Parameters

tile	Tile to set flags on.
statspec	Statspec of the tile.

Definition at line 1416 of file station_cmd.cpp.

References StationSpec::Blocked, GetStationGfx(), GetStationTileFlags(), StationSpec::NoWires, StationSpec::Pylons, SetStationTileBlocked(), SetStationTileHavePylons(), and SetStationTileHaveWires().

Referenced by CmdBuildRailStation(), and CmdBuildRailWaypoint().

◆ ShowStationViewWindow()

void ShowStationViewWindow ( StationID station )

Opens StationViewWindow for given station.

Parameters

station station which window should be opened

Definition at line 2176 of file station_gui.cpp.

References AllocateWindowDescFront().

◆ SplitGroundSpriteForOverlay()

bool SplitGroundSpriteForOverlay	(	const TileInfo *	ti,
		SpriteID *	ground,
		RailTrackOffset *	overlay_offset )

Check whether a sprite is a track sprite, which can be replaced by a non-track ground sprite and a rail overlay.

If the ground sprite is suitable, ground is replaced with the new non-track ground sprite, and overlay_offset is set to the overlay to draw.

Parameters

	ti	Positional info for the tile to decide snowyness etc. May be nullptr.
[in,out]	ground	Groundsprite to draw.
[out]	overlay_offset	Overlay to draw.

Returns: true if overlay can be drawn.

Definition at line 3134 of file station_cmd.cpp.

References _settings_game, Arctic, GetSnowLine(), GetTropicZone(), RTO_X, RTO_Y, TileInfo::tile, TILE_HEIGHT, Tropic, TROPICZONE_DESERT, and Coord3D< T >::z.

Referenced by DrawStationTile().

◆ StationMaintenanceCost()

Money StationMaintenanceCost ( uint32_t num )

inline

Calculates the maintenance cost of a number of station tiles.

Parameters

num	Number of station tiles.

Returns: Total cost.

Definition at line 60 of file station_func.h.

References InfrastructureStation, and IntSqrt().

Referenced by CompaniesGenStatistics().

◆ StationPickerDrawSprite()

void StationPickerDrawSprite	(	int	x,
		int	y,
		StationType	st,
		RailType	railtype,
		RoadType	roadtype,
		int	image )

Definition at line 3520 of file station_cmd.cpp.

◆ UpdateAirportsNoise()

void UpdateAirportsNoise ( )

Recalculate the noise generated by the airports of each town.

Definition at line 2607 of file station_cmd.cpp.

References AirportGetNearestTown(), AT_OILRIG, GetAirportNoiseLevelForDistance(), INVALID_TILE, SpecializedStation< Station, false >::Iterate(), and Town::noise_reached.

Referenced by DoCreateTown(), and InitializeWindowsAndCaches().

◆ UpdateAllStationVirtCoords()

void UpdateAllStationVirtCoords ( )

Update the virtual coords needed to draw the station sign for all stations.

Definition at line 464 of file station_cmd.cpp.

Referenced by CmdRenameTown(), and UpdateAllVirtCoords().

◆ UpdateStationAcceptance()

void UpdateStationAcceptance	(	Station *	st,
		bool	show_msg )

Update the acceptance for a station.

Parameters

st	Station to update
show_msg	controls whether to display a message that acceptance was changed.

Definition at line 610 of file station_cmd.cpp.

References _local_company, GoodsEntry::Acceptance, Station::always_accepted, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Any(), BaseStation::facilities, GetAcceptanceAroundStation(), GetAcceptanceMask(), Station::goods, IsCargoInClass(), BaseStation::IsInUse(), GoodsEntry::link_graph, GoodsEntry::node, NUM_CARGO, BaseStation::owner, Passengers, BaseStation::rect, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Set(), SetWindowWidgetDirty(), ShowRejectOrAcceptNews(), GoodsEntry::status, WC_STATION_VIEW, and WID_SV_ACCEPT_RATING_LIST.

Referenced by AfterLoadGame(), Station::AfterStationTileSetChange(), and StationHandleBigTick().

◆ UpdateStationDockingTiles()

void UpdateStationDockingTiles ( Station * st )

Definition at line 4689 of file station_cmd.cpp.