OpenTTD Source 20241224-master-gf74b0cf984
oldloader.h
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#ifndef OLDLOADER_H
11#define OLDLOADER_H
12
13#include "saveload.h"
14#include "../tile_type.h"
15
16static const uint BUFFER_SIZE = 4096;
17static const uint OLD_MAP_SIZE = 256;
18
20 std::optional<FileHandle> file;
21
22 uint chunk_size;
23
24 bool decoding;
25 uint8_t decode_char;
26
27 uint buffer_count;
28 uint buffer_cur;
29 uint8_t buffer[BUFFER_SIZE];
30
31 uint total_read;
32};
33
34/* OldChunk-Type */
36 OC_SIMPLE = 0,
37 OC_NULL = 1,
38 OC_CHUNK = 2,
39 OC_ASSERT = 3,
40 /* 4 bits allocated (16 max) */
41
42 OC_TTD = 1 << 4,
43 OC_TTO = 1 << 5,
44 /* 4 bits allocated */
45
46 OC_VAR_I8 = 1 << 8,
47 OC_VAR_U8 = 2 << 8,
48 OC_VAR_I16 = 3 << 8,
49 OC_VAR_U16 = 4 << 8,
50 OC_VAR_I32 = 5 << 8,
51 OC_VAR_U32 = 6 << 8,
52 OC_VAR_I64 = 7 << 8,
53 OC_VAR_U64 = 8 << 8,
54 /* 8 bits allocated (256 max) */
55
56 OC_FILE_I8 = 1 << 16,
57 OC_FILE_U8 = 2 << 16,
58 OC_FILE_I16 = 3 << 16,
59 OC_FILE_U16 = 4 << 16,
60 OC_FILE_I32 = 5 << 16,
61 OC_FILE_U32 = 6 << 16,
62 /* 8 bits allocated (256 max) */
63
64 OC_INT8 = OC_VAR_I8 | OC_FILE_I8,
65 OC_UINT8 = OC_VAR_U8 | OC_FILE_U8,
66 OC_INT16 = OC_VAR_I16 | OC_FILE_I16,
67 OC_UINT16 = OC_VAR_U16 | OC_FILE_U16,
68 OC_INT32 = OC_VAR_I32 | OC_FILE_I32,
69 OC_UINT32 = OC_VAR_U32 | OC_FILE_U32,
70
71 OC_TILE = OC_VAR_U32 | OC_FILE_U16,
72
78
79 OC_END = 0,
80};
81
83
84typedef bool OldChunkProc(LoadgameState *ls, int num);
85typedef void *OffsetProc(void *base);
86
87struct OldChunks {
89 uint32_t amount;
90
91 void *ptr;
92 OffsetProc *offset;
93 OldChunkProc *proc;
94};
95
96extern uint _bump_assert_value;
97uint8_t ReadByte(LoadgameState *ls);
98bool LoadChunk(LoadgameState *ls, void *base, const OldChunks *chunks);
99
100bool LoadTTDMain(LoadgameState *ls);
101bool LoadTTOMain(LoadgameState *ls);
102
103inline uint16_t ReadUint16(LoadgameState *ls)
104{
105 uint8_t x = ReadByte(ls);
106 return x | ReadByte(ls) << 8;
107}
108
109inline uint32_t ReadUint32(LoadgameState *ls)
110{
111 uint16_t x = ReadUint16(ls);
112 return x | ReadUint16(ls) << 16;
113}
114
115/* Help:
116 * - OCL_SVAR: load 'type' to offset 'offset' in a struct of type 'base', which must also
117 * be given via base in LoadChunk() as real pointer
118 * - OCL_VAR: load 'type' to a global var
119 * - OCL_END: every struct must end with this
120 * - OCL_NULL: read 'amount' of bytes and send them to /dev/null or something
121 * - OCL_CHUNK: load another proc to load a part of the savegame, 'amount' times
122 * - OCL_ASSERT: to check if we are really at the place we expect to be.. because old savegames are too binary to be sure ;)
123 */
124#define OCL_SVAR(type, base, offset) { type, 1, nullptr, [] (void *b) -> void * { return std::addressof(static_cast<base *>(b)->offset); }, nullptr }
125#define OCL_VAR(type, amount, pointer) { type, amount, pointer, nullptr, nullptr }
126#define OCL_END() { OC_END, 0, nullptr, nullptr, nullptr }
127#define OCL_CNULL(type, amount) { OC_NULL | type, amount, nullptr, nullptr, nullptr }
128#define OCL_CCHUNK(type, amount, proc) { OC_CHUNK | type, amount, nullptr, nullptr, proc }
129#define OCL_ASSERT(type, size) { OC_ASSERT | type, 1, (void *)(size_t)size, nullptr, nullptr }
130#define OCL_NULL(amount) OCL_CNULL((OldChunkType)0, amount)
131#define OCL_CHUNK(amount, proc) OCL_CCHUNK((OldChunkType)0, amount, proc)
132
133#endif /* OLDLOADER_H */
#define DECLARE_ENUM_AS_BIT_SET(enum_type)
Operators to allow to work with enum as with type safe bit set in C++.
Definition enum_type.hpp:35
uint8_t ReadByte(LoadgameState *ls)
Reads a byte from the buffer and decompress if needed.
Definition oldloader.cpp:88
bool LoadChunk(LoadgameState *ls, void *base, const OldChunks *chunks)
Loads a chunk from the old savegame.
OldChunkType
Definition oldloader.h:35
@ OC_END
End of the whole chunk, all 32 bits set to zero.
Definition oldloader.h:79
@ OC_DEREFERENCE_POINTER
Dereference the pointer once before writing to it, so we do not have to use big static arrays.
Definition oldloader.h:77
@ OC_TTO
-//- TTO (default is neither of these)
Definition oldloader.h:43
@ OC_TTD
chunk is valid ONLY for TTD savegames
Definition oldloader.h:42
Functions/types related to saving and loading games.
uint32_t amount
Amount of fields.
Definition oldloader.h:89
OldChunkType type
Type of field.
Definition oldloader.h:88
OffsetProc * offset
Pointer to function that returns the actual memory address of a member (ignored if ptr is not nullptr...
Definition oldloader.h:92
void * ptr
Pointer where to save the data (takes precedence over offset)
Definition oldloader.h:91
OldChunkProc * proc
Pointer to function that is called with OC_CHUNK.
Definition oldloader.h:93