OpenTTD Source 20260820-master-g39da062c0c
fios.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 <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
6 */
7
9
10#ifndef FIOS_H
11#define FIOS_H
12
13#include "gfx_type.h"
14#include "company_base.h"
15#include "newgrf_config.h"
16#include "gamelog.h"
19
20
27
35
36using CompanyPropertiesMap = std::map<uint, std::unique_ptr<CompanyProperties>>;
37
41struct LoadCheckData {
42 bool checkable = false;
44 std::string error_msg{};
45
46 uint32_t map_size_x = 0;
47 uint32_t map_size_y = 0;
48 TimerGameCalendar::Date current_date{};
49
52
53 CompanyPropertiesMap companies{};
54
55 GRFConfigList grfconfig{};
57
59
60 LoadCheckData() {}
61
66 bool HasErrors()
67 {
68 return this->checkable && this->error != INVALID_STRING_ID;
69 }
70
76 {
77 return this->checkable && this->error == INVALID_STRING_ID && !this->grfconfig.empty();
78 }
79
80 void Clear();
81};
82
84
86struct FiosItem {
87 FiosType type;
88 int64_t mtime;
89 EncodedString title;
90 std::string name;
91};
92
94class FileList : public std::vector<FiosItem> {
95public:
96 void BuildFileList(AbstractFileType abstract_filetype, SaveLoadOperation fop, bool show_dirs);
97 const FiosItem *FindItem(std::string_view file);
98};
99bool FiosItemSorter(const FiosItem &a, const FiosItem &b);
100bool FiosItemNameSorter(const FiosItem &a, const FiosItem &b);
101bool FiosItemModificationDateSorter(const FiosItem &a, const FiosItem &b);
102
103void ShowSaveLoadDialog(AbstractFileType abstract_filetype, SaveLoadOperation fop);
104
105void FiosGetSavegameList(SaveLoadOperation fop, bool show_dirs, FileList &file_list);
106void FiosGetScenarioList(SaveLoadOperation fop, bool show_dirs, FileList &file_list);
107void FiosGetHeightmapList(SaveLoadOperation fop, bool show_dirs, FileList &file_list);
108void FiosGetTownDataList(SaveLoadOperation fop, bool show_dirs, FileList &file_list);
109
110bool FiosBrowseTo(const FiosItem *item);
111
112std::string FiosGetCurrentPath();
113std::optional<uint64_t> FiosGetDiskFreeSpace(const std::string &path);
114std::string FiosMakeHeightmapName(std::string_view name);
115std::string FiosMakeSavegameName(std::string_view name);
116DirectoryCreateResult FiosCreateDirectory(std::string_view name);
117
118std::tuple<FiosType, std::string> FiosGetSavegameListCallback(SaveLoadOperation fop, std::string_view file, std::string_view ext);
119std::tuple<FiosType, std::string> FiosGetScenarioListCallback(SaveLoadOperation fop, std::string_view file, std::string_view ext);
120std::tuple<FiosType, std::string> FiosGetHeightmapListCallback(SaveLoadOperation fop, std::string_view file, std::string_view ext);
121
122void ScanScenarios();
123std::optional<std::string_view> FindScenario(const ContentInfo &ci, bool md5sum);
124
129 FiosNumberedSaveName(const std::string &prefix);
130 std::string Filename();
131 std::string Extension();
132private:
133 std::string prefix;
134 int number;
135};
136
137#endif /* FIOS_H */
Container for an encoded string, created by GetEncodedString.
List of file information.
Definition fios.h:94
void BuildFileList(AbstractFileType abstract_filetype, SaveLoadOperation fop, bool show_dirs)
Construct a file list with the given kind of files, for the stated purpose.
Definition fios.cpp:57
const FiosItem * FindItem(std::string_view file)
Find file information of a file by its name from the file list.
Definition fios.cpp:93
StrongType::Typedef< int32_t, struct YearTag< struct Calendar >, StrongType::Compare, StrongType::Integer > Year
StrongType::Typedef< int32_t, DateTag< struct Calendar >, StrongType::Compare, StrongType::Integer > Date
Definition of stuff that is very close to a company, like the company struct itself.
SaveLoadOperation
Operation performed on the file.
Definition fileio_type.h:52
AbstractFileType
The different abstract types of files that the system knows about.
Definition fileio_type.h:17
bool FiosItemSorter(const FiosItem &a, const FiosItem &b)
Sorts the FiosItems based on the savegame sorter and order.
Definition fios_gui.cpp:57
std::tuple< FiosType, std::string > FiosGetScenarioListCallback(SaveLoadOperation fop, std::string_view file, std::string_view ext)
Callback for FiosGetFileList.
Definition fios.cpp:461
DirectoryCreateResult
Outcome of a directory creation attempt.
Definition fios.h:29
@ PermissionDenied
The OS rejected the operation for permission reasons.
Definition fios.h:32
@ Success
Directory was created.
Definition fios.h:30
@ OtherError
Any other filesystem error.
Definition fios.h:33
@ AlreadyExists
A file or directory with that name already exists.
Definition fios.h:31
bool FiosItemModificationDateSorter(const FiosItem &a, const FiosItem &b)
Sort files by their modification date, and name when they are equal.
Definition fios.cpp:45
void ShowSaveLoadDialog(AbstractFileType abstract_filetype, SaveLoadOperation fop)
Launch save/load dialog in the given mode.
std::optional< std::string_view > FindScenario(const ContentInfo &ci, bool md5sum)
Find a given scenario based on its unique ID.
Definition fios.cpp:685
std::string FiosMakeSavegameName(std::string_view name)
Make a save game or scenario filename from a name.
Definition fios.cpp:239
bool FiosItemNameSorter(const FiosItem &a, const FiosItem &b)
Sort files by their name.
Definition fios.cpp:39
std::tuple< FiosType, std::string > FiosGetSavegameListCallback(SaveLoadOperation fop, std::string_view file, std::string_view ext)
Callback for FiosGetFileList.
Definition fios.cpp:412
std::string FiosGetCurrentPath()
Get the current path/working directory.
Definition fios.cpp:123
SaveLoadInvalidateWindowData
Special values for save-load window for the data parameter of InvalidateWindowData.
Definition fios.h:22
@ SLIWD_FILTER_CHANGES
The filename filter has changed (via the editbox).
Definition fios.h:25
@ SLIWD_SELECTION_CHANGES
File selection has changed (user click, ...).
Definition fios.h:24
@ SLIWD_RESCAN_FILES
Rescan all files (when changed directory, ...).
Definition fios.h:23
void FiosGetSavegameList(SaveLoadOperation fop, bool show_dirs, FileList &file_list)
Get a list of savegames.
Definition fios.cpp:441
void FiosGetHeightmapList(SaveLoadOperation fop, bool show_dirs, FileList &file_list)
Get a list of heightmaps.
Definition fios.cpp:548
void ScanScenarios()
Force a (re)scan of the scenarios.
Definition fios.cpp:713
std::string FiosMakeHeightmapName(std::string_view name)
Construct a filename for a height map.
Definition fios.cpp:251
void FiosGetScenarioList(SaveLoadOperation fop, bool show_dirs, FileList &file_list)
Get a list of scenarios.
Definition fios.cpp:488
LoadCheckData _load_check_data
Data loaded from save during SL_LOAD_CHECK.
Definition fios_gui.cpp:42
DirectoryCreateResult FiosCreateDirectory(std::string_view name)
Create a new subdirectory inside the current FIOS path.
Definition fios.cpp:134
bool FiosBrowseTo(const FiosItem *item)
Browse to a new path based on the passed item, starting at _fios_path.
Definition fios.cpp:165
void FiosGetTownDataList(SaveLoadOperation fop, bool show_dirs, FileList &file_list)
Get a list of town data files.
Definition fios.cpp:585
Functions to be called to log fundamental changes to the game.
Types related to the graphics and/or input devices.
LandscapeType
Landscape types.
Functions to find and configure NewGRFs.
GRFListCompatibility
Status of post-gameload GRF compatibility check.
@ NotFound
At least one GRF couldn't be found (higher priority than GRFListCompatibility::Compatible).
StrongType::Typedef< uint32_t, struct StringIDTag, StrongType::Compare, StrongType::Integer > StringID
Numeric value that represents a string, independent of the selected language.
static constexpr StringID INVALID_STRING_ID
Constant representing an invalid string (16bit in case it is used in savegames).
Container for all important information about a piece of content.
Deals with finding savegames.
Definition fios.h:86
std::string Filename()
Generate a savegame name and number according to _settings_client.gui.max_num_autosaves.
Definition fios.cpp:755
FiosNumberedSaveName(const std::string &prefix)
Constructs FiosNumberedSaveName.
Definition fios.cpp:722
std::string Extension()
Generate an extension for a savegame name.
Definition fios.cpp:765
Elements of a file system that are recognized.
Definition fileio_type.h:63
Container for loading in mode SL_LOAD_CHECK.
Definition fios.h:41
bool checkable
True if the savegame could be checked by SL_LOAD_CHECK. (Old savegames are not checkable....
Definition fios.h:42
bool HasNewGrfs()
Check whether the game uses any NewGrfs.
Definition fios.h:75
std::string error_msg
Data to pass to string parameters when displaying error.
Definition fios.h:44
TimerGameCalendar::Year starting_year
Starting date.
Definition fios.h:51
CompanyPropertiesMap companies
Company information.
Definition fios.h:53
StringID error
Error message from loading. INVALID_STRING_ID if no error.
Definition fios.h:43
Gamelog gamelog
Gamelog actions.
Definition fios.h:58
bool HasErrors()
Check whether loading the game resulted in errors.
Definition fios.h:66
void Clear()
Reset read data.
Definition fios_gui.cpp:72
GRFListCompatibility grf_compatibility
Summary state of NewGrfs, whether missing files or only compatible found.
Definition fios.h:56
LandscapeType landscape
Landscape type.
Definition fios.h:50
GRFConfigList grfconfig
NewGrf configuration from save.
Definition fios.h:55
Basic types related to the content on the content server.
Definition of the game-calendar-timer.