Class that handles all station related functions. More...

#include <script_station.hpp>

Inheritance diagram for AIStation:

Public Types
enum	ErrorMessages { ERR_STATION_BASE , ERR_STATION_TOO_CLOSE_TO_ANOTHER_STATION , ERR_STATION_TOO_MANY_STATIONS , ERR_STATION_TOO_MANY_STATIONS_IN_TOWN }
	All station related error messages. More...

enum	StationType { STATION_TRAIN , STATION_TRUCK_STOP , STATION_BUS_STOP , STATION_AIRPORT , STATION_DOCK , STATION_ANY }
	Type of stations known in the game. More...

Static Public Member Functions
static bool	IsValidStation (StationID station_id)
	Checks whether the given station is valid and owned by you.

static StationID	GetStationID (TileIndex tile)
	Get the StationID of a tile, if there is a station.

static int	GetCargoWaiting (StationID station_id, CargoType cargo_type)
	See how much cargo there is waiting on a station.

static int	GetCargoWaitingFrom (StationID station_id, StationID from_station_id, CargoType cargo_type)
	See how much cargo with a specific source station there is waiting on a station.

static int	GetCargoWaitingVia (StationID station_id, StationID via_station_id, CargoType cargo_type)
	See how much cargo with a specific via-station there is waiting on a station.

static int	GetCargoWaitingFromVia (StationID station_id, StationID from_station_id, StationID via_station_id, CargoType cargo_type)
	See how much cargo with a specific via-station and source station there is waiting on a station.

static int	GetCargoPlanned (StationID station_id, CargoType cargo_type)
	See how much cargo was planned to pass (including production and consumption) this station per month.

static int	GetCargoPlannedFrom (StationID station_id, StationID from_station_id, CargoType cargo_type)
	See how much cargo from the specified origin was planned to pass (including production and consumption) this station per month.

static int	GetCargoPlannedVia (StationID station_id, StationID via_station_id, CargoType cargo_type)
	See how much cargo was planned to pass (including production and consumption) this station per month, heading for the specified next hop.

static int	GetCargoPlannedFromVia (StationID station_id, StationID from_station_id, StationID via_station_id, CargoType cargo_type)
	See how much cargo from the specified origin was planned to pass this station per month, heading for the specified next hop.

static bool	HasCargoRating (StationID station_id, CargoType cargo_type)
	Check whether the given cargo at the given station a rating.

static int	GetCargoRating (StationID station_id, CargoType cargo_type)
	See how high the rating is of a cargo on a station.

static int	GetCoverageRadius (AIStation::StationType station_type)
	Get the coverage radius of this type of station.

static int	GetStationCoverageRadius (StationID station_id)
	Get the coverage radius of this station.

static int	GetDistanceManhattanToTile (StationID station_id, TileIndex tile)
	Get the manhattan distance from the tile to the AIStation::GetLocation() of the station.

static int	GetDistanceSquareToTile (StationID station_id, TileIndex tile)
	Get the square distance from the tile to the AIStation::GetLocation() of the station.

static bool	IsWithinTownInfluence (StationID station_id, TownID town_id)
	Find out if this station is within the rating influence of a town.

static bool	HasStationType (StationID station_id, StationType station_type)
	Check if any part of the station contains a station of the type StationType.

static bool	HasRoadType (StationID station_id, AIRoad::RoadType road_type)
	Check if any part of the station contains a station of the type RoadType.

static TownID	GetNearestTown (StationID station_id)
	Get the town that was nearest to the given station when the station was built.

static bool	IsAirportClosed (StationID station_id)
	Get the open/closed state of an airport.

static bool	OpenCloseAirport (StationID station_id)
	Toggle the open/closed state of an airport.

Static Public Member Functions inherited from AIBaseStation
static bool	IsValidBaseStation (StationID station_id)
	Checks whether the given basestation is valid and owned by you.

static string	GetName (StationID station_id)
	Get the name of a basestation.

static bool	SetName (StationID station_id, Text *name)
	Set the name this basestation.

static TileIndex	GetLocation (StationID station_id)
	Get the current location of a basestation.

static AIDate::Date	GetConstructionDate (StationID station_id)
	Get the last calendar-date a station part was added to this station.

Additional Inherited Members
Static Public Attributes inherited from AIBaseStation
static constexpr StationID	STATION_NEW = ::NEW_STATION
	Build a new station.

static constexpr StationID	STATION_JOIN_ADJACENT = ::ADJACENT_STATION
	Join an neighbouring station if one exists.

static constexpr StationID	STATION_INVALID = ::StationID::Invalid()
	Invalid station id.

Detailed Description

Class that handles all station related functions.

Member Enumeration Documentation

◆ ErrorMessages

enum AIStation::ErrorMessages

All station related error messages.

See also: ScriptErrorType

Enumerator
ERR_STATION_BASE	Base for station related errors.
ERR_STATION_TOO_CLOSE_TO_ANOTHER_STATION	The station is build too close to another station, airport or dock.
ERR_STATION_TOO_MANY_STATIONS	There are too many stations, airports and docks in the game.
ERR_STATION_TOO_MANY_STATIONS_IN_TOWN	There are too many stations, airports of docks in a town.

◆ StationType

enum AIStation::StationType

Type of stations known in the game.

Enumerator
STATION_TRAIN	Train station.
STATION_TRUCK_STOP	Truck station.
STATION_BUS_STOP	Bus station.
STATION_AIRPORT	Airport.
STATION_DOCK	Dock.
STATION_ANY	All station types.

Member Function Documentation

◆ GetCargoPlanned()

static int AIStation::GetCargoPlanned	(	StationID	station_id,
		CargoType	cargo_type
	)

static

See how much cargo was planned to pass (including production and consumption) this station per month.

Parameters

station_id	The station to get the planned flow for.
cargo_type	The cargo type to get the planned flow for.

Precondition: IsValidStation(station_id).; IsValidCargo(cargo_type).

Returns: The amount of cargo units planned to pass the station per month.

◆ GetCargoPlannedFrom()

static int AIStation::GetCargoPlannedFrom	(	StationID	station_id,
		StationID	from_station_id,
		CargoType	cargo_type
	)

static

See how much cargo from the specified origin was planned to pass (including production and consumption) this station per month.

Parameters

station_id	The station to get the planned flow for.
from_station_id	The station the cargo originates at.
cargo_type	The cargo type to get the planned flow for.

Precondition: IsValidStation(station_id).; IsValidStation(from_station_id) || from_station_id == STATION_INVALID.; IsValidCargo(cargo_type).

Returns: The amount of cargo units from the specified origin planned to pass the station per month.

◆ GetCargoPlannedFromVia()

static int AIStation::GetCargoPlannedFromVia	(	StationID	station_id,
		StationID	from_station_id,
		StationID	via_station_id,
		CargoType	cargo_type
	)

static

See how much cargo from the specified origin was planned to pass this station per month, heading for the specified next hop.

Parameters

station_id	The station to get the planned flow for.
from_station_id	The station the cargo originates at.
via_station_id	The next station the cargo will go on to.
cargo_type	The cargo type to get the planned flow for.

Precondition: IsValidStation(station_id).; IsValidStation(from_station_id) || from_station_id == STATION_INVALID.; IsValidStation(via_station_id) || via_station_id == STATION_INVALID.; IsValidCargo(cargo_type).

Returns: The amount of cargo units from the specified origin planned to pass the station per month, going via the specified next hop.

Note: Cargo planned to go "via" the same station that's being queried is actually planned to be consumed there.; Cargo planned to pass "from" the same station that's being queried is actually produced there.

◆ GetCargoPlannedVia()

static int AIStation::GetCargoPlannedVia	(	StationID	station_id,
		StationID	via_station_id,
		CargoType	cargo_type
	)

static

See how much cargo was planned to pass (including production and consumption) this station per month, heading for the specified next hop.

Parameters

station_id	The station to get the planned flow for.
via_station_id	The next station the cargo will go on to.
cargo_type	The cargo type to get the planned flow for.

Precondition: IsValidStation(station_id).; IsValidStation(via_station_id) || via_station_id == STATION_INVALID.; IsValidCargo(cargo_type).

Returns: The amount of cargo units planned to pass the station per month, going via the specified next hop.

Note: Cargo planned to go "via" the same station that's being queried is actually planned to be consumed there.

◆ GetCargoRating()

static int AIStation::GetCargoRating	(	StationID	station_id,
		CargoType	cargo_type
	)

static

See how high the rating is of a cargo on a station.

Parameters

station_id	The station to get the cargo-rating of.
cargo_type	The cargo to get the cargo-rating of.

Precondition: IsValidStation(station_id).; IsValidCargo(cargo_type).; HasCargoRating(station_id, cargo_type).

Returns: The rating in percent of the cargo on the station.

◆ GetCargoWaiting()

static int AIStation::GetCargoWaiting	(	StationID	station_id,
		CargoType	cargo_type
	)

static

See how much cargo there is waiting on a station.

Parameters

station_id	The station to get the cargo-waiting of.
cargo_type	The cargo to get the cargo-waiting of.

Precondition: IsValidStation(station_id).; IsValidCargo(cargo_type).

Returns: The amount of units waiting at the station.

◆ GetCargoWaitingFrom()

static int AIStation::GetCargoWaitingFrom	(	StationID	station_id,
		StationID	from_station_id,
		CargoType	cargo_type
	)

static

See how much cargo with a specific source station there is waiting on a station.

Parameters

station_id	The station to get the cargo-waiting of.
from_station_id	The source station of the cargo. Pass STATION_INVALID to get cargo of which the source has been deleted.
cargo_type	The cargo to get the cargo-waiting of.

Precondition: IsValidStation(station_id).; IsValidStation(from_station_id) || from_station_id == STATION_INVALID.; IsValidCargo(cargo_type).

Returns: The amount of units waiting at the station originating from from_station_id.

Note: source station means, the station where cargo was first loaded.

◆ GetCargoWaitingFromVia()

static int AIStation::GetCargoWaitingFromVia	(	StationID	station_id,
		StationID	from_station_id,
		StationID	via_station_id,
		CargoType	cargo_type
	)

static

See how much cargo with a specific via-station and source station there is waiting on a station.

Parameters

station_id	The station to get the cargo-waiting of.
from_station_id	The source station of the cargo. Pass STATION_INVALID to get cargo of which the source has been deleted.
via_station_id	The next station the cargo is going to. Pass STATION_INVALID to get waiting cargo for "via any station".
cargo_type	The cargo to get the cargo-waiting of.

Precondition: IsValidStation(station_id).; IsValidStation(from_station_id) || from_station_id == STATION_INVALID.; IsValidStation(via_station_id) || via_station_id == STATION_INVALID.; IsValidCargo(cargo_type).

Returns: The amount of units waiting at the station with from_station_id as source and via_station_id as next hop.

Note: if AICargo.GetCargoDistributionType(cargo_type) == AICargo.DT_MANUAL, then all waiting cargo will have STATION_INVALID as next hop.

◆ GetCargoWaitingVia()

static int AIStation::GetCargoWaitingVia	(	StationID	station_id,
		StationID	via_station_id,
		CargoType	cargo_type
	)

static

See how much cargo with a specific via-station there is waiting on a station.

Parameters

station_id	The station to get the cargo-waiting of.
via_station_id	The next station the cargo is going to. Pass STATION_INVALID to get waiting cargo for "via any station".
cargo_type	The cargo to get the cargo-waiting of.

Precondition: IsValidStation(station_id).; IsValidStation(via_station_id) || via_station_id == STATION_INVALID.; IsValidCargo(cargo_type).

Returns: The amount of units waiting at the station with via_station_id as next hop.

Note: if AICargo.GetCargoDistributionType(cargo_type) == AICargo.DT_MANUAL, then all waiting cargo will have STATION_INVALID as next hop.

◆ GetCoverageRadius()

static int AIStation::GetCoverageRadius ( AIStation::StationType station_type )

static

Get the coverage radius of this type of station.

Parameters

station_type The type of station.

Precondition: station_type != STATION_AIRPORT.

Returns: The radius in tiles.

Note: Coverage radius of airports needs to be requested via AIAirport::GetAirportCoverageRadius(), as it requires AirportType.

◆ GetDistanceManhattanToTile()

static int AIStation::GetDistanceManhattanToTile	(	StationID	station_id,
		TileIndex	tile
	)

static

Get the manhattan distance from the tile to the AIStation::GetLocation() of the station.

Parameters

station_id	The station to get the distance to.
tile	The tile to get the distance to.

Precondition: IsValidStation(station_id).

Returns: The distance between station and tile.

◆ GetDistanceSquareToTile()

static int AIStation::GetDistanceSquareToTile	(	StationID	station_id,
		TileIndex	tile
	)

static

Get the square distance from the tile to the AIStation::GetLocation() of the station.

Parameters

station_id	The station to get the distance to.
tile	The tile to get the distance to.

Precondition: IsValidStation(station_id).

Returns: The distance between station and tile.

◆ GetNearestTown()

static TownID AIStation::GetNearestTown ( StationID station_id )

static

Get the town that was nearest to the given station when the station was built.

Parameters

station_id The station to look at.

Returns: The TownID of the town whose center tile was closest to the station at the time the station was built.

Note: There is no guarantee that the station is even near the returned town nor that the returns town is closest to the station now. A station that was 'walked' to the other end of the map will still return the same town. Also, towns grow, towns change. So don't depend on this value too much.

◆ GetStationCoverageRadius()

static int AIStation::GetStationCoverageRadius ( StationID station_id )

static

Get the coverage radius of this station.

Parameters

station_id The station to get the coverage radius of.

Precondition: IsValidStation(station_id).

Returns: The radius in tiles.

◆ GetStationID()

static StationID AIStation::GetStationID ( TileIndex tile )

static

Get the StationID of a tile, if there is a station.

Parameters

tile	The tile to find the stationID of

Returns: StationID of the station.

Postcondition: Use IsValidStation() to see if the station is valid.

◆ HasCargoRating()

static bool AIStation::HasCargoRating	(	StationID	station_id,
		CargoType	cargo_type
	)

static

Check whether the given cargo at the given station a rating.

Parameters

station_id	The station to get the cargo-rating state of.
cargo_type	The cargo to get the cargo-rating state of.

Precondition: IsValidStation(station_id).; IsValidCargo(cargo_type).

Returns: True if the cargo has a rating, otherwise false.

◆ HasRoadType()

static bool AIStation::HasRoadType	(	StationID	station_id,
		AIRoad::RoadType	road_type
	)

static

Check if any part of the station contains a station of the type RoadType.

Parameters

station_id	The station to look at.
road_type	The RoadType to look for.

Returns: True if the station has a station part of the type RoadType.

◆ HasStationType()

static bool AIStation::HasStationType	(	StationID	station_id,
		StationType	station_type
	)

static

Check if any part of the station contains a station of the type StationType.

Parameters

station_id	The station to look at.
station_type	The StationType to look for.

Returns: True if the station has a station part of the type StationType.

◆ IsAirportClosed()

static bool AIStation::IsAirportClosed ( StationID station_id )

static

Get the open/closed state of an airport.

Parameters

station_id The airport to look at.

Precondition: IsValidStation(station_id).; HasStationType(station_id, STATION_AIRPORT).

Returns: True if the airport is currently closed to incoming traffic.

◆ IsValidStation()

static bool AIStation::IsValidStation ( StationID station_id )

static

Checks whether the given station is valid and owned by you.

Parameters

station_id The station to check.

Returns: True if and only if the station is valid.

◆ IsWithinTownInfluence()

static bool AIStation::IsWithinTownInfluence	(	StationID	station_id,
		TownID	town_id
	)

static

Find out if this station is within the rating influence of a town.

The service quality of stations with signs within this radius influences the rating of the town.

Parameters

station_id	The station to check.
town_id	The town to check.

Returns: True if the tile is within the rating influence of the town.

◆ OpenCloseAirport()

static bool AIStation::OpenCloseAirport ( StationID station_id )

static

Toggle the open/closed state of an airport.

Parameters

station_id The airport to modify.

Precondition: IsValidStation(station_id).; HasStationType(station_id, STATION_AIRPORT).

Returns: True if the state was toggled successfully.

Public Types

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ ErrorMessages

◆ StationType

Member Function Documentation

◆ GetCargoPlanned()

◆ GetCargoPlannedFrom()

◆ GetCargoPlannedFromVia()

◆ GetCargoPlannedVia()

◆ GetCargoRating()

◆ GetCargoWaiting()

◆ GetCargoWaitingFrom()

◆ GetCargoWaitingFromVia()

◆ GetCargoWaitingVia()

◆ GetCoverageRadius()

◆ GetDistanceManhattanToTile()

◆ GetDistanceSquareToTile()

◆ GetNearestTown()

◆ GetStationCoverageRadius()

◆ GetStationID()

◆ HasCargoRating()

◆ HasRoadType()

◆ HasStationType()

◆ IsAirportClosed()

◆ IsValidStation()

◆ IsWithinTownInfluence()

◆ OpenCloseAirport()