OpenTTD Source  20240919-master-gdf0233f4c2
order_sl.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 <http://www.gnu.org/licenses/>.
6  */
7 
10 #include "../stdafx.h"
11 
12 #include "saveload.h"
13 #include "compat/order_sl_compat.h"
14 
15 #include "saveload_internal.h"
16 #include "../order_backup.h"
17 #include "../settings_type.h"
18 #include "../network/network.h"
19 
20 #include "../safeguards.h"
21 
27 {
28  uint8_t old_flags = this->flags;
29  this->flags = 0;
30 
31  /* First handle non-stop - use value from savegame if possible, else use value from config file */
33  /* OFB_NON_STOP */
35  } else {
37  }
38 
39  switch (this->GetType()) {
40  /* Only a few types need the other savegame conversions. */
41  case OT_GOTO_DEPOT: case OT_GOTO_STATION: case OT_LOADING: break;
42  default: return;
43  }
44 
45  if (this->GetType() != OT_GOTO_DEPOT) {
46  /* Then the load flags */
47  if ((old_flags & 2) != 0) { // OFB_UNLOAD
49  } else if ((old_flags & 4) == 0) { // !OFB_FULL_LOAD
51  } else {
52  /* old OTTD versions stored full_load_any in config file - assume it was enabled when loading */
54  }
55 
56  if (this->IsType(OT_GOTO_STATION)) this->SetStopLocation(OSL_PLATFORM_FAR_END);
57 
58  /* Finally fix the unload flags */
59  if ((old_flags & 1) != 0) { // OFB_TRANSFER
61  } else if ((old_flags & 2) != 0) { // OFB_UNLOAD
63  } else {
65  }
66  } else {
67  /* Then the depot action flags */
68  this->SetDepotActionType(((old_flags & 6) == 4) ? ODATFB_HALT : ODATF_SERVICE_ONLY);
69 
70  /* Finally fix the depot type flags */
71  uint t = ((old_flags & 6) == 6) ? ODTFB_SERVICE : ODTF_MANUAL;
72  if ((old_flags & 2) != 0) t |= ODTFB_PART_OF_ORDERS;
74  }
75 }
76 
82 static Order UnpackVersion4Order(uint16_t packed)
83 {
84  return Order(GB(packed, 0, 4), GB(packed, 4, 4), GB(packed, 8, 8));
85 }
86 
92 Order UnpackOldOrder(uint16_t packed)
93 {
94  Order order = UnpackVersion4Order(packed);
95 
96  /*
97  * Sanity check
98  * TTD stores invalid orders as OT_NOTHING with non-zero flags/station
99  */
100  if (order.IsType(OT_NOTHING) && packed != 0) order.MakeDummy();
101 
102  return order;
103 }
104 
105 SaveLoadTable GetOrderDescription()
106 {
107  static const SaveLoad _order_desc[] = {
108  SLE_VAR(Order, type, SLE_UINT8),
109  SLE_VAR(Order, flags, SLE_UINT8),
110  SLE_VAR(Order, dest, SLE_UINT16),
111  SLE_REF(Order, next, REF_ORDER),
112  SLE_CONDVAR(Order, refit_cargo, SLE_UINT8, SLV_36, SL_MAX_VERSION),
113  SLE_CONDVAR(Order, wait_time, SLE_UINT16, SLV_67, SL_MAX_VERSION),
114  SLE_CONDVAR(Order, travel_time, SLE_UINT16, SLV_67, SL_MAX_VERSION),
115  SLE_CONDVAR(Order, max_speed, SLE_UINT16, SLV_172, SL_MAX_VERSION),
116  };
117 
118  return _order_desc;
119 }
120 
122  ORDRChunkHandler() : ChunkHandler('ORDR', CH_TABLE) {}
123 
124  void Save() const override
125  {
126  const SaveLoadTable slt = GetOrderDescription();
127  SlTableHeader(slt);
128 
129  for (Order *order : Order::Iterate()) {
130  SlSetArrayIndex(order->index);
131  SlObject(order, slt);
132  }
133  }
134 
135  void Load() const override
136  {
137  if (IsSavegameVersionBefore(SLV_5, 2)) {
138  /* Version older than 5.2 did not have a ->next pointer. Convert them
139  * (in the old days, the orderlist was 5000 items big) */
140  size_t len = SlGetFieldLength();
141 
143  /* Pre-version 5 had another layout for orders
144  * (uint16_t instead of uint32_t) */
145  len /= sizeof(uint16_t);
146  std::vector<uint16_t> orders(len);
147 
148  SlCopy(&orders[0], len, SLE_UINT16);
149 
150  for (size_t i = 0; i < len; ++i) {
151  Order *o = new (i) Order();
152  o->AssignOrder(UnpackVersion4Order(orders[i]));
153  }
154  } else if (IsSavegameVersionBefore(SLV_5, 2)) {
155  len /= sizeof(uint32_t);
156  std::vector<uint32_t> orders(len);
157 
158  SlCopy(&orders[0], len, SLE_UINT32);
159 
160  for (size_t i = 0; i < len; ++i) {
161  new (i) Order(GB(orders[i], 0, 8), GB(orders[i], 8, 8), GB(orders[i], 16, 16));
162  }
163  }
164 
165  /* Update all the next pointer */
166  for (Order *o : Order::Iterate()) {
167  size_t order_index = o->index;
168  /* Delete invalid orders */
169  if (o->IsType(OT_NOTHING)) {
170  delete o;
171  continue;
172  }
173  /* The orders were built like this:
174  * While the order is valid, set the previous will get its next pointer set */
175  Order *prev = Order::GetIfValid(order_index - 1);
176  if (prev != nullptr) prev->next = o;
177  }
178  } else {
179  const std::vector<SaveLoad> slt = SlCompatTableHeader(GetOrderDescription(), _order_sl_compat);
180 
181  int index;
182 
183  while ((index = SlIterateArray()) != -1) {
184  Order *order = new (index) Order();
185  SlObject(order, slt);
186  }
187  }
188  }
189 
190  void FixPointers() const override
191  {
192  /* Orders from old savegames have pointers corrected in Load_ORDR */
193  if (IsSavegameVersionBefore(SLV_5, 2)) return;
194 
195  for (Order *o : Order::Iterate()) {
196  SlObject(o, GetOrderDescription());
197  }
198  }
199 };
200 
201 SaveLoadTable GetOrderListDescription()
202 {
203  static const SaveLoad _orderlist_desc[] = {
204  SLE_REF(OrderList, first, REF_ORDER),
205  };
206 
207  return _orderlist_desc;
208 }
209 
211  ORDLChunkHandler() : ChunkHandler('ORDL', CH_TABLE) {}
212 
213  void Save() const override
214  {
215  const SaveLoadTable slt = GetOrderListDescription();
216  SlTableHeader(slt);
217 
218  for (OrderList *list : OrderList::Iterate()) {
219  SlSetArrayIndex(list->index);
220  SlObject(list, slt);
221  }
222  }
223 
224  void Load() const override
225  {
226  const std::vector<SaveLoad> slt = SlCompatTableHeader(GetOrderListDescription(), _orderlist_sl_compat);
227 
228  int index;
229 
230  while ((index = SlIterateArray()) != -1) {
231  /* set num_orders to 0 so it's a valid OrderList */
232  OrderList *list = new (index) OrderList(0);
233  SlObject(list, slt);
234  }
235 
236  }
237 
238  void FixPointers() const override
239  {
240  for (OrderList *list : OrderList::Iterate()) {
241  SlObject(list, GetOrderListDescription());
242  }
243  }
244 };
245 
246 SaveLoadTable GetOrderBackupDescription()
247 {
248  static const SaveLoad _order_backup_desc[] = {
249  SLE_VAR(OrderBackup, user, SLE_UINT32),
250  SLE_VAR(OrderBackup, tile, SLE_UINT32),
251  SLE_VAR(OrderBackup, group, SLE_UINT16),
252  SLE_CONDVAR(OrderBackup, service_interval, SLE_FILE_U32 | SLE_VAR_U16, SL_MIN_VERSION, SLV_192),
253  SLE_CONDVAR(OrderBackup, service_interval, SLE_UINT16, SLV_192, SL_MAX_VERSION),
254  SLE_SSTR(OrderBackup, name, SLE_STR),
256  SLE_VAR(OrderBackup, cur_real_order_index, SLE_UINT8),
257  SLE_CONDVAR(OrderBackup, cur_implicit_order_index, SLE_UINT8, SLV_176, SL_MAX_VERSION),
258  SLE_CONDVAR(OrderBackup, current_order_time, SLE_UINT32, SLV_176, SL_MAX_VERSION),
259  SLE_CONDVAR(OrderBackup, lateness_counter, SLE_INT32, SLV_176, SL_MAX_VERSION),
260  SLE_CONDVAR(OrderBackup, timetable_start, SLE_FILE_I32 | SLE_VAR_U64, SLV_176, SLV_TIMETABLE_START_TICKS_FIX),
262  SLE_CONDVAR(OrderBackup, vehicle_flags, SLE_FILE_U8 | SLE_VAR_U16, SLV_176, SLV_180),
263  SLE_CONDVAR(OrderBackup, vehicle_flags, SLE_UINT16, SLV_180, SL_MAX_VERSION),
264  SLE_REF(OrderBackup, orders, REF_ORDER),
265  };
266 
267  return _order_backup_desc;
268 }
269 
271  BKORChunkHandler() : ChunkHandler('BKOR', CH_TABLE) {}
272 
273  void Save() const override
274  {
275  const SaveLoadTable slt = GetOrderBackupDescription();
276  SlTableHeader(slt);
277 
278  /* We only save this when we're a network server
279  * as we want this information on our clients. For
280  * normal games this information isn't needed. */
281  if (!_networking || !_network_server) return;
282 
283  for (OrderBackup *ob : OrderBackup::Iterate()) {
284  SlSetArrayIndex(ob->index);
285  SlObject(ob, slt);
286  }
287  }
288 
289  void Load() const override
290  {
291  const std::vector<SaveLoad> slt = SlCompatTableHeader(GetOrderBackupDescription(), _order_backup_sl_compat);
292 
293  int index;
294 
295  while ((index = SlIterateArray()) != -1) {
296  /* set num_orders to 0 so it's a valid OrderList */
297  OrderBackup *ob = new (index) OrderBackup();
298  SlObject(ob, slt);
299  }
300  }
301 
302  void FixPointers() const override
303  {
304  for (OrderBackup *ob : OrderBackup::Iterate()) {
305  SlObject(ob, GetOrderBackupDescription());
306  }
307  }
308 };
309 
310 static const BKORChunkHandler BKOR;
311 static const ORDRChunkHandler ORDR;
312 static const ORDLChunkHandler ORDL;
313 static const ChunkHandlerRef order_chunk_handlers[] = {
314  BKOR,
315  ORDR,
316  ORDL,
317 };
318 
319 extern const ChunkHandlerTable _order_chunk_handlers(order_chunk_handlers);
Order::MakeDummy
void MakeDummy()
Makes this order a Dummy order.
Definition: order_cmd.cpp:133
REF_ORDER
@ REF_ORDER
Load/save a reference to an order.
Definition: saveload.h:593
OUFB_UNLOAD
@ OUFB_UNLOAD
Force unloading all cargo onto the platform, possibly not getting paid.
Definition: order_type.h:54
SLV_5
@ SLV_5
5.0 1429 5.1 1440 5.2 1525 0.3.6
Definition: saveload.h:43
Order::IsType
bool IsType(OrderType type) const
Check whether this order is of the given type.
Definition: order_base.h:70
_order_sl_compat
const SaveLoadCompat _order_sl_compat[]
Original field order for _order_desc.
Definition: order_sl_compat.h:16
Order::SetLoadType
void SetLoadType(OrderLoadFlags load_type)
Set how the consist must be loaded.
Definition: order_base.h:157
Pool::PoolItem<&_order_pool >::GetIfValid
static Titem * GetIfValid(size_t index)
Returns Titem with given index.
Definition: pool_type.hpp:350
ODTFB_SERVICE
@ ODTFB_SERVICE
This depot order is because of the servicing limit.
Definition: order_type.h:95
SaveLoadTable
std::span< const struct SaveLoad > SaveLoadTable
A table of SaveLoad entries.
Definition: saveload.h:507
OUFB_TRANSFER
@ OUFB_TRANSFER
Transfer all cargo onto the platform.
Definition: order_type.h:55
OLFB_FULL_LOAD
@ OLFB_FULL_LOAD
Full load all cargoes of the consist.
Definition: order_type.h:64
ORDRChunkHandler
Definition: order_sl.cpp:121
ChunkHandlerRef
std::reference_wrapper< const ChunkHandler > ChunkHandlerRef
A reference to ChunkHandler.
Definition: saveload.h:501
GUISettings::sg_new_nonstop
bool sg_new_nonstop
ttdpatch compatible nonstop handling read from pre v93 savegames
Definition: settings_type.h:144
SL_MIN_VERSION
@ SL_MIN_VERSION
First savegame version.
Definition: saveload.h:31
_network_server
bool _network_server
network-server is active
Definition: network.cpp:66
SlCopy
void SlCopy(void *object, size_t length, VarType conv)
Copy a list of SL_VARs to/from a savegame.
Definition: saveload.cpp:1029
GB
constexpr static debug_inline uint GB(const T x, const uint8_t s, const uint8_t n)
Fetch n bits from x, started at bit s.
Definition: bitmath_func.hpp:32
GUISettings::new_nonstop
bool new_nonstop
ttdpatch compatible nonstop handling
Definition: settings_type.h:145
Pool::PoolItem::index
Tindex index
Index of this pool item.
Definition: pool_type.hpp:238
SLE_CONDVAR
#define SLE_CONDVAR(base, variable, type, from, to)
Storage of a variable in some savegame versions.
Definition: saveload.h:857
ODTF_MANUAL
@ ODTF_MANUAL
Manually initiated order.
Definition: order_type.h:94
SLV_67
@ SLV_67
67 10236
Definition: saveload.h:123
saveload.h
OrderDepotTypeFlags
OrderDepotTypeFlags
Reasons that could cause us to go to the depot.
Definition: order_type.h:93
_settings_client
ClientSettings _settings_client
The current settings for this game.
Definition: settings.cpp:56
Order::AssignOrder
void AssignOrder(const Order &other)
Assign data to an order (from another order) This function makes sure that the index is maintained co...
Definition: order_cmd.cpp:257
SLV_192
@ SLV_192
192 26700 FS#6066 Fix saving of order backups
Definition: saveload.h:274
ChunkHandler
Handlers and description of chunk.
Definition: saveload.h:455
_orderlist_sl_compat
const SaveLoadCompat _orderlist_sl_compat[]
Original field order for _orderlist_desc.
Definition: order_sl_compat.h:30
SLV_36
@ SLV_36
36 6624
Definition: saveload.h:86
ORDLChunkHandler::FixPointers
void FixPointers() const override
Fix the pointers.
Definition: order_sl.cpp:238
_savegame_type
SavegameType _savegame_type
type of savegame we are loading
Definition: saveload.cpp:59
SLE_REF
#define SLE_REF(base, variable, type)
Storage of a reference in every version of a savegame.
Definition: saveload.h:988
Order::GetType
OrderType GetType() const
Get the type of order of this order.
Definition: order_base.h:76
_order_backup_sl_compat
const SaveLoadCompat _order_backup_sl_compat[]
Original field order for _order_backup_desc.
Definition: order_sl_compat.h:35
ONSF_NO_STOP_AT_ANY_STATION
@ ONSF_NO_STOP_AT_ANY_STATION
The vehicle will not stop at any stations it passes including the destination.
Definition: order_type.h:76
ONSF_NO_STOP_AT_INTERMEDIATE_STATIONS
@ ONSF_NO_STOP_AT_INTERMEDIATE_STATIONS
The vehicle will not stop at any stations it passes except the destination.
Definition: order_type.h:74
OLF_FULL_LOAD_ANY
@ OLF_FULL_LOAD_ANY
Full load a single cargo of the consist.
Definition: order_type.h:65
SLV_172
@ SLV_172
172 23947
Definition: saveload.h:249
SLV_180
@ SLV_180
180 24998 1.3.x
Definition: saveload.h:259
ONSF_STOP_EVERYWHERE
@ ONSF_STOP_EVERYWHERE
The vehicle will stop at any station it passes and the destination.
Definition: order_type.h:73
SGT_TTO
@ SGT_TTO
TTO savegame.
Definition: saveload.h:420
OUF_UNLOAD_IF_POSSIBLE
@ OUF_UNLOAD_IF_POSSIBLE
Unload all cargo that the station accepts.
Definition: order_type.h:53
UnpackVersion4Order
static Order UnpackVersion4Order(uint16_t packed)
Unpacks a order from savegames with version 4 and lower.
Definition: order_sl.cpp:82
ORDLChunkHandler
Definition: order_sl.cpp:210
BKORChunkHandler::Save
void Save() const override
Save the chunk.
Definition: order_sl.cpp:273
SLE_CONDREF
#define SLE_CONDREF(base, variable, type, from, to)
Storage of a reference in some savegame versions.
Definition: saveload.h:878
ODTFB_PART_OF_ORDERS
@ ODTFB_PART_OF_ORDERS
This depot order is because of a regular order.
Definition: order_type.h:96
_networking
bool _networking
are we in networking mode?
Definition: network.cpp:65
SL_MAX_VERSION
@ SL_MAX_VERSION
Highest possible saveload version.
Definition: saveload.h:391
Order::ConvertFromOldSavegame
void ConvertFromOldSavegame()
Converts this order from an old savegame's version; it moves all bits to the new location.
Definition: order_sl.cpp:26
REF_VEHICLE
@ REF_VEHICLE
Load/save a reference to a vehicle.
Definition: saveload.h:594
ORDRChunkHandler::Save
void Save() const override
Save the chunk.
Definition: order_sl.cpp:124
ORDLChunkHandler::Save
void Save() const override
Save the chunk.
Definition: order_sl.cpp:213
OLF_LOAD_IF_POSSIBLE
@ OLF_LOAD_IF_POSSIBLE
Load as long as there is cargo that fits in the train.
Definition: order_type.h:63
Order::SetStopLocation
void SetStopLocation(OrderStopLocation stop_location)
Set where we must stop at the platform.
Definition: order_base.h:163
Order::flags
uint8_t flags
Load/unload types, depot order/action types.
Definition: order_base.h:49
ODATFB_HALT
@ ODATFB_HALT
Service the vehicle and then halt it.
Definition: order_type.h:104
SGT_TTD
@ SGT_TTD
TTD savegame (can be detected incorrectly)
Definition: saveload.h:416
SLE_VAR
#define SLE_VAR(base, variable, type)
Storage of a variable in every version of a savegame.
Definition: saveload.h:971
Pool::PoolItem<&_order_pool >::Iterate
static Pool::IterateWrapper< Titem > Iterate(size_t from=0)
Returns an iterable ensemble of all valid Titem.
Definition: pool_type.hpp:388
ORDRChunkHandler::FixPointers
void FixPointers() const override
Fix the pointers.
Definition: order_sl.cpp:190
OSL_PLATFORM_FAR_END
@ OSL_PLATFORM_FAR_END
Stop at the far end of the platform.
Definition: order_type.h:86
SlGetFieldLength
size_t SlGetFieldLength()
Get the length of the current object.
Definition: saveload.cpp:781
OrderList
Shared order list linking together the linked list of orders and the list of vehicles sharing this or...
Definition: order_base.h:259
ORDLChunkHandler::Load
void Load() const override
Load the chunk.
Definition: order_sl.cpp:224
SLV_22
@ SLV_22
22 3726
Definition: saveload.h:69
GUISettings::sg_full_load_any
bool sg_full_load_any
new full load calculation, any cargo must be full read from pre v93 savegames
Definition: settings_type.h:138
ChunkHandlerTable
std::span< const ChunkHandlerRef > ChunkHandlerTable
A table of ChunkHandler entries.
Definition: saveload.h:504
Order::SetDepotOrderType
void SetDepotOrderType(OrderDepotTypeFlags depot_order_type)
Set the cause to go to the depot.
Definition: order_base.h:165
UnpackOldOrder
Order UnpackOldOrder(uint16_t packed)
Unpacks a order from savegames made with TTD(Patch)
Definition: order_sl.cpp:92
Order::SetDepotActionType
void SetDepotActionType(OrderDepotActionFlags depot_service_type)
Set what we are going to do in the depot.
Definition: order_base.h:167
SLE_SSTR
#define SLE_SSTR(base, variable, type)
Storage of a std::string in every savegame version.
Definition: saveload.h:1015
BKORChunkHandler
Definition: order_sl.cpp:270
BKORChunkHandler::Load
void Load() const override
Load the chunk.
Definition: order_sl.cpp:289
saveload_internal.h
SlCompatTableHeader
std::vector< SaveLoad > SlCompatTableHeader(const SaveLoadTable &slt, const SaveLoadCompatTable &slct)
Load a table header in a savegame compatible way.
Definition: saveload.cpp:1888
ODATF_SERVICE_ONLY
@ ODATF_SERVICE_ONLY
Only service the vehicle.
Definition: order_type.h:103
SLV_176
@ SLV_176
176 24446
Definition: saveload.h:254
Order::SetUnloadType
void SetUnloadType(OrderUnloadFlags unload_type)
Set how the consist must be unloaded.
Definition: order_base.h:159
OrderBackup
Data for backing up an order of a vehicle so it can be restored after a vehicle is rebuilt in the sam...
Definition: order_backup.h:33
BKORChunkHandler::FixPointers
void FixPointers() const override
Fix the pointers.
Definition: order_sl.cpp:302
SlObject
void SlObject(void *object, const SaveLoadTable &slt)
Main SaveLoad function.
Definition: saveload.cpp:1697
IsSavegameVersionBefore
bool IsSavegameVersionBefore(SaveLoadVersion major, uint8_t minor=0)
Checks whether the savegame is below major.
Definition: saveload.h:1234
SlTableHeader
std::vector< SaveLoad > SlTableHeader(const SaveLoadTable &slt)
Save or Load a table header.
Definition: saveload.cpp:1750
SaveLoad
SaveLoad type struct.
Definition: saveload.h:707
order_sl_compat.h
Order::next
Order * next
Pointer to next order. If nullptr, end of list.
Definition: order_base.h:59
Order
Definition: order_base.h:36
Order::SetNonStopType
void SetNonStopType(OrderNonStopFlags non_stop_type)
Set whether we must stop at stations or not.
Definition: order_base.h:161
SlIterateArray
int SlIterateArray()
Iterate through the elements of an array and read the whole thing.
Definition: saveload.cpp:658
ORDRChunkHandler::Load
void Load() const override
Load the chunk.
Definition: order_sl.cpp:135
ClientSettings::gui
GUISettings gui
settings related to the GUI
Definition: settings_type.h:611
OLFB_NO_LOAD
@ OLFB_NO_LOAD
Do not load anything.
Definition: order_type.h:66
SLV_TIMETABLE_START_TICKS_FIX
@ SLV_TIMETABLE_START_TICKS_FIX
322 PR#11557 Fix for missing convert timetable start from a date to ticks.
Definition: saveload.h:366