OpenTTD Source 20260108-master-g8ba1860eaa
order_backup.cpp
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
6 */
7
10#include "stdafx.h"
11#include "command_func.h"
12#include "core/pool_func.hpp"
13#include "network/network.h"
15#include "order_backup.h"
16#include "vehicle_base.h"
17#include "window_func.h"
18#include "station_map.h"
19#include "order_cmd.h"
20#include "group_cmd.h"
21#include "vehicle_func.h"
22
23#include "table/strings.h"
24
25#include "safeguards.h"
26
27OrderBackupPool _order_backup_pool("BackupOrder");
29
30OrderBackup::~OrderBackup() = default;
31
37 OrderBackupPool::PoolItem<&_order_backup_pool>(index)
38{
39}
40
47OrderBackup::OrderBackup(OrderBackupID index, const Vehicle *v, uint32_t user) :
48 OrderBackupPool::PoolItem<&_order_backup_pool>(index), user(user), tile(v->tile), group(v->group_id)
49{
51
52 /* If we have shared orders, store the vehicle we share the order with. */
53 if (v->IsOrderListShared()) {
54 this->clone = (v->FirstShared() == v) ? v->NextShared() : v->FirstShared();
55 } else {
56 /* Else copy the orders */
57 this->orders.assign(std::begin(v->Orders()), std::end(v->Orders()));
58 }
59}
60
66{
67 /* If we had shared orders, recover that */
68 if (this->clone != nullptr) {
69 Command<CMD_CLONE_ORDER>::Do(DoCommandFlag::Execute, CO_SHARE, v->index, this->clone->index);
70 } else if (!this->orders.empty() && OrderList::CanAllocateItem()) {
71 v->orders = OrderList::Create(std::move(this->orders), v);
72 /* Make sure buoys/oil rigs are updated in the station list. */
74 }
75
76 /* Remove backed up name if it's no longer unique. */
77 if (!IsUniqueVehicleName(this->name)) this->name.clear();
78
80
81 /* Make sure orders are in range */
84
85 /* Restore vehicle group */
87}
88
95/* static */ void OrderBackup::Backup(const Vehicle *v, uint32_t user)
96{
97 /* Don't use reset as that broadcasts over the network to reset the variable,
98 * which is what we are doing at the moment. */
99 for (OrderBackup *ob : OrderBackup::Iterate()) {
100 if (ob->user == user) delete ob;
101 }
104 }
105}
106
113/* static */ void OrderBackup::Restore(Vehicle *v, uint32_t user)
114{
115 for (OrderBackup *ob : OrderBackup::Iterate()) {
116 if (v->tile != ob->tile || ob->user != user) continue;
117
118 ob->DoRestore(v);
119 delete ob;
120 }
121}
122
129/* static */ void OrderBackup::ResetOfUser(TileIndex tile, uint32_t user)
130{
131 for (OrderBackup *ob : OrderBackup::Iterate()) {
132 if (ob->user == user && (ob->tile == tile || tile == INVALID_TILE)) delete ob;
133 }
134}
135
144{
145 /* No need to check anything. If the tile or user don't exist we just ignore it. */
146 if (flags.Test(DoCommandFlag::Execute)) OrderBackup::ResetOfUser(tile == 0 ? INVALID_TILE : tile, user_id);
147
148 return CommandCost();
149}
150
157/* static */ void OrderBackup::ResetUser(uint32_t user)
158{
159 assert(_network_server);
160
161 for (OrderBackup *ob : OrderBackup::Iterate()) {
162 /* If it's not a backup of us, ignore it. */
163 if (ob->user != user) continue;
164
166 return;
167 }
168}
169
176/* static */ void OrderBackup::Reset(TileIndex t, bool from_gui)
177{
178 /* The user has CLIENT_ID_SERVER as default when network play is not active,
179 * but compiled it. A network client has its own variable for the unique
180 * client/user identifier. Finally if networking isn't compiled in the
181 * default is just plain and simple: 0. */
183
184 for (OrderBackup *ob : OrderBackup::Iterate()) {
185 /* If this is a GUI action, and it's not a backup of us, ignore it. */
186 if (from_gui && ob->user != user) continue;
187 /* If it's not for our chosen tile either, ignore it. */
188 if (t != INVALID_TILE && t != ob->tile) continue;
189
190 if (from_gui) {
191 /* We need to circumvent the "prevention" from this command being executed
192 * while the game is paused, so use the internal method. Nor do we want
193 * this command to get its cost estimated when shift is pressed. */
194 Command<CMD_CLEAR_ORDER_BACKUP>::Unsafe<CommandCallback>(STR_NULL, nullptr, true, false, ob->tile, CommandTraits<CMD_CLEAR_ORDER_BACKUP>::Args{ ob->tile, static_cast<ClientID>(user) });
195 } else {
196 /* The command came from the game logic, i.e. the clearing of a tile.
197 * In that case we have no need to actually sync this, just do it. */
198 delete ob;
199 }
200 }
201}
202
207/* static */ void OrderBackup::ClearGroup(GroupID group)
208{
209 for (OrderBackup *ob : OrderBackup::Iterate()) {
210 if (ob->group == group) ob->group = DEFAULT_GROUP;
211 }
212}
213
221/* static */ void OrderBackup::ClearVehicle(const Vehicle *v)
222{
223 assert(v != nullptr);
224 for (OrderBackup *ob : OrderBackup::Iterate()) {
225 if (ob->clone == v) {
226 /* Get another item in the shared list. */
227 ob->clone = (v->FirstShared() == v) ? v->NextShared() : v->FirstShared();
228 /* But if that isn't there, remove it. */
229 if (ob->clone == nullptr) delete ob;
230 }
231 }
232}
233
242/* static */ void OrderBackup::RemoveOrder(OrderType type, DestinationID destination, bool hangar)
243{
244 for (OrderBackup *ob : OrderBackup::Iterate()) {
245 for (Order &order : ob->orders) {
246 OrderType ot = order.GetType();
247 if (ot == OT_GOTO_DEPOT && order.GetDepotActionType().Test(OrderDepotActionFlag::NearestDepot)) continue;
248 if (ot == OT_GOTO_DEPOT && hangar && !IsHangarTile(ob->tile)) continue; // Not an aircraft? Can't have a hangar order.
249 if (ot == OT_IMPLICIT || (IsHangarTile(ob->tile) && ot == OT_GOTO_DEPOT && !hangar)) ot = OT_GOTO_STATION;
250 if (ot == type && order.GetDestination() == destination) {
251 /* Remove the order backup! If a station/depot gets removed, we can't/shouldn't restore those broken orders. */
252 delete ob;
253 break;
254 }
255 }
256 }
257}
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
Common return value for all commands.
Enum-as-bit-set wrapper.
Functions related to commands.
@ Execute
execute the given command
Command definitions related to engine groups.
static constexpr GroupID DEFAULT_GROUP
Ungrouped vehicles are in this group.
Definition group_type.h:18
bool _networking
are we in networking mode?
Definition network.cpp:66
bool _network_server
network-server is active
Definition network.cpp:67
ClientID _network_own_client_id
Our client identifier.
Definition network.cpp:71
Basic functions/variables used all over the place.
Network functions used by other parts of OpenTTD.
ClientID
'Unique' identifier to be given to clients
@ CLIENT_ID_SERVER
Servers always have this ID.
CommandCost CmdClearOrderBackup(DoCommandFlags flags, TileIndex tile, ClientID user_id)
Clear an OrderBackup.
Functions related to order backups.
Command definitions related to orders.
@ NearestDepot
Send the vehicle to the nearest depot.
OrderType
Order types.
Definition order_type.h:50
Some methods of Pool are placed here in order to reduce compilation time and binary size.
#define INSTANTIATE_POOL_METHODS(name)
Force instantiation of pool methods so we don't get linker errors.
A number of safeguards to prevent using unsafe methods.
Maps accessors for stations.
bool IsHangarTile(Tile t)
Is tile t an hangar tile?
Definition of base types and functions in a cross-platform compatible way.
std::string name
Name of vehicle.
VehicleOrderID cur_real_order_index
The index to the current real (non-implicit) order.
VehicleOrderID cur_implicit_order_index
The index to the current implicit order.
void CopyConsistPropertiesFrom(const BaseConsist *src)
Copy properties of other BaseConsist.
Defines the traits of a command.
Data for backing up an order of a vehicle so it can be restored after a vehicle is rebuilt in the sam...
static void Reset(TileIndex tile=INVALID_TILE, bool from_gui=true)
Reset the OrderBackups from GUI/game logic.
static void Restore(Vehicle *v, uint32_t user)
Restore the data of this order to the given vehicle.
void DoRestore(Vehicle *v)
Restore the data of this order to the given vehicle.
static void Backup(const Vehicle *v, uint32_t user)
Create an order backup for the given vehicle.
static void ClearVehicle(const Vehicle *v)
Clear/update the (clone) vehicle from an order backup.
OrderBackup(OrderBackupID index)
Create an order backup for savegame loading.
const Vehicle * clone
Vehicle this vehicle was a clone of.
TileIndex tile
Tile of the depot where the order was changed.
uint32_t user
The user that requested the backup.
static void ClearGroup(GroupID group)
Clear the group of all backups having this group ID.
GroupID group
The group the vehicle was part of.
static void ResetOfUser(TileIndex tile, uint32_t user)
Reset an OrderBackup given a tile and user.
static void ResetUser(uint32_t user)
Reset an user's OrderBackup if needed.
std::vector< Order > orders
The actual orders if the vehicle was not a clone.
static void RemoveOrder(OrderType type, DestinationID destination, bool hangar)
Removes an order from all vehicles.
Templated helper to make a PoolID a single POD value.
Definition pool_type.hpp:47
static Pool::IterateWrapper< Titem > Iterate(size_t from=0)
Returns an iterable ensemble of all valid Titem.
static T * Create(Targs &&... args)
Creates a new T-object in the associated pool.
static bool CanAllocateItem(size_t n=1)
Helper functions so we can use PoolItem::Function() instead of _poolitem_pool.Function()
const Tindex index
Index of this pool item.
Base class for all pools.
The information about a vehicle list.
Definition vehiclelist.h:32
Vehicle data structure.
bool IsOrderListShared() const
Check if we share our orders with another vehicle.
VehicleOrderID GetNumOrders() const
Get the number of orders this vehicle has.
OrderList * orders
Pointer to the order list for this vehicle.
Vehicle * NextShared() const
Get the next vehicle of the shared vehicle chain.
Vehicle * FirstShared() const
Get the first vehicle of this vehicle chain.
TileIndex tile
Current tile index.
void UpdateRealOrderIndex()
Skip implicit orders until cur_real_order_index is a non-implicit order.
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
Definition tile_type.h:95
Base class for all vehicles.
bool IsUniqueVehicleName(const std::string &name)
Test if a name is unique among vehicle names.
Functions related to vehicles.
void InvalidateWindowClassesData(WindowClass cls, int data, bool gui_scope)
Mark window data of all windows of a given class as invalid (in need of re-computing) Note that by de...
Definition window.cpp:3318
Window functions not directly related to making/drawing windows.
@ WC_STATION_LIST
Station list; Window numbers: