station_func.h File Reference

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"

Go to the source code of this file.

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).
std::pair< CargoArray, CargoTypes >	GetAcceptanceAroundTiles (TileIndex tile, int w, int h, int rad)
	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 716 of file station.cpp.

References _price, 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 495 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 3024 of file station_cmd.cpp.

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

Referenced by RemoveDock(), and Industry::~Industry().

DeleteOilRig()

void DeleteOilRig

(

TileIndex

t

)

Definition at line 4782 of file station_cmd.cpp.

GetAcceptanceAroundTiles()

std::pair< CargoArray, CargoTypes > GetAcceptanceAroundTiles	(	TileIndex	center_tile,
		int	w,
		int	h,
		int	rad )

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

Returns

Cargo array of accepted cargo types and bitmask of cargo accepted by houses and headquarters.

Definition at line 589 of file station_cmd.cpp.

References _settings_game, AddAcceptedCargo(), 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 507 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 522 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

Returns

Array of production per cargo type.

Definition at line 552 of file station_cmd.cpp.

References _settings_game, AddProducedCargo(), 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 3138 of file station_cmd.cpp.

References to_underlying().

Referenced by DrawStationTile(), and DrawTile_Station().

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

Returns

true when at least one vehicle is ordered to go to this station.

Definition at line 2882 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 4284 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 4337 of file station_cmd.cpp.

References Increase, IncreaseStats(), and Vehicle::Next().

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 4411 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 3003 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 4165 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 1435 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 2189 of file station_gui.cpp.

References AllocateWindowDescFront().

Referenced by ClickTile_Station().

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 3154 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(), and DrawTile_Station().

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 _price, InfrastructureStation, and IntSqrt().

Referenced by CompaniesGenStatistics().

StationPickerDrawSprite()

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

Definition at line 3541 of file station_cmd.cpp.

UpdateAirportsNoise()

void UpdateAirportsNoise

(

)

Recalculate the noise generated by the airports of each town.

Definition at line 2626 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 482 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 629 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 4707 of file station_cmd.cpp.