Command definitions for vehicles. More...

#include "command_type.h"
#include "engine_type.h"
#include "vehicle_type.h"
#include "vehiclelist.h"
#include "vehiclelist_cmd.h"
#include "cargo_type.h"

Functions
std::tuple< CommandCost, VehicleID, uint, uint16_t, CargoArray >	CmdBuildVehicle (DoCommandFlags flags, TileIndex tile, EngineID eid, bool use_free_vehicles, CargoType cargo, ClientID client_id)
	Build a vehicle.
CommandCost	CmdSellVehicle (DoCommandFlags flags, VehicleID v_id, bool sell_chain, bool backup_order, ClientID client_id)
	Sell a vehicle.
std::tuple< CommandCost, uint, uint16_t, CargoArray >	CmdRefitVehicle (DoCommandFlags flags, VehicleID veh_id, CargoType new_cargo_type, uint8_t new_subtype, bool auto_refit, bool only_this, uint8_t num_vehicles)
	Refits a vehicle to the specified cargo type.
CommandCost	CmdSendVehicleToDepot (DoCommandFlags flags, VehicleID veh_id, DepotCommandFlags depot_cmd, const VehicleListIdentifier &vli)
	Send a vehicle to the depot.
CommandCost	CmdChangeServiceInt (DoCommandFlags flags, VehicleID veh_id, uint16_t serv_int, bool is_custom, bool is_percent)
	Change the service interval of a vehicle.
CommandCost	CmdRenameVehicle (DoCommandFlags flags, VehicleID veh_id, const std::string &text)
	Give a custom name to your vehicle.
std::tuple< CommandCost, VehicleID >	CmdCloneVehicle (DoCommandFlags flags, TileIndex tile, VehicleID veh_id, bool share_orders)
	Clone a vehicle.
CommandCost	CmdStartStopVehicle (DoCommandFlags flags, VehicleID veh_id, bool evaluate_startstop_cb)
	Start/Stop a vehicle.
CommandCost	CmdMassStartStopVehicle (DoCommandFlags flags, TileIndex tile, bool do_start, bool vehicle_list_window, const VehicleListIdentifier &vli)
	Starts or stops a lot of vehicles.
CommandCost	CmdDepotSellAllVehicles (DoCommandFlags flags, TileIndex tile, VehicleType vehicle_type)
	Sells all vehicles in a depot.
CommandCost	CmdDepotMassAutoReplace (DoCommandFlags flags, TileIndex tile, VehicleType vehicle_type)
	Autoreplace all vehicles in the depot.
void	CcBuildPrimaryVehicle (Commands, const CommandCost &result, VehicleID new_veh_id, uint, uint16_t, CargoArray)
	This is the Callback method after the construction attempt of a primary vehicle.
void	CcStartStopVehicle (Commands, const CommandCost &result, VehicleID veh_id, bool)
	This is the Callback method after attempting to start/stop a vehicle.
template<typename Tcont, typename Titer>
EndianBufferWriter< Tcont, Titer > &	operator<< (EndianBufferWriter< Tcont, Titer > &buffer, const CargoArray &cargo_array)
EndianBufferReader &	operator>> (EndianBufferReader &buffer, CargoArray &cargo_array)

Detailed Description

Command definitions for vehicles.

Definition in file vehicle_cmd.h.

Function Documentation

◆ CcBuildPrimaryVehicle()

void CcBuildPrimaryVehicle	(	Commands	,
		const CommandCost &	result,
		VehicleID	new_veh_id,
		uint	,
		uint16_t	,
		CargoArray	)

This is the Callback method after the construction attempt of a primary vehicle.

Parameters

result	indicates completion (or not) of the operation
new_veh_id	ID of the new vehicle.

Definition at line 3504 of file vehicle_gui.cpp.

References CommandCost::Failed(), and ShowVehicleViewWindow().

◆ CcStartStopVehicle()

void CcStartStopVehicle	(	Commands	,
		const CommandCost &	result,
		VehicleID	veh_id,
		bool	)

This is the Callback method after attempting to start/stop a vehicle.

Parameters

result	the result of the start/stop command
veh_id	Vehicle ID.

Definition at line 2922 of file vehicle_gui.cpp.

References _local_company, Ticks::DAY_TICKS, CommandCost::Failed(), GetEncodedString(), Vehicle::IsPrimaryVehicle(), Vehicle::owner, Point, RemapCoords(), Stopped, TE_RISING, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), Vehicle::vehstatus, Coord2D< T >::x, Vehicle::x_pos, Coord2D< T >::y, Vehicle::y_pos, and Vehicle::z_pos.

Referenced by StartStopVehicle().

◆ CmdBuildVehicle()

std::tuple< CommandCost, VehicleID, uint, uint16_t, CargoArray > CmdBuildVehicle	(	DoCommandFlags	flags,
		TileIndex	tile,
		EngineID	eid,
		bool	use_free_vehicles,
		CargoType	cargo,
		ClientID	client_id )

Build a vehicle.

Parameters

flags	for command
tile	tile of depot where the vehicle is built
eid	vehicle type being built.
use_free_vehicles	use free vehicles when building the vehicle.
cargo	refit cargo type.
client_id	User

Returns: the cost of this operation + the new vehicle ID + the refitted capacity + the refitted mail capacity (aircraft) or an error

Definition at line 100 of file vehicle_cmd.cpp.

References _current_company, CommandCost::AddCost(), AIR_CTOL, AutoReplace, CMD_ERROR, CmdBuildAircraft(), CmdBuildRailVehicle(), CmdBuildRoadVehicle(), CmdBuildShip(), CmdRefitVehicle(), CountArticulatedParts(), GroupStatistics::CountEngine(), GroupStatistics::CountVehicle(), Vehicle::engine_type, Execute, EXPENSES_NEW_VEHICLES, SpecializedVehicle< Train, Type >::From(), GetCapacityOfArticulatedParts(), CommandCost::GetCost(), Engine::GetCost(), Engine::GetDefaultCargoType(), GetDepotVehicleType(), Engine::GetDisplayDefaultCapacity(), GetFreeUnitNumber(), GetWindowClassForVehicleType(), Vehicle::group_id, INVALID_CLIENT_ID, InvalidateAutoreplaceWindow(), InvalidateWindowClassesData(), InvalidateWindowData(), IsDepotTile(), IsEngineBuildable(), IsLocalCompany(), Vehicle::IsPrimaryVehicle(), IsTileOwner(), IsValidCargoType(), NormalizeTrainVehInDepot(), NUM_CARGO, Vehicle::owner, QueryCost, RAILVEH_MULTIHEAD, RAILVEH_WAGON, OrderBackup::Restore(), RestoreRandomSeeds(), SaveRandomSeeds(), BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Set(), SetWindowDirty(), CommandCost::Succeeded(), BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), Vehicle::tile, BaseVehicle::type, Engine::type, Vehicle::unitnumber, GroupStatistics::UpdateAutoreplace(), Vehicle::value, VEH_AIRCRAFT, VEH_ROAD, VEH_SHIP, VEH_TRAIN, WC_COMPANY, and WC_VEHICLE_DEPOT.

◆ CmdChangeServiceInt()

CommandCost CmdChangeServiceInt	(	DoCommandFlags	flags,
		VehicleID	veh_id,
		uint16_t	serv_int,
		bool	is_custom,
		bool	is_percent )

Change the service interval of a vehicle.

Parameters

flags	type of operation
veh_id	vehicle ID that is being service-interval-changed
serv_int	new service interval
is_custom	service interval is custom flag
is_percent	service interval is percentage flag

Returns: the cost of this operation or an error

Definition at line 1116 of file vehicle_cmd.cpp.

References CheckOwnership(), CMD_ERROR, CompanyServiceInterval(), Execute, CommandCost::Failed(), GetServiceIntervalClamped(), Vehicle::IsPrimaryVehicle(), Vehicle::owner, VehicleDefaultSettings::servint_ispercent, CompanyProperties::settings, SetWindowDirty(), BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), BaseVehicle::type, CompanySettings::vehicle, and WC_VEHICLE_DETAILS.

◆ CmdCloneVehicle()

std::tuple< CommandCost, VehicleID > CmdCloneVehicle	(	DoCommandFlags	flags,
		TileIndex	tile,
		VehicleID	veh_id,
		bool	share_orders )

Clone a vehicle.

If it is a train, it will clone all the cars too

Parameters

flags	type of operation
tile	tile of the depot where the cloned vehicle is build
veh_id	the original vehicle's index
share_orders	shared orders, else copied orders

Returns: the cost of this operation + the new vehicle ID or an error

Definition at line 830 of file vehicle_cmd.cpp.

References CommandCost::AddCost(), AutoReplace, Engine::CanCarryCargo(), Vehicle::cargo_subtype, Vehicle::cargo_type, CheckCompanyHasMoney(), CheckOwnership(), CloneVehicleName(), CMD_ERROR, Vehicle::engine_type, Execute, EXPENSES_NEW_VEHICLES, CommandCost::Failed(), Flipped, SpecializedVehicle< Train, Type >::From(), GetBestFittingSubType(), CommandCost::GetCost(), Engine::GetDefaultCargoType(), Vehicle::GetEngine(), Vehicle::GetNextArticulatedPart(), Vehicle::GetNextVehicle(), GetRefitCost(), Vehicle::group_id, Vehicle::HasArticulatedPart(), INVALID_CLIENT_ID, Vehicle::IsFrontEngine(), Vehicle::IsGroundVehicle(), Vehicle::IsPrimaryVehicle(), IsValidCargoType(), BaseConsist::name, Vehicle::Next(), Vehicle::owner, Reversed, BaseConsist::service_interval, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Set(), CommandCost::Succeeded(), BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), TestVehicleBuildProbability(), BaseVehicle::type, and VEH_TRAIN.

◆ CmdDepotMassAutoReplace()

CommandCost CmdDepotMassAutoReplace	(	DoCommandFlags	flags,
		TileIndex	tile,
		VehicleType	vehicle_type )

Autoreplace all vehicles in the depot.

Parameters

flags	type of operation
tile	Tile of the depot where the vehicles are
vehicle_type	Type of vehicle

Returns: the cost of this operation or an error

Definition at line 734 of file vehicle_cmd.cpp.

References _current_company, CommandCost::AddCost(), BuildDepotVehicleList(), CMD_ERROR, EXPENSES_NEW_VEHICLES, CommandCost::GetCost(), IsCompanyBuildableVehicleType(), IsDepotTile(), IsTileOwner(), and CommandCost::Succeeded().

◆ CmdDepotSellAllVehicles()

CommandCost CmdDepotSellAllVehicles	(	DoCommandFlags	flags,
		TileIndex	tile,
		VehicleType	vehicle_type )

Sells all vehicles in a depot.

Parameters

flags	type of operation
tile	Tile of the depot where the depot is
vehicle_type	Vehicle type

Returns: the cost of this operation or an error

Definition at line 700 of file vehicle_cmd.cpp.

References _current_company, CommandCost::AddCost(), BuildDepotVehicleList(), CMD_ERROR, EXPENSES_NEW_VEHICLES, CommandCost::GetCost(), INVALID_CLIENT_ID, IsCompanyBuildableVehicleType(), IsDepotTile(), IsTileOwner(), and CommandCost::Succeeded().

◆ CmdMassStartStopVehicle()

CommandCost CmdMassStartStopVehicle	(	DoCommandFlags	flags,
		TileIndex	tile,
		bool	do_start,
		bool	vehicle_list_window,
		const VehicleListIdentifier &	vli )

Starts or stops a lot of vehicles.

Parameters

flags	type of operation
tile	Tile of the depot where the vehicles are started/stopped (only used for depots)
do_start	set = start vehicles, unset = stop vehicles
vehicle_list_window	if set, then it's a vehicle list window, not a depot and Tile is ignored in this case
vli	VehicleListIdentifier

Returns: the cost of this operation or an error

Definition at line 666 of file vehicle_cmd.cpp.

References _current_company, BuildDepotVehicleList(), CMD_ERROR, do_start, GenerateVehicleSortList(), IsCompanyBuildableVehicleType(), IsDepotTile(), IsTileOwner(), Stopped, and VehicleListIdentifier::vtype.

◆ CmdRefitVehicle()

std::tuple< CommandCost, uint, uint16_t, CargoArray > CmdRefitVehicle	(	DoCommandFlags	flags,
		VehicleID	veh_id,
		CargoType	new_cargo_type,
		uint8_t	new_subtype,
		bool	auto_refit,
		bool	only_this,
		uint8_t	num_vehicles )

Refits a vehicle to the specified cargo type.

Parameters

flags	type of operation
veh_id	vehicle ID to refit
new_cargo_type	New cargo type to refit to.
new_subtype	New cargo subtype to refit to. 0xFF means to try keeping the same subtype according to GetBestFittingSubType().
auto_refit	Automatic refitting.
only_this	Refit only this vehicle. Used only for cloning vehicles.
num_vehicles	Number of vehicles to refit (not counting articulated parts). Zero means all vehicles. Only used if "refit only this vehicle" is false.

Returns: the cost of this operation or an error

Definition at line 493 of file vehicle_cmd.cpp.

References _settings_game, GroundVehicle< T, Type >::CargoChanged(), CCF_AUTOREFIT, CCF_REFIT, CheckOwnership(), CMD_ERROR, Train::ConsistChanged(), Crashed, Vehicle::current_order, Execute, CommandCost::Failed(), Vehicle::First(), SpecializedVehicle< Aircraft, VEH_AIRCRAFT >::From(), SpecializedVehicle< RoadVehicle, Type >::From(), SpecializedVehicle< Ship, VEH_SHIP >::From(), SpecializedVehicle< Train, Type >::From(), GetWindowClassForVehicleType(), Vehicle::InvalidateNewGRFCacheOfChain(), InvalidateWindowClassesData(), InvalidateWindowData(), IsCompanyBuildableVehicleType(), GroundVehicle< T, Type >::IsFreeWagon(), Vehicle::IsStoppedInDepot(), Order::IsType(), Vehicle::MarkDirty(), NUM_CARGO, Vehicle::owner, QueryCost, RefitVehicle(), RoadVehUpdateCache(), SetWindowDirty(), BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), Vehicle::tile, BaseVehicle::type, UpdateAircraftCache(), Ship::UpdateCache(), VEH_AIRCRAFT, VEH_ROAD, VEH_SHIP, VEH_TRAIN, Vehicle::vehstatus, WC_VEHICLE_DEPOT, and WC_VEHICLE_DETAILS.

Referenced by CmdBuildVehicle().

◆ CmdRenameVehicle()

CommandCost CmdRenameVehicle	(	DoCommandFlags	flags,
		VehicleID	veh_id,
		const std::string &	text )

Give a custom name to your vehicle.

Parameters

flags	type of operation
veh_id	vehicle ID to name
text	the new name or an empty string when resetting to the default

Returns: the cost of this operation or an error

Definition at line 1078 of file vehicle_cmd.cpp.

References AutoReplace, CheckOwnership(), CMD_ERROR, Execute, CommandCost::Failed(), GetWindowClassForVehicleType(), InvalidateWindowClassesData(), Vehicle::IsPrimaryVehicle(), IsUniqueVehicleName(), MarkWholeScreenDirty(), MAX_LENGTH_VEHICLE_NAME_CHARS, BaseConsist::name, Vehicle::owner, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), BaseVehicle::type, and Utf8StringLength().

◆ CmdSellVehicle()

CommandCost CmdSellVehicle	(	DoCommandFlags	flags,
		VehicleID	v_id,
		bool	sell_chain,
		bool	backup_order,
		ClientID	client_id )

Sell a vehicle.

Parameters

flags	for command.
v_id	vehicle ID being sold.
sell_chain	sell the vehicle and all vehicles following it in the chain.
backup_order	make a backup of the vehicle's order (if an engine).
client_id	User.

Returns: the cost of this operation or an error.

Definition at line 236 of file vehicle_cmd.cpp.

References OrderBackup::Backup(), CheckOwnership(), CMD_ERROR, CmdSellRailWagon(), Crashed, Execute, EXPENSES_NEW_VEHICLES, CommandCost::Failed(), Vehicle::First(), Vehicle::IsPrimaryVehicle(), Vehicle::IsStoppedInDepot(), Vehicle::owner, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), BaseVehicle::type, Vehicle::value, VEH_TRAIN, and Vehicle::vehstatus.

◆ CmdSendVehicleToDepot()

CommandCost CmdSendVehicleToDepot	(	DoCommandFlags	flags,
		VehicleID	veh_id,
		DepotCommandFlags	depot_cmd,
		const VehicleListIdentifier &	vli )

Send a vehicle to the depot.

Parameters

flags	for command type
veh_id	vehicle ID to send to the depot
depot_cmd	DEPOT_ flags (see vehicle_type.h)
vli	VehicleListIdentifier.

Returns: the cost of this operation or an error

Definition at line 1056 of file vehicle_cmd.cpp.

References CMD_ERROR, Vehicle::IsPrimaryVehicle(), MassSend, SendAllVehiclesToDepot(), Vehicle::SendToDepot(), Service, and BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test().

◆ CmdStartStopVehicle()

CommandCost CmdStartStopVehicle	(	DoCommandFlags	flags,
		VehicleID	veh_id,
		bool	evaluate_startstop_cb )

Start/Stop a vehicle.

Parameters

flags	type of operation
veh_id	vehicle to start/stop, don't forget to change CcStartStopVehicle if you modify this!
evaluate_startstop_cb	Shall the start/stop newgrf callback be evaluated (only valid with DoCommandFlag::AutoReplace for network safety)

Returns: the cost of this operation or an error

Definition at line 575 of file vehicle_cmd.cpp.

References AutoReplace, CALLBACK_FAILED, CBID_VEHICLE_START_STOP_CHECK, CheckOwnership(), CMD_ERROR, Crashed, Vehicle::cur_speed, DeleteVehicleNews(), Vehicle::engine_type, Execute, CommandCost::Failed(), Aircraft::flags, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Flip(), SpecializedVehicle< Aircraft, VEH_AIRCRAFT >::From(), SpecializedVehicle< Train, Type >::From(), GB(), Vehicle::GetGRF(), Vehicle::GetGRFID(), GetGRFStringID(), GetVehicleCallback(), GetWindowClassForVehicleType(), GRFSTR_MISC_GRF_TEXT, HelicopterDirectDescent, InvalidateWindowData(), Vehicle::IsPrimaryVehicle(), Vehicle::IsStoppedInDepot(), Vehicle::MarkDirty(), Vehicle::owner, BaseConsist::ResetDepotUnbunching(), SetWindowClassesDirty(), SetWindowDirty(), SetWindowWidgetDirty(), STARTTAKEOFF, Aircraft::state, Stopped, TERM7, BaseBitSet< Timpl, Tvalue_type, Tstorage, Tmask >::Test(), Vehicle::tile, BaseVehicle::type, VEH_AIRCRAFT, VEH_ROAD, VEH_SHIP, VEH_TRAIN, VehicleWaiting, Vehicle::vehstatus, WC_VEHICLE_DEPOT, WC_VEHICLE_VIEW, and WID_VV_START_STOP.

◆ operator<<()

template<typename Tcont, typename Titer>

EndianBufferWriter< Tcont, Titer > & operator<<	(	EndianBufferWriter< Tcont, Titer > &	buffer,
		const CargoArray &	cargo_array )

inline

Definition at line 45 of file vehicle_cmd.h.

◆ operator>>()

EndianBufferReader & operator>>	(	EndianBufferReader &	buffer,
		CargoArray &	cargo_array )

inline

Definition at line 56 of file vehicle_cmd.h.

Functions

Detailed Description

Function Documentation

◆ CcBuildPrimaryVehicle()

◆ CcStartStopVehicle()

◆ CmdBuildVehicle()

◆ CmdChangeServiceInt()

◆ CmdCloneVehicle()

◆ CmdDepotMassAutoReplace()

◆ CmdDepotSellAllVehicles()

◆ CmdMassStartStopVehicle()

◆ CmdRefitVehicle()

◆ CmdRenameVehicle()

◆ CmdSellVehicle()

◆ CmdSendVehicleToDepot()

◆ CmdStartStopVehicle()

◆ operator<<()

◆ operator>>()