OpenTTD Source
12.0-beta2
|
#include "../fileio_type.h"
#include "../fios.h"
#include "../strings_type.h"
#include "../core/span_type.hpp"
#include <optional>
#include <string>
#include <vector>
Go to the source code of this file.
Data Structures | |
struct | FileToSaveLoad |
Deals with the type of the savegame, independent of extension. More... | |
struct | ChunkHandler |
Handlers and description of chunk. More... | |
class | SaveLoadHandler |
Handler for saving/loading an object to/from disk. More... | |
class | DefaultSaveLoadHandler< TImpl, TObject > |
Default handler for saving/loading an object to/from disk. More... | |
struct | SaveLoad |
SaveLoad type struct. More... | |
struct | SaveLoadCompat |
SaveLoad information for backwards compatibility. More... | |
Macros | |
#define | SLE_GENERAL(cmd, base, variable, type, length, from, to, extra) SaveLoad {#variable, cmd, type, length, from, to, cpp_sizeof(base, variable), [] (void *b, size_t) -> void * { assert(b != nullptr); return const_cast<void *>(static_cast<const void *>(std::addressof(static_cast<base *>(b)->variable))); }, extra, nullptr} |
Storage of simple variables, references (pointers), and arrays. More... | |
#define | SLE_CONDVAR(base, variable, type, from, to) SLE_GENERAL(SL_VAR, base, variable, type, 0, from, to, 0) |
Storage of a variable in some savegame versions. More... | |
#define | SLE_CONDREF(base, variable, type, from, to) SLE_GENERAL(SL_REF, base, variable, type, 0, from, to, 0) |
Storage of a reference in some savegame versions. More... | |
#define | SLE_CONDARR(base, variable, type, length, from, to) SLE_GENERAL(SL_ARR, base, variable, type, length, from, to, 0) |
Storage of a fixed-size array of SL_VAR elements in some savegame versions. More... | |
#define | SLE_CONDSTR(base, variable, type, length, from, to) SLE_GENERAL(SL_STR, base, variable, type, length, from, to, 0) |
Storage of a string in some savegame versions. More... | |
#define | SLE_CONDSSTR(base, variable, type, from, to) SLE_GENERAL(SL_STDSTR, base, variable, type, 0, from, to, 0) |
Storage of a std::string in some savegame versions. More... | |
#define | SLE_CONDREFLIST(base, variable, type, from, to) SLE_GENERAL(SL_REFLIST, base, variable, type, 0, from, to, 0) |
Storage of a list of SL_REF elements in some savegame versions. More... | |
#define | SLE_CONDDEQUE(base, variable, type, from, to) SLE_GENERAL(SL_DEQUE, base, variable, type, 0, from, to, 0) |
Storage of a deque of SL_VAR elements in some savegame versions. More... | |
#define | SLE_VAR(base, variable, type) SLE_CONDVAR(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a variable in every version of a savegame. More... | |
#define | SLE_REF(base, variable, type) SLE_CONDREF(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a reference in every version of a savegame. More... | |
#define | SLE_ARR(base, variable, type, length) SLE_CONDARR(base, variable, type, length, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of fixed-size array of SL_VAR elements in every version of a savegame. More... | |
#define | SLE_STR(base, variable, type, length) SLE_CONDSTR(base, variable, type, length, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a string in every savegame version. More... | |
#define | SLE_SSTR(base, variable, type) SLE_CONDSSTR(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a std::string in every savegame version. More... | |
#define | SLE_REFLIST(base, variable, type) SLE_CONDREFLIST(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a list of SL_REF elements in every savegame version. More... | |
#define | SLE_SAVEBYTE(base, variable) SLE_GENERAL(SL_SAVEBYTE, base, variable, 0, 0, SL_MIN_VERSION, SL_MAX_VERSION, 0) |
Only write byte during saving; never read it during loading. More... | |
#define | SLEG_GENERAL(name, cmd, variable, type, length, from, to, extra) SaveLoad {name, cmd, type, length, from, to, sizeof(variable), [] (void *, size_t) -> void * { return static_cast<void *>(std::addressof(variable)); }, extra, nullptr} |
Storage of global simple variables, references (pointers), and arrays. More... | |
#define | SLEG_CONDVAR(name, variable, type, from, to) SLEG_GENERAL(name, SL_VAR, variable, type, 0, from, to, 0) |
Storage of a global variable in some savegame versions. More... | |
#define | SLEG_CONDREF(name, variable, type, from, to) SLEG_GENERAL(name, SL_REF, variable, type, 0, from, to, 0) |
Storage of a global reference in some savegame versions. More... | |
#define | SLEG_CONDARR(name, variable, type, length, from, to) SLEG_GENERAL(name, SL_ARR, variable, type, length, from, to, 0) |
Storage of a global fixed-size array of SL_VAR elements in some savegame versions. More... | |
#define | SLEG_CONDSTR(name, variable, type, length, from, to) SLEG_GENERAL(name, SL_STR, variable, type, length, from, to, 0) |
Storage of a global string in some savegame versions. More... | |
#define | SLEG_CONDSSTR(name, variable, type, from, to) SLEG_GENERAL(name, SL_STDSTR, variable, type, 0, from, to, 0) |
Storage of a global std::string in some savegame versions. More... | |
#define | SLEG_CONDSTRUCT(name, handler, from, to) SaveLoad {name, SL_STRUCT, 0, 0, from, to, 0, nullptr, 0, std::make_shared<handler>()} |
Storage of a structs in some savegame versions. More... | |
#define | SLEG_CONDREFLIST(name, variable, type, from, to) SLEG_GENERAL(name, SL_REFLIST, variable, type, 0, from, to, 0) |
Storage of a global reference list in some savegame versions. More... | |
#define | SLEG_CONDVECTOR(name, variable, type, from, to) SLEG_GENERAL(name, SL_VECTOR, variable, type, 0, from, to, 0) |
Storage of a global vector of SL_VAR elements in some savegame versions. More... | |
#define | SLEG_CONDSTRUCTLIST(name, handler, from, to) SaveLoad {name, SL_STRUCTLIST, 0, 0, from, to, 0, nullptr, 0, std::make_shared<handler>()} |
Storage of a list of structs in some savegame versions. More... | |
#define | SLEG_VAR(name, variable, type) SLEG_CONDVAR(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global variable in every savegame version. More... | |
#define | SLEG_REF(name, variable, type) SLEG_CONDREF(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global reference in every savegame version. More... | |
#define | SLEG_ARR(name, variable, type) SLEG_CONDARR(name, variable, type, lengthof(variable), SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global fixed-size array of SL_VAR elements in every savegame version. More... | |
#define | SLEG_STR(name, variable, type) SLEG_CONDSTR(name, variable, type, sizeof(variable), SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global string in every savegame version. More... | |
#define | SLEG_SSTR(name, variable, type) SLEG_CONDSSTR(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global std::string in every savegame version. More... | |
#define | SLEG_STRUCT(name, handler) SLEG_CONDSTRUCT(name, handler, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a structs in every savegame version. More... | |
#define | SLEG_REFLIST(name, variable, type) SLEG_CONDREFLIST(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global reference list in every savegame version. More... | |
#define | SLEG_VECTOR(name, variable, type) SLEG_CONDVECTOR(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global vector of SL_VAR elements in every savegame version. More... | |
#define | SLEG_STRUCTLIST(name, handler) SLEG_CONDSTRUCTLIST(name, handler, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a list of structs in every savegame version. More... | |
#define | SLC_VAR(name) {name, 0, SL_MIN_VERSION, SL_MAX_VERSION} |
Field name where the real SaveLoad can be located. More... | |
#define | SLC_NULL(length, from, to) {{}, length, from, to} |
Empty space in every savegame version. More... | |
#define | SLC_END() {{}, 0, SL_MIN_VERSION, SL_MIN_VERSION} |
End marker of compat variables save or load. | |
Typedefs | |
typedef void | AutolengthProc(void *arg) |
using | ChunkHandlerRef = std::reference_wrapper< const ChunkHandler > |
A reference to ChunkHandler. | |
using | ChunkHandlerTable = span< const ChunkHandlerRef > |
A table of ChunkHandler entries. | |
using | SaveLoadTable = span< const struct SaveLoad > |
A table of SaveLoad entries. | |
using | SaveLoadCompatTable = span< const struct SaveLoadCompat > |
A table of SaveLoadCompat entries. | |
typedef uint32 | VarType |
typedef void * | SaveLoadAddrProc(void *base, size_t extra) |
Functions | |
void | GenerateDefaultSaveName (char *buf, const char *last) |
Fill the buffer with the default name for a savegame or screenshot. More... | |
void | SetSaveLoadError (StringID str) |
Set the error message from outside of the actual loading/saving of the game (AfterLoadGame and friends) | |
const char * | GetSaveLoadErrorString () |
Get the string representation of the error message. | |
SaveOrLoadResult | SaveOrLoad (const std::string &filename, SaveLoadOperation fop, DetailedFileType dft, Subdirectory sb, bool threaded=true) |
Main Save or Load function where the high-level saveload functions are handled. More... | |
void | WaitTillSaved () |
void | ProcessAsyncSaveFinish () |
Handle async save finishes. | |
void | DoExitSave () |
Do a save when exiting the game (_settings_client.gui.autosave_on_exit) | |
void | DoAutoOrNetsave (FiosNumberedSaveName &counter) |
Create an autosave or netsave. More... | |
SaveOrLoadResult | SaveWithFilter (struct SaveFilter *writer, bool threaded) |
Save the game using a (writer) filter. More... | |
SaveOrLoadResult | LoadWithFilter (struct LoadFilter *reader) |
Load the game using a (reader) filter. More... | |
static bool | IsSavegameVersionBefore (SaveLoadVersion major, byte minor=0) |
Checks whether the savegame is below major. More... | |
static bool | IsSavegameVersionBeforeOrAt (SaveLoadVersion major) |
Checks whether the savegame is below or at major. More... | |
static bool | SlIsObjectCurrentlyValid (SaveLoadVersion version_from, SaveLoadVersion version_to) |
Checks if some version from/to combination falls within the range of the active savegame version. More... | |
static VarType | GetVarMemType (VarType type) |
Get the NumberType of a setting. More... | |
static VarType | GetVarFileType (VarType type) |
Get the FileType of a setting. More... | |
static bool | IsNumericType (VarType conv) |
Check if the given saveload type is a numeric type. More... | |
static void * | GetVariableAddress (const void *object, const SaveLoad &sld) |
Get the address of the variable. More... | |
int64 | ReadValue (const void *ptr, VarType conv) |
Return a signed-long version of the value of a setting. More... | |
void | WriteValue (void *ptr, VarType conv, int64 val) |
Write the value of a setting. More... | |
void | SlSetArrayIndex (uint index) |
int | SlIterateArray () |
Iterate through the elements of an array and read the whole thing. More... | |
void | SlSetStructListLength (size_t length) |
Set the length of this list. More... | |
size_t | SlGetStructListLength (size_t limit) |
Get the length of this list; if it exceeds the limit, error out. More... | |
void | SlAutolength (AutolengthProc *proc, void *arg) |
Do something of which I have no idea what it is :P. More... | |
size_t | SlGetFieldLength () |
Get the length of the current object. | |
void | SlSetLength (size_t length) |
Sets the length of either a RIFF object or the number of items in an array. More... | |
size_t | SlCalcObjMemberLength (const void *object, const SaveLoad &sld) |
size_t | SlCalcObjLength (const void *object, const SaveLoadTable &slt) |
Calculate the size of an object. More... | |
byte | SlReadByte () |
Wrapper for reading a byte from the buffer. More... | |
void | SlWriteByte (byte b) |
Wrapper for writing a byte to the dumper. More... | |
void | SlGlobList (const SaveLoadTable &slt) |
Save or Load (a list of) global variables. More... | |
void | SlCopy (void *object, size_t length, VarType conv) |
Copy a list of SL_VARs to/from a savegame. More... | |
std::vector< SaveLoad > | SlTableHeader (const SaveLoadTable &slt) |
Save or Load a table header. More... | |
std::vector< SaveLoad > | SlCompatTableHeader (const SaveLoadTable &slt, const SaveLoadCompatTable &slct) |
Load a table header in a savegame compatible way. More... | |
void | SlObject (void *object, const SaveLoadTable &slt) |
Main SaveLoad function. More... | |
void NORETURN | SlError (StringID string, const char *extra_msg=nullptr) |
Error handler. More... | |
void NORETURN | SlErrorCorrupt (const char *msg) |
Error handler for corrupt savegames. More... | |
void NORETURN | SlErrorCorruptFmt (const char *format,...) WARN_FORMAT(1 |
void NORETURN bool | SaveloadCrashWithMissingNewGRFs () |
Did loading the savegame cause a crash? If so, were NewGRFs missing? More... | |
static void | SlSkipBytes (size_t length) |
Read in bytes from the file/data structure but don't do anything with them, discarding them in effect. More... | |
Variables | |
FileToSaveLoad | _file_to_saveload |
File to save or load in the openttd loop. | |
std::string | _savegame_format |
how to compress savegames | |
bool | _do_autosave |
are we doing an autosave at the moment? | |
Functions/types related to saving and loading games.
Definition in file saveload.h.
#define SLC_NULL | ( | length, | |
from, | |||
to | |||
) | {{}, length, from, to} |
Empty space in every savegame version.
length | Length of the empty space. |
from | First savegame version that has the empty space. |
to | Last savegame version that has the empty space. |
Definition at line 1013 of file saveload.h.
#define SLC_VAR | ( | name | ) | {name, 0, SL_MIN_VERSION, SL_MAX_VERSION} |
Field name where the real SaveLoad can be located.
name | The name of the field. |
Definition at line 1005 of file saveload.h.
#define SLE_ARR | ( | base, | |
variable, | |||
type, | |||
length | |||
) | SLE_CONDARR(base, variable, type, length, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of fixed-size array of SL_VAR elements in every version of a savegame.
base | Name of the class or struct containing the array. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
length | Number of elements in the array. |
Definition at line 789 of file saveload.h.
#define SLE_CONDARR | ( | base, | |
variable, | |||
type, | |||
length, | |||
from, | |||
to | |||
) | SLE_GENERAL(SL_ARR, base, variable, type, length, from, to, 0) |
Storage of a fixed-size array of SL_VAR elements in some savegame versions.
base | Name of the class or struct containing the array. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
length | Number of elements in the array. |
from | First savegame version that has the array. |
to | Last savegame version that has the array. |
Definition at line 723 of file saveload.h.
#define SLE_CONDDEQUE | ( | base, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLE_GENERAL(SL_DEQUE, base, variable, type, 0, from, to, 0) |
Storage of a deque of SL_VAR elements in some savegame versions.
base | Name of the class or struct containing the list. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the list. |
to | Last savegame version that has the list. |
Definition at line 764 of file saveload.h.
#define SLE_CONDREF | ( | base, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLE_GENERAL(SL_REF, base, variable, type, 0, from, to, 0) |
Storage of a reference in some savegame versions.
base | Name of the class or struct containing the variable. |
variable | Name of the variable in the class or struct referenced by base. |
type | Type of the reference, a value from SLRefType. |
from | First savegame version that has the field. |
to | Last savegame version that has the field. |
Definition at line 712 of file saveload.h.
#define SLE_CONDREFLIST | ( | base, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLE_GENERAL(SL_REFLIST, base, variable, type, 0, from, to, 0) |
Storage of a list of SL_REF elements in some savegame versions.
base | Name of the class or struct containing the list. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the list. |
to | Last savegame version that has the list. |
Definition at line 754 of file saveload.h.
#define SLE_CONDSSTR | ( | base, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLE_GENERAL(SL_STDSTR, base, variable, type, 0, from, to, 0) |
Storage of a std::string
in some savegame versions.
base | Name of the class or struct containing the string. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the string. |
to | Last savegame version that has the string. |
Definition at line 744 of file saveload.h.
#define SLE_CONDSTR | ( | base, | |
variable, | |||
type, | |||
length, | |||
from, | |||
to | |||
) | SLE_GENERAL(SL_STR, base, variable, type, length, from, to, 0) |
Storage of a string in some savegame versions.
base | Name of the class or struct containing the string. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
length | Number of elements in the string (only used for fixed size buffers). |
from | First savegame version that has the string. |
to | Last savegame version that has the string. |
Definition at line 734 of file saveload.h.
#define SLE_CONDVAR | ( | base, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLE_GENERAL(SL_VAR, base, variable, type, 0, from, to, 0) |
Storage of a variable in some savegame versions.
base | Name of the class or struct containing the variable. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the field. |
to | Last savegame version that has the field. |
Definition at line 702 of file saveload.h.
#define SLE_GENERAL | ( | cmd, | |
base, | |||
variable, | |||
type, | |||
length, | |||
from, | |||
to, | |||
extra | |||
) | SaveLoad {#variable, cmd, type, length, from, to, cpp_sizeof(base, variable), [] (void *b, size_t) -> void * { assert(b != nullptr); return const_cast<void *>(static_cast<const void *>(std::addressof(static_cast<base *>(b)->variable))); }, extra, nullptr} |
Storage of simple variables, references (pointers), and arrays.
cmd | Load/save type. |
base | Name of the class or struct containing the variable. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the field. |
to | Last savegame version that has the field. |
extra | Extra data to pass to the address callback function. |
Definition at line 692 of file saveload.h.
#define SLE_REF | ( | base, | |
variable, | |||
type | |||
) | SLE_CONDREF(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a reference in every version of a savegame.
base | Name of the class or struct containing the variable. |
variable | Name of the variable in the class or struct referenced by base. |
type | Type of the reference, a value from SLRefType. |
Definition at line 780 of file saveload.h.
#define SLE_REFLIST | ( | base, | |
variable, | |||
type | |||
) | SLE_CONDREFLIST(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a list of SL_REF elements in every savegame version.
base | Name of the class or struct containing the list. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
Definition at line 814 of file saveload.h.
#define SLE_SAVEBYTE | ( | base, | |
variable | |||
) | SLE_GENERAL(SL_SAVEBYTE, base, variable, 0, 0, SL_MIN_VERSION, SL_MAX_VERSION, 0) |
Only write byte during saving; never read it during loading.
When using SLE_SAVEBYTE you will have to read this byte before the table this is in is read. This also means SLE_SAVEBYTE can only be used at the top of a chunk. This is intended to be used to indicate what type of entry this is in a list of entries.
base | Name of the class or struct containing the variable. |
variable | Name of the variable in the class or struct referenced by base. |
Definition at line 826 of file saveload.h.
#define SLE_SSTR | ( | base, | |
variable, | |||
type | |||
) | SLE_CONDSSTR(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a std::string
in every savegame version.
base | Name of the class or struct containing the string. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
Definition at line 806 of file saveload.h.
#define SLE_STR | ( | base, | |
variable, | |||
type, | |||
length | |||
) | SLE_CONDSTR(base, variable, type, length, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a string in every savegame version.
base | Name of the class or struct containing the string. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
length | Number of elements in the string (only used for fixed size buffers). |
Definition at line 798 of file saveload.h.
#define SLE_VAR | ( | base, | |
variable, | |||
type | |||
) | SLE_CONDVAR(base, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a variable in every version of a savegame.
base | Name of the class or struct containing the variable. |
variable | Name of the variable in the class or struct referenced by base. |
type | Storage of the data in memory and in the savegame. |
Definition at line 772 of file saveload.h.
#define SLEG_ARR | ( | name, | |
variable, | |||
type | |||
) | SLEG_CONDARR(name, variable, type, lengthof(variable), SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global fixed-size array of SL_VAR elements in every savegame version.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
Definition at line 953 of file saveload.h.
#define SLEG_CONDARR | ( | name, | |
variable, | |||
type, | |||
length, | |||
from, | |||
to | |||
) | SLEG_GENERAL(name, SL_ARR, variable, type, length, from, to, 0) |
Storage of a global fixed-size array of SL_VAR elements in some savegame versions.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
length | Number of elements in the array. |
from | First savegame version that has the array. |
to | Last savegame version that has the array. |
Definition at line 870 of file saveload.h.
#define SLEG_CONDREF | ( | name, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLEG_GENERAL(name, SL_REF, variable, type, 0, from, to, 0) |
Storage of a global reference in some savegame versions.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the field. |
to | Last savegame version that has the field. |
Definition at line 859 of file saveload.h.
#define SLEG_CONDREFLIST | ( | name, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLEG_GENERAL(name, SL_REFLIST, variable, type, 0, from, to, 0) |
Storage of a global reference list in some savegame versions.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the list. |
to | Last savegame version that has the list. |
Definition at line 910 of file saveload.h.
#define SLEG_CONDSSTR | ( | name, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLEG_GENERAL(name, SL_STDSTR, variable, type, 0, from, to, 0) |
Storage of a global std::string
in some savegame versions.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the string. |
to | Last savegame version that has the string. |
Definition at line 891 of file saveload.h.
#define SLEG_CONDSTR | ( | name, | |
variable, | |||
type, | |||
length, | |||
from, | |||
to | |||
) | SLEG_GENERAL(name, SL_STR, variable, type, length, from, to, 0) |
Storage of a global string in some savegame versions.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
length | Number of elements in the string (only used for fixed size buffers). |
from | First savegame version that has the string. |
to | Last savegame version that has the string. |
Definition at line 881 of file saveload.h.
#define SLEG_CONDSTRUCT | ( | name, | |
handler, | |||
from, | |||
to | |||
) | SaveLoad {name, SL_STRUCT, 0, 0, from, to, 0, nullptr, 0, std::make_shared<handler>()} |
Storage of a structs in some savegame versions.
name | The name of the field. |
handler | SaveLoadHandler for the structs. |
from | First savegame version that has the struct. |
to | Last savegame version that has the struct. |
Definition at line 900 of file saveload.h.
#define SLEG_CONDSTRUCTLIST | ( | name, | |
handler, | |||
from, | |||
to | |||
) | SaveLoad {name, SL_STRUCTLIST, 0, 0, from, to, 0, nullptr, 0, std::make_shared<handler>()} |
Storage of a list of structs in some savegame versions.
name | The name of the field. |
handler | SaveLoadHandler for the list of structs. |
from | First savegame version that has the list. |
to | Last savegame version that has the list. |
Definition at line 929 of file saveload.h.
#define SLEG_CONDVAR | ( | name, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLEG_GENERAL(name, SL_VAR, variable, type, 0, from, to, 0) |
Storage of a global variable in some savegame versions.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the field. |
to | Last savegame version that has the field. |
Definition at line 849 of file saveload.h.
#define SLEG_CONDVECTOR | ( | name, | |
variable, | |||
type, | |||
from, | |||
to | |||
) | SLEG_GENERAL(name, SL_VECTOR, variable, type, 0, from, to, 0) |
Storage of a global vector of SL_VAR elements in some savegame versions.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the list. |
to | Last savegame version that has the list. |
Definition at line 920 of file saveload.h.
#define SLEG_GENERAL | ( | name, | |
cmd, | |||
variable, | |||
type, | |||
length, | |||
from, | |||
to, | |||
extra | |||
) | SaveLoad {name, cmd, type, length, from, to, sizeof(variable), [] (void *, size_t) -> void * { return static_cast<void *>(std::addressof(variable)); }, extra, nullptr} |
Storage of global simple variables, references (pointers), and arrays.
name | The name of the field. |
cmd | Load/save type. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
from | First savegame version that has the field. |
to | Last savegame version that has the field. |
extra | Extra data to pass to the address callback function. |
Definition at line 839 of file saveload.h.
#define SLEG_REF | ( | name, | |
variable, | |||
type | |||
) | SLEG_CONDREF(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global reference in every savegame version.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
Definition at line 945 of file saveload.h.
#define SLEG_REFLIST | ( | name, | |
variable, | |||
type | |||
) | SLEG_CONDREFLIST(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global reference list in every savegame version.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
Definition at line 984 of file saveload.h.
#define SLEG_SSTR | ( | name, | |
variable, | |||
type | |||
) | SLEG_CONDSSTR(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global std::string
in every savegame version.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
Definition at line 969 of file saveload.h.
#define SLEG_STR | ( | name, | |
variable, | |||
type | |||
) | SLEG_CONDSTR(name, variable, type, sizeof(variable), SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global string in every savegame version.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
Definition at line 961 of file saveload.h.
#define SLEG_STRUCT | ( | name, | |
handler | |||
) | SLEG_CONDSTRUCT(name, handler, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a structs in every savegame version.
name | The name of the field. |
handler | SaveLoadHandler for the structs. |
Definition at line 976 of file saveload.h.
#define SLEG_STRUCTLIST | ( | name, | |
handler | |||
) | SLEG_CONDSTRUCTLIST(name, handler, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a list of structs in every savegame version.
name | The name of the field. |
handler | SaveLoadHandler for the list of structs. |
Definition at line 999 of file saveload.h.
#define SLEG_VAR | ( | name, | |
variable, | |||
type | |||
) | SLEG_CONDVAR(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global variable in every savegame version.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
Definition at line 937 of file saveload.h.
#define SLEG_VECTOR | ( | name, | |
variable, | |||
type | |||
) | SLEG_CONDVECTOR(name, variable, type, SL_MIN_VERSION, SL_MAX_VERSION) |
Storage of a global vector of SL_VAR elements in every savegame version.
name | The name of the field. |
variable | Name of the global variable. |
type | Storage of the data in memory and in the savegame. |
Definition at line 992 of file saveload.h.
enum ChunkType |
Type of a chunk.
Enumerator | |
---|---|
CH_TYPE_MASK | All ChunkType values have to be within this mask. |
CH_READONLY | Chunk is never saved. |
Definition at line 394 of file saveload.h.
enum SavegameType |
Types of save games.
Definition at line 367 of file saveload.h.
enum SaveLoadType : byte |
Type of data saved.
Enumerator | |
---|---|
SL_VAR | Save/load a variable. |
SL_REF | Save/load a reference. |
SL_STRUCT | Save/load a struct. |
SL_STR | Save/load a string. |
SL_STDSTR | Save/load a |
SL_ARR | Save/load a fixed-size array of SL_VAR elements. |
SL_DEQUE | Save/load a deque of SL_VAR elements. |
SL_VECTOR | Save/load a vector of SL_VAR elements. |
SL_REFLIST | Save/load a list of SL_REF elements. |
SL_STRUCTLIST | Save/load a list of structs. |
SL_SAVEBYTE | Save (but not load) a byte. |
SL_NULL | Save null-bytes and load to nowhere. |
Definition at line 632 of file saveload.h.
enum SaveLoadVersion : uint16 |
SaveLoad versions Previous savegame versions, the trunk revision where they were introduced and the released version that had that particular savegame version.
Up to savegame version 18 there is a minor version as well.
Older entries keep their original numbering.
Newer entries should use a descriptive labels, numeric version and PR can be added to comment.
Note that this list must not be reordered.
Enumerator | |
---|---|
SL_MIN_VERSION | First savegame version. |
SLV_1 | 1.0 0.1.x, 0.2.x |
SLV_2 | 2.0 0.3.0 2.1 0.3.1, 0.3.2 |
SLV_3 | 3.x lost |
SLV_4 | 4.0 1 4.1 122 0.3.3, 0.3.4 4.2 1222 0.3.5 4.3 1417 4.4 1426 |
SLV_5 | 5.0 1429 5.1 1440 5.2 1525 0.3.6 |
SLV_6 | 6.0 1721 6.1 1768 |
SLV_7 | 7.0 1770 |
SLV_8 | 8.0 1786 |
SLV_9 | 9.0 1909 |
SLV_10 | 10.0 2030 |
SLV_11 | 11.0 2033 11.1 2041 |
SLV_12 | 12.1 2046 |
SLV_13 | 13.1 2080 0.4.0, 0.4.0.1 |
SLV_14 | 14.0 2441 |
SLV_15 | 15.0 2499 |
SLV_16 | 16.0 2817 16.1 3155 |
SLV_17 | 17.0 3212 17.1 3218 |
SLV_18 | 18 3227 |
SLV_19 | 19 3396 |
SLV_20 | 20 3403 |
SLV_21 | 21 3472 0.4.x |
SLV_22 | 22 3726 |
SLV_23 | 23 3915 |
SLV_24 | 24 4150 |
SLV_25 | 25 4259 |
SLV_26 | 26 4466 |
SLV_27 | 27 4757 |
SLV_28 | 28 4987 |
SLV_29 | 29 5070 |
SLV_30 | 30 5946 |
SLV_31 | 31 5999 |
SLV_32 | 32 6001 |
SLV_33 | 33 6440 |
SLV_34 | 34 6455 |
SLV_35 | 35 6602 |
SLV_36 | 36 6624 |
SLV_37 | 37 7182 |
SLV_38 | 38 7195 |
SLV_39 | 39 7269 |
SLV_40 | 40 7326 |
SLV_41 | 41 7348 0.5.x |
SLV_42 | 42 7573 |
SLV_43 | 43 7642 |
SLV_44 | 44 8144 |
SLV_45 | 45 8501 |
SLV_46 | 46 8705 |
SLV_47 | 47 8735 |
SLV_48 | 48 8935 |
SLV_49 | 49 8969 |
SLV_50 | 50 8973 |
SLV_51 | 51 8978 |
SLV_52 | 52 9066 |
SLV_53 | 53 9316 |
SLV_54 | 54 9613 |
SLV_55 | 55 9638 |
SLV_56 | 56 9667 |
SLV_57 | 57 9691 |
SLV_58 | 58 9762 |
SLV_59 | 59 9779 |
SLV_60 | 60 9874 |
SLV_61 | 61 9892 |
SLV_62 | 62 9905 |
SLV_63 | 63 9956 |
SLV_64 | 64 10006 |
SLV_65 | 65 10210 |
SLV_66 | 66 10211 |
SLV_67 | 67 10236 |
SLV_68 | 68 10266 |
SLV_69 | 69 10319 |
SLV_70 | 70 10541 |
SLV_71 | 71 10567 |
SLV_72 | 72 10601 |
SLV_73 | 73 10903 |
SLV_74 | 74 11030 |
SLV_75 | 75 11107 |
SLV_76 | 76 11139 |
SLV_77 | 77 11172 |
SLV_78 | 78 11176 |
SLV_79 | 79 11188 |
SLV_80 | 80 11228 |
SLV_81 | 81 11244 |
SLV_82 | 82 11410 |
SLV_83 | 83 11589 |
SLV_84 | 84 11822 |
SLV_85 | 85 11874 |
SLV_86 | 86 12042 |
SLV_87 | 87 12129 |
SLV_88 | 88 12134 |
SLV_89 | 89 12160 |
SLV_90 | 90 12293 |
SLV_91 | 91 12347 |
SLV_92 | 92 12381 0.6.x |
SLV_93 | 93 12648 |
SLV_94 | 94 12816 |
SLV_95 | 95 12924 |
SLV_96 | 96 13226 |
SLV_97 | 97 13256 |
SLV_98 | 98 13375 |
SLV_99 | 99 13838 |
SLV_100 | 100 13952 |
SLV_101 | 101 14233 |
SLV_102 | 102 14332 |
SLV_103 | 103 14598 |
SLV_104 | 104 14735 |
SLV_105 | 105 14803 |
SLV_106 | 106 14919 |
SLV_107 | 107 15027 |
SLV_108 | 108 15045 |
SLV_109 | 109 15075 |
SLV_110 | 110 15148 |
SLV_111 | 111 15190 |
SLV_112 | 112 15290 |
SLV_113 | 113 15340 |
SLV_114 | 114 15601 |
SLV_115 | 115 15695 |
SLV_116 | 116 15893 0.7.x |
SLV_117 | 117 16037 |
SLV_118 | 118 16129 |
SLV_119 | 119 16242 |
SLV_120 | 120 16439 |
SLV_121 | 121 16694 |
SLV_122 | 122 16855 |
SLV_123 | 123 16909 |
SLV_124 | 124 16993 |
SLV_125 | 125 17113 |
SLV_126 | 126 17433 |
SLV_127 | 127 17439 |
SLV_128 | 128 18281 |
SLV_129 | 129 18292 |
SLV_130 | 130 18404 |
SLV_131 | 131 18481 |
SLV_132 | 132 18522 |
SLV_133 | 133 18674 |
SLV_134 | 134 18703 |
SLV_135 | 135 18719 |
SLV_136 | 136 18764 |
SLV_137 | 137 18912 |
SLV_138 | 138 18942 1.0.x |
SLV_139 | 139 19346 |
SLV_140 | 140 19382 |
SLV_141 | 141 19799 |
SLV_142 | 142 20003 |
SLV_143 | 143 20048 |
SLV_144 | 144 20334 |
SLV_145 | 145 20376 |
SLV_146 | 146 20446 |
SLV_147 | 147 20621 |
SLV_148 | 148 20659 |
SLV_149 | 149 20832 |
SLV_150 | 150 20857 |
SLV_151 | 151 20918 |
SLV_152 | 152 21171 |
SLV_153 | 153 21263 |
SLV_154 | 154 21426 |
SLV_155 | 155 21453 |
SLV_156 | 156 21728 |
SLV_157 | 157 21862 |
SLV_158 | 158 21933 |
SLV_159 | 159 21962 |
SLV_160 | 160 21974 1.1.x |
SLV_161 | 161 22567 |
SLV_162 | 162 22713 |
SLV_163 | 163 22767 |
SLV_164 | 164 23290 |
SLV_165 | 165 23304 |
SLV_166 | 166 23415 |
SLV_167 | 167 23504 |
SLV_168 | 168 23637 |
SLV_169 | 169 23816 |
SLV_170 | 170 23826 |
SLV_171 | 171 23835 |
SLV_172 | 172 23947 |
SLV_173 | 173 23967 1.2.0-RC1 |
SLV_174 | 174 23973 1.2.x |
SLV_175 | 175 24136 |
SLV_176 | 176 24446 |
SLV_177 | 177 24619 |
SLV_178 | 178 24789 |
SLV_179 | 179 24810 |
SLV_180 | 180 24998 1.3.x |
SLV_181 | 181 25012 |
SLV_182 | 182 25115 FS#5492, r25259, r25296 Goal status |
SLV_183 | 183 25363 Cargodist |
SLV_184 | 184 25508 Unit localisation split |
SLV_185 | 185 25620 Storybooks |
SLV_186 | 186 25833 Objects storage |
SLV_187 | 187 25899 Linkgraph - restricted flows |
SLV_188 | 188 26169 v1.4 FS#5831 Unify RV travel time |
SLV_189 | 189 26450 Hierarchical vehicle subgroups |
SLV_190 | 190 26547 Separate order travel and wait times |
SLV_191 | 191 26636 FS#6026 Fix disaster vehicle storage (No bump) 191 26646 FS#6041 Linkgraph - store locations |
SLV_192 | 192 26700 FS#6066 Fix saving of order backups |
SLV_193 | 193 26802 |
SLV_194 | 194 26881 v1.5 |
SLV_195 | 195 27572 v1.6.1 |
SLV_196 | 196 27778 v1.7 |
SLV_197 | 197 27978 v1.8 |
SLV_198 | 198 PR#6763 Switch town growth rate and counter to actual game ticks |
SLV_EXTEND_CARGOTYPES | 199 PR#6802 Extend cargotypes to 64 |
SLV_EXTEND_RAILTYPES | 200 PR#6805 Extend railtypes to 64, adding uint16 to map array. |
SLV_EXTEND_PERSISTENT_STORAGE | 201 PR#6885 Extend NewGRF persistent storages. |
SLV_EXTEND_INDUSTRY_CARGO_SLOTS | 202 PR#6867 Increase industry cargo slots to 16 in, 16 out |
SLV_SHIP_PATH_CACHE | 203 PR#7072 Add path cache for ships |
SLV_SHIP_ROTATION | 204 PR#7065 Add extra rotation stages for ships. |
SLV_GROUP_LIVERIES | 205 PR#7108 Livery storage change and group liveries. |
SLV_SHIPS_STOP_IN_LOCKS | 206 PR#7150 Ship/lock movement changes. |
SLV_FIX_CARGO_MONITOR | 207 PR#7175 v1.9 Cargo monitor data packing fix to support 64 cargotypes. |
SLV_TOWN_CARGOGEN | 208 PR#6965 New algorithms for town building cargo generation. |
SLV_SHIP_CURVE_PENALTY | 209 PR#7289 Configurable ship curve penalties. |
SLV_SERVE_NEUTRAL_INDUSTRIES | 210 PR#7234 Company stations can serve industries with attached neutral stations. |
SLV_ROADVEH_PATH_CACHE | 211 PR#7261 Add path cache for road vehicles. |
SLV_REMOVE_OPF | 212 PR#7245 Remove OPF. |
SLV_TREES_WATER_CLASS | 213 PR#7405 WaterClass update for tree tiles. |
SLV_ROAD_TYPES | 214 PR#6811 NewGRF road types. |
SLV_SCRIPT_MEMLIMIT | 215 PR#7516 Limit on AI/GS memory consumption. |
SLV_MULTITILE_DOCKS | 216 PR#7380 Multiple docks per station. |
SLV_TRADING_AGE | 217 PR#7780 Configurable company trading age. |
SLV_ENDING_YEAR | 218 PR#7747 v1.10 Configurable ending year. |
SLV_REMOVE_TOWN_CARGO_CACHE | 219 PR#8258 Remove town cargo acceptance and production caches. |
SLV_START_PATCHPACKS | 220 First known patchpack to use a version just above ours. |
SLV_END_PATCHPACKS | 286 Last known patchpack to use a version just above ours. |
SLV_GS_INDUSTRY_CONTROL | 287 PR#7912 and PR#8115 GS industry control. |
SLV_VEH_MOTION_COUNTER | 288 PR#8591 Desync safe motion counter |
SLV_INDUSTRY_TEXT | 289 PR#8576 v1.11.0-RC1 Additional GS text for industries. |
SLV_MAPGEN_SETTINGS_REVAMP | 290 PR#8891 v1.11 Revamp of some mapgen settings (snow coverage, desert coverage, heightmap height, custom terrain type). |
SLV_GROUP_REPLACE_WAGON_REMOVAL | 291 PR#7441 Per-group wagon removal flag. |
SLV_CUSTOM_SUBSIDY_DURATION | 292 PR#9081 Configurable subsidy duration. |
SLV_SAVELOAD_LIST_LENGTH | 293 PR#9374 Consistency in list length with SL_STRUCT / SL_STRUCTLIST / SL_DEQUE / SL_REFLIST. |
SLV_RIFF_TO_ARRAY | 294 PR#9375 Changed many CH_RIFF chunks to CH_ARRAY chunks. |
SLV_TABLE_CHUNKS | 295 PR#9322 Introduction of CH_TABLE and CH_SPARSE_TABLE. |
SLV_SCRIPT_INT64 | 296 PR#9415 SQInteger is 64bit but was saved as 32bit. |
SLV_LINKGRAPH_TRAVEL_TIME | 297 PR#9457 Store travel time in the linkgraph. |
SL_MAX_VERSION | Highest possible saveload version. |
Definition at line 34 of file saveload.h.
enum SaveOrLoadResult |
Save or load result codes.
Definition at line 346 of file saveload.h.
enum SLRefType |
Type of reference (SLE_REF, SLE_CONDREF).
Definition at line 534 of file saveload.h.
enum VarTypes |
VarTypes is the general bitmasked magic type that tells us certain characteristics about the variable it refers to.
For example SLE_FILE_* gives the size(type) as it would be in the savegame and SLE_VAR_* the size(type) as it is in memory during runtime. These are the first 8 bits (0-3 SLE_FILE, 4-7 SLE_VAR). Bits 8-15 are reserved for various flags as explained below
Definition at line 557 of file saveload.h.
void DoAutoOrNetsave | ( | FiosNumberedSaveName & | counter | ) |
Create an autosave or netsave.
counter | A reference to the counter variable to be used for rotating the file name. |
netsave | Indicates if this is a regular autosave or a netsave. |
Definition at line 3331 of file saveload.cpp.
Referenced by ClientNetworkEmergencySave(), and DoAutosave().
void GenerateDefaultSaveName | ( | char * | buf, |
const char * | last | ||
) |
Fill the buffer with the default name for a savegame or screenshot.
buf | the buffer to write to. |
last | the last element in the buffer. |
Definition at line 3360 of file saveload.cpp.
References _local_company, _settings_client, GUISettings::date_format_in_default_names, ClientSettings::gui, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::Iterate(), and SetDParam().
Referenced by SaveLoadWindow::GenerateFileName().
|
inlinestatic |
Get the FileType of a setting.
This describes the integer type as it is represented in a savegame/file
type | VarType holding information about the file-type |
Definition at line 1074 of file saveload.h.
Referenced by GetSavegameFileType(), GetSettingsDesc(), and SlCalcConvFileLen().
|
inlinestatic |
Get the address of the variable.
Null-variables don't have an address, everything else has a callback function that returns the address based on the saveload data and the current object for non-globals.
Definition at line 1094 of file saveload.h.
References SaveLoad::address_proc, SaveLoad::conv, SaveLoad::extra_data, GetVarMemType(), and SLE_VAR_NULL.
Referenced by ListSettingDesc::FormatValue(), ListSettingDesc::ParseValue(), IntSettingDesc::Read(), StringSettingDesc::Read(), IntSettingDesc::Write(), and StringSettingDesc::Write().
|
inlinestatic |
Get the NumberType of a setting.
This describes the integer type as it is represented in memory
type | VarType holding information about the variable-type |
Definition at line 1063 of file saveload.h.
Referenced by StringSettingDesc::FormatValue(), ListSettingDesc::FormatValue(), GetVariableAddress(), IsNumericType(), StringSettingDesc::IsSameValue(), IsVariableSizeRight(), IntSettingDesc::MakeValueValid(), ListSettingDesc::ParseValue(), ReadValue(), SetSettingValue(), SlCalcConvMemLen(), SlCalcDequeLen(), SlCalcStringLen(), SlCalcVectorLen(), SlCopyInternal(), SlDeque(), SlString(), SlVector(), and WriteValue().
|
inlinestatic |
Check if the given saveload type is a numeric type.
conv | the type to check |
Definition at line 1084 of file saveload.h.
References GetVarMemType().
|
inlinestatic |
Checks whether the savegame is below major.
minor.
major | Major number of the version to check against. |
minor | Minor number of the version to check against. If minor is 0 or not specified, only the major number is checked. |
Definition at line 1024 of file saveload.h.
References _sl_minor_version, and _sl_version.
Referenced by CargoPacket::AfterLoad(), AfterLoadLinkGraphs(), AfterLoadStoryBook(), Order::ConvertFromOldSavegame(), ORDRChunkHandler::FixPointers(), CITYChunkHandler::FixPointers(), STNSChunkHandler::FixPointers(), STNNChunkHandler::FixPointers(), SlTownSupplied::GetNumCargo(), SlStationGoods::GetNumCargo(), SlCompanyLiveries::GetNumLiveries(), GetSavegameFileType(), GetSettingsDesc(), HandleOldDiffCustom(), IntToReference(), PRICChunkHandler::Load(), CAPRChunkHandler::Load(), ANITChunkHandler::Load(), SIGNChunkHandler::Load(), CHTSChunkHandler::Load(), CMDLChunkHandler::Load(), CMPUChunkHandler::Load(), ORDRChunkHandler::Load(), IBLDChunkHandler::Load(), MAPEChunkHandler::Load(), LGRSChunkHandler::Load(), ScriptInstance::LoadObjects(), LoadSettings(), MoveWaypointsToBaseStations(), and SlCalcRefLen().
|
inlinestatic |
Checks whether the savegame is below or at major.
This should be used to repair data from existing savegames which is no longer corrupted in new savegames, but for which otherwise no savegame bump is required.
major | Major number of the version to check against. |
Definition at line 1038 of file saveload.h.
References _sl_version.
SaveOrLoadResult LoadWithFilter | ( | LoadFilter * | reader | ) |
Load the game using a (reader) filter.
reader | The filter to read the savegame from. |
Definition at line 3220 of file saveload.cpp.
References _sl, SaveLoadParams::action, ClearSaveLoadState(), DoLoad(), SL_REINIT, and SLA_LOAD.
int64 ReadValue | ( | const void * | ptr, |
VarType | conv | ||
) |
Return a signed-long version of the value of a setting.
ptr | pointer to the variable |
conv | type of variable, can be a non-clean type, eg one with other flags because it is parsed |
Definition at line 804 of file saveload.cpp.
References GetVarMemType().
Referenced by IntSettingDesc::Read().
void NORETURN bool SaveloadCrashWithMissingNewGRFs | ( | ) |
Did loading the savegame cause a crash? If so, were NewGRFs missing?
Definition at line 365 of file afterload.cpp.
References _saveload_crash_with_missing_newgrfs.
Referenced by HandleCrash().
SaveOrLoadResult SaveOrLoad | ( | const std::string & | filename, |
SaveLoadOperation | fop, | ||
DetailedFileType | dft, | ||
Subdirectory | sb, | ||
bool | threaded | ||
) |
Main Save or Load function where the high-level saveload functions are handled.
It opens the savegame, selects format and checks versions
filename | The name of the savegame being created/loaded |
fop | Save or load mode. Load can also be a TTD(Patch) game. |
sb | The sub directory to save the savegame in |
threaded | True when threaded saving is allowed |
Definition at line 3240 of file saveload.cpp.
References _do_autosave, _sl, DFT_GAME_FILE, INVALID_STRING_ID, SaveLoadParams::saveinprogress, ShowErrorMessage(), SL_OK, SLO_SAVE, and WL_ERROR.
Referenced by DEF_CONSOLE_CMD(), DoExitSave(), VideoDriver_Dedicated::MainLoop(), and CrashLog::WriteSavegame().
SaveOrLoadResult SaveWithFilter | ( | SaveFilter * | writer, |
bool | threaded | ||
) |
Save the game using a (writer) filter.
writer | The filter to write the savegame to. |
threaded | Whether to try to perform the saving asynchronously. |
Definition at line 3062 of file saveload.cpp.
References _sl, SaveLoadParams::action, ClearSaveLoadState(), DoSave(), SL_ERROR, and SLA_SAVE.
void SlAutolength | ( | AutolengthProc * | proc, |
void * | arg | ||
) |
Do something of which I have no idea what it is :P.
proc | The callback procedure that is called |
arg | The variable that will be used for the callback procedure |
Definition at line 2093 of file saveload.cpp.
size_t SlCalcObjLength | ( | const void * | object, |
const SaveLoadTable & | slt | ||
) |
Calculate the size of an object.
object | to be measured. |
slt | The SaveLoad table with objects to save/load. |
Definition at line 1594 of file saveload.cpp.
Referenced by SlObject().
std::vector<SaveLoad> SlCompatTableHeader | ( | const SaveLoadTable & | slt, |
const SaveLoadCompatTable & | slct | ||
) |
Load a table header in a savegame compatible way.
If the savegame was made before table headers were added, it will fall back to the SaveLoadCompatTable for the order of fields while loading.
slt | The SaveLoad table with objects to save/load. |
slct | The SaveLoadCompat table the original order of the fields. |
Definition at line 2029 of file saveload.cpp.
References _sl, SaveLoadParams::action, SaveLoadParams::block_mode, SLA_LOAD, and SLA_LOAD_CHECK.
Referenced by NewGRFMappingChunkHandler::Load(), PSACChunkHandler::Load(), GOALChunkHandler::Load(), ERNWChunkHandler::Load(), MAPSChunkHandler::Load(), GRPSChunkHandler::Load(), DEPTChunkHandler::Load(), SUBSChunkHandler::Load(), SIGNChunkHandler::Load(), OBJSChunkHandler::Load(), CHTSChunkHandler::Load(), STPEChunkHandler::Load(), GSDTChunkHandler::Load(), AIPLChunkHandler::Load(), CMDLChunkHandler::Load(), ECMYChunkHandler::Load(), INDYChunkHandler::Load(), STPAChunkHandler::Load(), ENGNChunkHandler::Load(), CAPYChunkHandler::Load(), CMPUChunkHandler::Load(), CAPAChunkHandler::Load(), RAILChunkHandler::Load(), IBLDChunkHandler::Load(), VIEWChunkHandler::Load(), GSTRChunkHandler::Load(), ITBLChunkHandler::Load(), EIDSChunkHandler::Load(), ORDLChunkHandler::Load(), LGRPChunkHandler::Load(), LGRJChunkHandler::Load(), CITYChunkHandler::Load(), BKORChunkHandler::Load(), LGRSChunkHandler::Load(), STNSChunkHandler::Load(), PLYRChunkHandler::Load(), STNNChunkHandler::Load(), ROADChunkHandler::Load(), VEHSChunkHandler::Load(), MAPSChunkHandler::LoadCheck(), PLYRChunkHandler::LoadCheck(), and LoadSettings().
void SlCopy | ( | void * | object, |
size_t | length, | ||
VarType | conv | ||
) |
Copy a list of SL_VARs to/from a savegame.
These entries are copied as-is, and you as caller have to make sure things like length-fields are calculated correctly.
object | The object being manipulated. |
length | The length of the object in elements |
conv | VarType type of the items. |
Definition at line 1151 of file saveload.cpp.
References _sl, SaveLoadParams::action, SaveLoadParams::need_length, NL_CALCLENGTH, NL_NONE, SLA_NULL, SLA_PTRS, SlCalcConvFileLen(), SlCopyInternal(), and SlSetLength().
Referenced by ANITChunkHandler::Load(), MAPTChunkHandler::Load(), MAPHChunkHandler::Load(), NAMEChunkHandler::Load(), MAPOChunkHandler::Load(), MAP2ChunkHandler::Load(), ENGSChunkHandler::Load(), M3LOChunkHandler::Load(), M3HIChunkHandler::Load(), MAP5ChunkHandler::Load(), MAPEChunkHandler::Load(), MAP7ChunkHandler::Load(), MAP8ChunkHandler::Load(), and ScriptInstance::LoadObjects().
void NORETURN SlError | ( | StringID | string, |
const char * | extra_msg | ||
) |
Error handler.
Sets everything up to show an error message and to clean up the mess of a partial savegame load.
string | The translatable error message to show. |
extra_msg | An extra error message coming from one of the APIs. |
Definition at line 332 of file saveload.cpp.
References _load_check_data, _sl, SaveLoadParams::action, LoadCheckData::error, LoadCheckData::error_data, SaveLoadParams::error_str, SaveLoadParams::extra_msg, free(), SLA_LOAD, SLA_LOAD_CHECK, SLA_PTRS, SlNullPointers(), and stredup().
Referenced by DoLoad(), PacketWriter::Finish(), LZMALoadFilter::LZMALoadFilter(), LZMASaveFilter::LZMASaveFilter(), LZOLoadFilter::LZOLoadFilter(), LZOSaveFilter::LZOSaveFilter(), LZMALoadFilter::Read(), SlErrorCorrupt(), PacketWriter::Write(), FileWriter::Write(), ZlibSaveFilter::WriteLoop(), LZMASaveFilter::WriteLoop(), and ZlibSaveFilter::ZlibSaveFilter().
void NORETURN SlErrorCorrupt | ( | const char * | msg | ) |
Error handler for corrupt savegames.
Sets everything up to show the error message and to clean up the mess of a partial savegame load.
msg | Location the corruption has been spotted. |
Definition at line 364 of file saveload.cpp.
References SlError().
Referenced by IntToReference(), NewGRFMappingChunkHandler::Load(), CHTSChunkHandler::Load(), NAMEChunkHandler::Load(), IBLDChunkHandler::Load(), ITBLChunkHandler::Load(), LGRSChunkHandler::Load(), LoadSettings(), SetWaterClassDependingOnSurroundings(), SlErrorCorruptFmt(), and SlReadSimpleGamma().
size_t SlGetStructListLength | ( | size_t | limit | ) |
Get the length of this list; if it exceeds the limit, error out.
limit | The maximum size the list can be. |
Definition at line 1825 of file saveload.cpp.
Referenced by SlTownSupplied::GetNumCargo(), SlStationGoods::GetNumCargo(), and SlSkipHandler::Load().
void SlGlobList | ( | const SaveLoadTable & | slt | ) |
Save or Load (a list of) global variables.
slt | The SaveLoad table with objects to save/load. |
Definition at line 2083 of file saveload.cpp.
References SlObject().
Referenced by IBLDChunkHandler::Load().
|
inlinestatic |
Checks if some version from/to combination falls within the range of the active savegame version.
version_from | Inclusive savegame version lower bound. |
version_to | Exclusive savegame version upper bound. SL_MAX_VERSION if no upper bound. |
Definition at line 1051 of file saveload.h.
References SAVEGAME_VERSION.
Referenced by CmdChangeSetting(), GetSaveLoadFromSettingTable(), GetSettingFromName(), IniLoadSettings(), IniSaveSettings(), and LoadSettings().
int SlIterateArray | ( | ) |
Iterate through the elements of an array and read the whole thing.
Definition at line 670 of file saveload.cpp.
Referenced by NewGRFMappingChunkHandler::Load(), PSACChunkHandler::Load(), SIGNChunkHandler::Load(), CHTSChunkHandler::Load(), CMDLChunkHandler::Load(), CMPUChunkHandler::Load(), CAPAChunkHandler::Load(), NAMEChunkHandler::Load(), IBLDChunkHandler::Load(), ITBLChunkHandler::Load(), LGRPChunkHandler::Load(), LGRJChunkHandler::Load(), LGRSChunkHandler::Load(), LoadSettings(), and SlSkipArray().
void SlObject | ( | void * | object, |
const SaveLoadTable & | slt | ||
) |
Main SaveLoad function.
object | The object that is being saved or loaded. |
slt | The SaveLoad table with objects to save/load. |
Definition at line 1838 of file saveload.cpp.
References _sl, SaveLoadParams::need_length, NL_CALCLENGTH, NL_NONE, SlCalcObjLength(), and SlSetLength().
Referenced by OBJSChunkHandler::FixPointers(), ERNWChunkHandler::FixPointers(), DEPTChunkHandler::FixPointers(), INDYChunkHandler::FixPointers(), CAPYChunkHandler::FixPointers(), ORDRChunkHandler::FixPointers(), CHKPChunkHandler::FixPointers(), ORDLChunkHandler::FixPointers(), BKORChunkHandler::FixPointers(), CITYChunkHandler::FixPointers(), LGRSChunkHandler::FixPointers(), STNSChunkHandler::FixPointers(), PLYRChunkHandler::FixPointers(), STNNChunkHandler::FixPointers(), ROADChunkHandler::FixPointers(), VEHSChunkHandler::FixPointers(), NewGRFMappingChunkHandler::Load(), PSACChunkHandler::Load(), SIGNChunkHandler::Load(), CHTSChunkHandler::Load(), CMDLChunkHandler::Load(), CMPUChunkHandler::Load(), CAPAChunkHandler::Load(), ScriptInstance::Load(), ITBLChunkHandler::Load(), LGRPChunkHandler::Load(), LGRJChunkHandler::Load(), LGRSChunkHandler::Load(), ScriptInstance::LoadEmpty(), ScriptInstance::LoadObjects(), LoadSettings(), ScriptInstance::Save(), ScriptInstance::SaveEmpty(), ScriptInstance::SaveObject(), and SlGlobList().
byte SlReadByte | ( | ) |
Wrapper for reading a byte from the buffer.
Definition at line 424 of file saveload.cpp.
References _sl, and SaveLoadParams::reader.
Referenced by SlCopyBytes(), SlLoadCheckChunk(), SlLoadChunk(), SlReadSimpleGamma(), and SlSkipBytes().
void SlSetLength | ( | size_t | length | ) |
Sets the length of either a RIFF object or the number of items in an array.
This lets us load an object or an array of arbitrary size
length | The length of the sought object/array |
Definition at line 723 of file saveload.cpp.
References _sl, SaveLoadParams::action, SaveLoadParams::block_mode, SaveLoadParams::need_length, NL_NONE, NL_WANTLENGTH, and SLA_SAVE.
Referenced by MAPTChunkHandler::Save(), MAPHChunkHandler::Save(), MAPOChunkHandler::Save(), MAP2ChunkHandler::Save(), M3LOChunkHandler::Save(), M3HIChunkHandler::Save(), MAP5ChunkHandler::Save(), MAPEChunkHandler::Save(), MAP7ChunkHandler::Save(), MAP8ChunkHandler::Save(), SlCopy(), SlObject(), SlRefList(), and SlSetStructListLength().
void SlSetStructListLength | ( | size_t | length | ) |
Set the length of this list.
The | length of the list. |
Definition at line 1809 of file saveload.cpp.
References _sl, SaveLoadParams::need_length, NL_NONE, and SlSetLength().
|
inlinestatic |
Read in bytes from the file/data structure but don't do anything with them, discarding them in effect.
length | The amount of bytes that is being treated this way |
Definition at line 1141 of file saveload.h.
References SlReadByte().
Referenced by SlCopyInternal(), and SlSkipArray().
std::vector<SaveLoad> SlTableHeader | ( | const SaveLoadTable & | slt | ) |
Save or Load a table header.
slt | The SaveLoad table with objects to save/load. |
Definition at line 1891 of file saveload.cpp.
References _sl, and SaveLoadParams::block_mode.
Referenced by NewGRFMappingChunkHandler::Save(), ANITChunkHandler::Save(), GOALChunkHandler::Save(), ERNWChunkHandler::Save(), MAPSChunkHandler::Save(), GRPSChunkHandler::Save(), DEPTChunkHandler::Save(), SUBSChunkHandler::Save(), OBJSChunkHandler::Save(), SIGNChunkHandler::Save(), CHTSChunkHandler::Save(), PSACChunkHandler::Save(), STPEChunkHandler::Save(), CMDLChunkHandler::Save(), ECMYChunkHandler::Save(), NGRFChunkHandler::Save(), INDYChunkHandler::Save(), ENGNChunkHandler::Save(), STPAChunkHandler::Save(), CMPUChunkHandler::Save(), CAPYChunkHandler::Save(), DATEChunkHandler::Save(), RAILChunkHandler::Save(), CAPAChunkHandler::Save(), GSDTChunkHandler::Save(), AIPLChunkHandler::Save(), IBLDChunkHandler::Save(), VIEWChunkHandler::Save(), ITBLChunkHandler::Save(), GSTRChunkHandler::Save(), EIDSChunkHandler::Save(), LGRPChunkHandler::Save(), LGRJChunkHandler::Save(), CITYChunkHandler::Save(), LGRSChunkHandler::Save(), GLOGChunkHandler::Save(), PLYRChunkHandler::Save(), STNNChunkHandler::Save(), ROADChunkHandler::Save(), VEHSChunkHandler::Save(), and SaveSettings().
void SlWriteByte | ( | byte | b | ) |
Wrapper for writing a byte to the dumper.
b | The byte to write. |
Definition at line 433 of file saveload.cpp.
References _sl, SaveLoadParams::dumper, and MemoryDumper::WriteByte().
Referenced by SlCopyBytes().
void WriteValue | ( | void * | ptr, |
VarType | conv, | ||
int64 | val | ||
) |
Write the value of a setting.
ptr | pointer to the variable |
conv | type of variable, can be a non-clean type, eg with other flags. It is parsed upon read |
val | the new value being given to the variable |
Definition at line 828 of file saveload.cpp.
References GetVarMemType().
Referenced by IntSettingDesc::Write().