Commands related to time tabling. More...

#include "stdafx.h"
#include "command_func.h"
#include "company_func.h"
#include "timer/timer_game_tick.h"
#include "timer/timer_game_economy.h"
#include "window_func.h"
#include "vehicle_base.h"
#include "timetable_cmd.h"
#include "timetable.h"
#include "table/strings.h"
#include "safeguards.h"

Functions
TimerGameTick::TickCounter	GetStartTickFromDate (TimerGameEconomy::Date start_date)
	Get the TimerGameTick::TickCounter tick of a given date.

TimerGameEconomy::Date	GetDateFromStartTick (TimerGameTick::TickCounter start_tick)
	Get a date from a given start tick of timetable.

static void	ChangeTimetable (Vehicle *v, VehicleOrderID order_number, uint16_t val, ModifyTimetableFlags mtf, bool timetabled)
	Change/update a particular timetable entry.

CommandCost	CmdChangeTimetable (DoCommandFlag flags, VehicleID veh, VehicleOrderID order_number, ModifyTimetableFlags mtf, uint16_t data)
	Change timetable data of an order.

CommandCost	CmdBulkChangeTimetable (DoCommandFlag flags, VehicleID veh, ModifyTimetableFlags mtf, uint16_t data)
	Change timetable data of all orders of a vehicle.

CommandCost	CmdSetVehicleOnTime (DoCommandFlag flags, VehicleID veh, bool apply_to_group)
	Clear the lateness counter to make the vehicle on time.

static bool	VehicleTimetableSorter (Vehicle const &a, Vehicle const &b)
	Order vehicles based on their timetable.

CommandCost	CmdSetTimetableStart (DoCommandFlag flags, VehicleID veh_id, bool timetable_all, TimerGameTick::TickCounter start_tick)
	Set the start date of the timetable.

CommandCost	CmdAutofillTimetable (DoCommandFlag flags, VehicleID veh, bool autofill, bool preserve_wait_time)
	Start or stop filling the timetable automatically from the time the vehicle actually takes to complete it.

void	UpdateVehicleTimetable (Vehicle *v, bool travelling)
	Update the timetable for the vehicle.

Detailed Description

Commands related to time tabling.

Definition in file timetable_cmd.cpp.

Function Documentation

◆ ChangeTimetable()

static void ChangeTimetable	(	Vehicle *	v,
		VehicleOrderID	order_number,
		uint16_t	val,
		ModifyTimetableFlags	mtf,
		bool	timetabled
	)

static

Change/update a particular timetable entry.

Parameters

v	The vehicle to change the timetable of.
order_number	The index of the timetable in the order list.
val	The new data of the timetable entry.
mtf	Which part of the timetable entry to change.
timetabled	If the new value is explicitly timetabled.

Definition at line 66 of file timetable_cmd.cpp.

References BaseConsist::cur_real_order_index, Vehicle::current_order, Order::Equals(), Vehicle::FirstShared(), Vehicle::GetOrder(), Order::GetTimetabledTravel(), Order::GetTimetabledWait(), Order::GetTravelTime(), Order::GetWaitTime(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, MTF_TRAVEL_SPEED, MTF_TRAVEL_TIME, MTF_WAIT_TIME, Vehicle::NextShared(), Vehicle::orders, Order::SetMaxSpeed(), Order::SetTravelTime(), Order::SetTravelTimetabled(), Order::SetWaitTime(), Order::SetWaitTimetabled(), SetWindowDirty(), OrderList::UpdateTimetableDuration(), OrderList::UpdateTotalDuration(), and WC_VEHICLE_TIMETABLE.

Referenced by CmdChangeTimetable(), and UpdateVehicleTimetable().

◆ CmdAutofillTimetable()

CommandCost CmdAutofillTimetable	(	DoCommandFlag	flags,
		VehicleID	veh,
		bool	autofill,
		bool	preserve_wait_time
	)

Start or stop filling the timetable automatically from the time the vehicle actually takes to complete it.

When starting to autofill the current times are cleared and the timetable will start again from scratch.

Parameters

flags	Operation to perform.
veh	Vehicle index.
autofill	Enable or disable autofill
preserve_wait_time	Set to preserve waiting times in non-destructive mode

Returns: the cost of this operation or an error

Definition at line 425 of file timetable_cmd.cpp.

References CheckOwnership(), ClrBit(), CMD_ERROR, DC_EXEC, CommandCost::Failed(), Vehicle::FirstShared(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Vehicle::IsPrimaryVehicle(), BaseConsist::lateness_counter, Vehicle::orders, Vehicle::owner, SetBit(), SetWindowDirty(), BaseConsist::timetable_start, BaseConsist::vehicle_flags, VF_AUTOFILL_PRES_WAIT_TIME, VF_AUTOFILL_TIMETABLE, VF_TIMETABLE_STARTED, and WC_VEHICLE_TIMETABLE.

◆ CmdBulkChangeTimetable()

CommandCost CmdBulkChangeTimetable	(	DoCommandFlag	flags,
		VehicleID	veh,
		ModifyTimetableFlags	mtf,
		uint16_t	data
	)

Change timetable data of all orders of a vehicle.

Parameters

flags	Operation to perform.
veh	Vehicle with the orders to change.
mtf	Timetable data to change (

See also: ModifyTimetableFlags)

Parameters

data	The data to modify as specified by `mtf`. 0 to clear times, UINT16_MAX to clear speed limit.

Returns: the cost of this operation or an error

Definition at line 228 of file timetable_cmd.cpp.

References CheckOwnership(), CMD_ERROR, DC_EXEC, CommandCost::Failed(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Vehicle::GetNumOrders(), Vehicle::GetOrder(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, Vehicle::IsPrimaryVehicle(), Order::IsType(), and Vehicle::owner.

◆ CmdChangeTimetable()

CommandCost CmdChangeTimetable	(	DoCommandFlag	flags,
		VehicleID	veh,
		VehicleOrderID	order_number,
		ModifyTimetableFlags	mtf,
		uint16_t	data
	)

Change timetable data of an order.

Parameters

flags	Operation to perform.
veh	Vehicle with the orders to change.
order_number	Order index to modify.
mtf	Timetable data to change (

See also: ModifyTimetableFlags)

Parameters

data	The data to modify as specified by `mtf`. 0 to clear times, UINT16_MAX to clear speed limit.

Returns: the cost of this operation or an error

Definition at line 133 of file timetable_cmd.cpp.

References ChangeTimetable(), CheckOwnership(), CMD_ERROR, DC_EXEC, CommandCost::Failed(), Vehicle::FirstShared(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::GetIfValid(), Order::GetMaxSpeed(), Order::GetNonStopType(), Vehicle::GetOrder(), Order::GetTravelTime(), Order::GetType(), Order::GetWaitTime(), Vehicle::IsPrimaryVehicle(), Order::IsTravelTimetabled(), Order::IsType(), Order::IsWaitTimetabled(), MTF_TRAVEL_SPEED, MTF_TRAVEL_TIME, MTF_WAIT_TIME, Vehicle::NextShared(), ONSF_NO_STOP_AT_DESTINATION_STATION, Vehicle::owner, BaseConsist::ResetDepotUnbunching(), BaseVehicle::type, and VEH_AIRCRAFT.

◆ CmdSetTimetableStart()

CommandCost CmdSetTimetableStart	(	DoCommandFlag	flags,
		VehicleID	veh_id,
		bool	timetable_all,
		TimerGameTick::TickCounter	start_tick
	)

Set the start date of the timetable.

Parameters

flags	Operation to perform.
veh_id	Vehicle ID.
timetable_all	Set to set timetable start for all vehicles sharing this order
start_tick	The TimerGameTick::counter tick when the timetable starts.