OpenTTD Source
20241108-master-g80f628063a
|
Handling of orders. More...
#include "stdafx.h"
#include "debug.h"
#include "command_func.h"
#include "company_func.h"
#include "news_func.h"
#include "strings_func.h"
#include "timetable.h"
#include "vehicle_func.h"
#include "depot_base.h"
#include "core/pool_func.hpp"
#include "core/random_func.hpp"
#include "aircraft.h"
#include "roadveh.h"
#include "station_base.h"
#include "waypoint_base.h"
#include "company_base.h"
#include "order_backup.h"
#include "cheat_type.h"
#include "order_cmd.h"
#include "train_cmd.h"
#include "table/strings.h"
#include "safeguards.h"
Go to the source code of this file.
Functions | |
void | InvalidateVehicleOrder (const Vehicle *v, int data) |
Updates the widgets of a vehicle which contains the order-data. | |
static bool | OrderGoesToStation (const Vehicle *v, const Order *o) |
Checks whether the order goes to a station or not, i.e. More... | |
static void | DeleteOrderWarnings (const Vehicle *v) |
Delete all news items regarding defective orders about a vehicle This could kill still valid warnings (for example about void order when just another order gets added), but assume the company will notice the problems, when they're changing the orders. | |
uint | GetOrderDistance (const Order *prev, const Order *cur, const Vehicle *v, int conditional_depth) |
Get the distance between two orders of a vehicle. More... | |
CommandCost | CmdInsertOrder (DoCommandFlag flags, VehicleID veh, VehicleOrderID sel_ord, const Order &new_order) |
Add an order to the orderlist of a vehicle. More... | |
void | InsertOrder (Vehicle *v, Order *new_o, VehicleOrderID sel_ord) |
Insert a new order but skip the validation. More... | |
static CommandCost | DecloneOrder (Vehicle *dst, DoCommandFlag flags) |
Declone an order-list. More... | |
CommandCost | CmdDeleteOrder (DoCommandFlag flags, VehicleID veh_id, VehicleOrderID sel_ord) |
Delete an order from the orderlist of a vehicle. More... | |
static void | CancelLoadingDueToDeletedOrder (Vehicle *v) |
Cancel the current loading order of the vehicle as the order was deleted. More... | |
void | DeleteOrder (Vehicle *v, VehicleOrderID sel_ord) |
Delete an order but skip the parameter validation. More... | |
CommandCost | CmdSkipToOrder (DoCommandFlag flags, VehicleID veh_id, VehicleOrderID sel_ord) |
Goto order of order-list. More... | |
CommandCost | CmdMoveOrder (DoCommandFlag flags, VehicleID veh, VehicleOrderID moving_order, VehicleOrderID target_order) |
Move an order inside the orderlist. More... | |
CommandCost | CmdModifyOrder (DoCommandFlag flags, VehicleID veh, VehicleOrderID sel_ord, ModifyOrderFlags mof, uint16_t data) |
Modify an order in the orderlist of a vehicle. More... | |
static bool | CheckAircraftOrderDistance (const Aircraft *v_new, const Vehicle *v_order, const Order *first) |
Check if an aircraft has enough range for an order list. More... | |
CommandCost | CmdCloneOrder (DoCommandFlag flags, CloneOptions action, VehicleID veh_dst, VehicleID veh_src) |
Clone/share/copy an order-list of another vehicle. More... | |
CommandCost | CmdOrderRefit (DoCommandFlag flags, VehicleID veh, VehicleOrderID order_number, CargoID cargo) |
Add/remove refit orders from an order. More... | |
void | CheckOrders (const Vehicle *v) |
Check the orders of a vehicle, to see if there are invalid orders and stuff. | |
void | RemoveOrderFromAllVehicles (OrderType type, DestinationID destination, bool hangar) |
Removes an order from all vehicles. More... | |
void | DeleteVehicleOrders (Vehicle *v, bool keep_orderlist, bool reset_order_indices) |
Delete all orders from a vehicle. More... | |
uint16_t | GetServiceIntervalClamped (int interval, bool ispercent) |
Clamp the service interval to the correct min/max. More... | |
static bool | CheckForValidOrders (const Vehicle *v) |
Check if a vehicle has any valid orders. More... | |
static bool | OrderConditionCompare (OrderConditionComparator occ, int variable, int value) |
Compare the variable and value based on the given comparator. | |
template<typename T , std::enable_if_t< std::is_base_of< StrongTypedefBase, T >::value, int > = 0> | |
static bool | OrderConditionCompare (OrderConditionComparator occ, T variable, int value) |
VehicleOrderID | ProcessConditionalOrder (const Order *order, const Vehicle *v) |
Process a conditional order and determine the next order. More... | |
bool | UpdateOrderDest (Vehicle *v, const Order *order, int conditional_depth, bool pbs_look_ahead) |
Update the vehicle's destination tile from an order. More... | |
bool | ProcessOrders (Vehicle *v) |
Handle the orders of a vehicle and determine the next place to go to if needed. More... | |
Variables | |
OrderPool | _order_pool ("Order") |
OrderListPool | _orderlist_pool ("OrderList") |
Handling of orders.
Definition in file order_cmd.cpp.
|
static |
Cancel the current loading order of the vehicle as the order was deleted.
v | the vehicle |
Definition at line 1021 of file order_cmd.cpp.
References Vehicle::current_order, and Order::IsType().
|
static |
Check if an aircraft has enough range for an order list.
v_new | Aircraft to check. |
v_order | Vehicle currently holding the order list. |
first | First order in the source order list. |
Definition at line 1492 of file order_cmd.cpp.
References AircraftCache::cached_max_range, and Order::next.
|
static |
Check if a vehicle has any valid orders.
Definition at line 1921 of file order_cmd.cpp.
References Vehicle::Orders().
CommandCost CmdCloneOrder | ( | DoCommandFlag | flags, |
CloneOptions | action, | ||
VehicleID | veh_dst, | ||
VehicleID | veh_src | ||
) |
Clone/share/copy an order-list of another vehicle.
flags | operation to perform |
action | action to perform |
veh_dst | destination vehicle to clone orders to |
veh_src | source vehicle to clone orders from, if any (none for CO_UNSHARE) |
Definition at line 1522 of file order_cmd.cpp.
References CheckOwnership(), CMD_ERROR, CommandCost::Failed(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Vehicle::IsPrimaryVehicle(), and Vehicle::owner.
CommandCost CmdDeleteOrder | ( | DoCommandFlag | flags, |
VehicleID | veh_id, | ||
VehicleOrderID | sel_ord | ||
) |
Delete an order from the orderlist of a vehicle.
flags | operation to perform |
veh_id | the ID of the vehicle |
sel_ord | the order to delete (max 255) |
Definition at line 999 of file order_cmd.cpp.
References CheckOwnership(), CMD_ERROR, DC_EXEC, DecloneOrder(), DeleteOrder(), CommandCost::Failed(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Vehicle::GetNumOrders(), Vehicle::GetOrder(), Vehicle::IsPrimaryVehicle(), and Vehicle::owner.
CommandCost CmdInsertOrder | ( | DoCommandFlag | flags, |
VehicleID | veh, | ||
VehicleOrderID | sel_ord, | ||
const Order & | new_order | ||
) |
Add an order to the orderlist of a vehicle.
flags | operation to perform |
veh | ID of the vehicle |
sel_ord | the selected order (if any). If the last order is given, the order will be inserted before that one the maximum vehicle order id is 254. |
new_order | order to insert |
Definition at line 697 of file order_cmd.cpp.
References CARGO_NO_REFIT, CheckOwnership(), CMD_ERROR, CommandCost::Failed(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Order::GetMaxSpeed(), Order::GetRefitCargo(), Order::GetTravelTime(), Order::GetType(), Order::GetWaitTime(), Vehicle::IsPrimaryVehicle(), and Vehicle::owner.
CommandCost CmdModifyOrder | ( | DoCommandFlag | flags, |
VehicleID | veh, | ||
VehicleOrderID | sel_ord, | ||
ModifyOrderFlags | mof, | ||
uint16_t | data | ||
) |
Modify an order in the orderlist of a vehicle.
flags | operation to perform |
veh | ID of the vehicle |
sel_ord | the selected order (if any). If the last order is given, the order will be inserted before that one the maximum vehicle order id is 254. |
mof | what data to modify ( |
data | the data to modify |
Definition at line 1237 of file order_cmd.cpp.
CommandCost CmdMoveOrder | ( | DoCommandFlag | flags, |
VehicleID | veh, | ||
VehicleOrderID | moving_order, | ||
VehicleOrderID | target_order | ||
) |
Move an order inside the orderlist.
flags | operation to perform |
veh | the ID of the vehicle |
moving_order | the order to move |
target_order | the target order |
Definition at line 1139 of file order_cmd.cpp.
References CheckOwnership(), CMD_ERROR, BaseConsist::cur_implicit_order_index, BaseConsist::cur_real_order_index, DC_EXEC, DeleteOrderWarnings(), CommandCost::Failed(), Vehicle::FirstShared(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Vehicle::GetNumOrders(), Vehicle::GetOrder(), InvalidateVehicleOrder(), Vehicle::IsPrimaryVehicle(), OrderList::MoveOrder(), Vehicle::NextShared(), Vehicle::orders, Vehicle::Orders(), Vehicle::owner, and BaseConsist::ResetDepotUnbunching().
CommandCost CmdOrderRefit | ( | DoCommandFlag | flags, |
VehicleID | veh, | ||
VehicleOrderID | order_number, | ||
CargoID | cargo | ||
) |
Add/remove refit orders from an order.
flags | operation to perform |
veh | VehicleIndex of the vehicle having the order |
order_number | number of order to modify |
cargo | CargoID |
Definition at line 1664 of file order_cmd.cpp.
References CARGO_AUTO_REFIT, CARGO_NO_REFIT, CheckOwnership(), CMD_ERROR, CommandCost::Failed(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Vehicle::GetOrder(), Vehicle::IsPrimaryVehicle(), Order::IsType(), NUM_CARGO, and Vehicle::owner.
CommandCost CmdSkipToOrder | ( | DoCommandFlag | flags, |
VehicleID | veh_id, | ||
VehicleOrderID | sel_ord | ||
) |
Goto order of order-list.
flags | operation to perform |
veh_id | The ID of the vehicle which order is skipped |
sel_ord | the selected order to which we want to skip |
Definition at line 1101 of file order_cmd.cpp.
References CheckOwnership(), CMD_ERROR, BaseConsist::cur_implicit_order_index, Vehicle::current_order, DC_EXEC, CommandCost::Failed(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Vehicle::GetNumOrders(), Vehicle::IsPrimaryVehicle(), Order::IsType(), and Vehicle::owner.
|
static |
Declone an order-list.
*dst | delete the orders of this vehicle |
flags | execution flags |
Definition at line 982 of file order_cmd.cpp.
References DC_EXEC, DeleteVehicleOrders(), GetWindowClassForVehicleType(), InvalidateVehicleOrder(), InvalidateWindowClassesData(), BaseVehicle::type, and VIWD_REMOVE_ALL_ORDERS.
Referenced by CmdDeleteOrder().
void DeleteOrder | ( | Vehicle * | v, |
VehicleOrderID | sel_ord | ||
) |
Delete an order but skip the parameter validation.
v | The vehicle to delete the order from. |
sel_ord | The id of the order to be deleted. |
Definition at line 1037 of file order_cmd.cpp.
References BaseConsist::cur_real_order_index, Vehicle::current_order, OrderList::DeleteOrderAt(), DeleteOrderWarnings(), Vehicle::FirstShared(), Order::IsType(), Vehicle::NextShared(), and Vehicle::orders.
Referenced by CmdDeleteOrder().
void DeleteVehicleOrders | ( | Vehicle * | v, |
bool | keep_orderlist, | ||
bool | reset_order_indices | ||
) |
Delete all orders from a vehicle.
v | Vehicle whose orders to reset |
keep_orderlist | If true, do not free the order list, only empty it. |
reset_order_indices | If true, reset cur_implicit_order_index and cur_real_order_index and cancel the current full load order (if the vehicle is loading). If false, you have to make sure the order indices are valid after your messing with them! |
Definition at line 1869 of file order_cmd.cpp.
References BaseConsist::cur_implicit_order_index, BaseConsist::cur_real_order_index, Vehicle::current_order, DeleteOrderWarnings(), OrderList::FreeChain(), Vehicle::IsOrderListShared(), Order::IsType(), Vehicle::orders, Vehicle::RemoveFromShared(), and BaseConsist::ResetDepotUnbunching().
Referenced by CmdSellRailWagon(), and DecloneOrder().
uint GetOrderDistance | ( | const Order * | prev, |
const Order * | cur, | ||
const Vehicle * | v, | ||
int | conditional_depth | ||
) |
Get the distance between two orders of a vehicle.
Conditional orders are resolved and the bigger distance of the two order branches is returned.
prev | Origin order. |
cur | Destination order. |
v | The vehicle to get the distance for. |
conditional_depth | Internal param for resolving conditional orders. |
Definition at line 669 of file order_cmd.cpp.
References Order::IsType().
uint16_t GetServiceIntervalClamped | ( | int | interval, |
bool | ispercent | ||
) |
Clamp the service interval to the correct min/max.
The actual min/max values depend on whether it's in days, minutes, or percent.
interval | The proposed service interval. |
ispercent | Whether the interval is a percent. |
Definition at line 1901 of file order_cmd.cpp.
void InsertOrder | ( | Vehicle * | v, |
Order * | new_o, | ||
VehicleOrderID | sel_ord | ||
) |
Insert a new order but skip the validation.
v | The vehicle to insert the order to. |
new_o | The new order. |
sel_ord | The position the order should be inserted at. |
Definition at line 912 of file order_cmd.cpp.
References BaseConsist::cur_implicit_order_index, BaseConsist::cur_real_order_index, DeleteOrderWarnings(), Vehicle::FirstShared(), OrderList::InsertOrderAt(), Vehicle::IsGroundVehicle(), Vehicle::NextShared(), and Vehicle::orders.
Checks whether the order goes to a station or not, i.e.
whether the destination is a station
v | the vehicle to check for |
o | the order to check |
Definition at line 615 of file order_cmd.cpp.
References Order::IsType().
VehicleOrderID ProcessConditionalOrder | ( | const Order * | order, |
const Vehicle * | v | ||
) |
Process a conditional order and determine the next order.
order | the order the vehicle currently has |
v | the vehicle to update |
Definition at line 1968 of file order_cmd.cpp.
References Order::GetType().
bool ProcessOrders | ( | Vehicle * | v | ) |
Handle the orders of a vehicle and determine the next place to go to if needed.
v | the vehicle to do this for. |
Reversing because of order change is allowed only just after leaving a station (and the difficulty setting to allowed, of course) this can be detected because only after OT_LEAVESTATION, current_order will be reset to nothing. (That also happens if no order, but in that case it won't hit the point in code where may_reverse is checked)
Definition at line 2127 of file order_cmd.cpp.
References Vehicle::current_order, and Order::GetType().
void RemoveOrderFromAllVehicles | ( | OrderType | type, |
DestinationID | destination, | ||
bool | hangar | ||
) |
Removes an order from all vehicles.
Triggers when, say, a station is removed.
type | The type of the order (OT_GOTO_[STATION|DEPOT|WAYPOINT]). |
destination | The destination. Can be a StationID, DepotID or WaypointID. |
hangar | Only used for airports in the destination. When false, remove airport and hangar orders. When true, remove either airport or hangar order. |
Definition at line 1787 of file order_cmd.cpp.
References Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::Iterate(), and VEH_AIRCRAFT.
Referenced by Depot::~Depot().
bool UpdateOrderDest | ( | Vehicle * | v, |
const Order * | order, | ||
int | conditional_depth, | ||
bool | pbs_look_ahead | ||
) |
Update the vehicle's destination tile from an order.
order | the order the vehicle currently has |
v | the vehicle to update |
conditional_depth | the depth (amount of steps) to go with conditional orders. This to prevent infinite loops. |
pbs_look_ahead | Whether we are forecasting orders for pbs reservations in advance. If true, the order indices must not be modified. |
Definition at line 1998 of file order_cmd.cpp.
References Vehicle::current_order, Order::Free(), Vehicle::GetNumOrders(), and Order::GetType().