OpenTTD Source 20250714-master-g67e56391c7
game_scanner.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 "../script/squirrel_class.hpp"
13#include "game_info.hpp"
14#include "game_scanner.hpp"
15
16#include "../3rdparty/fmt/format.h"
17
18#include "../safeguards.h"
19
20
21void GameScannerInfo::Initialize()
22{
23 ScriptScanner::Initialize("GSScanner");
24}
25
27{
28 return info.GetName();
29}
30
35
36GameInfo *GameScannerInfo::FindInfo(const std::string &name, int version, bool force_exact_match)
37{
38 if (this->info_list.empty()) return nullptr;
39 if (name.empty()) return nullptr;
40
41 if (version == -1) {
42 /* We want to load the latest version of this Game script; so find it */
43 auto it = this->info_single_list.find(name);
44 if (it != this->info_single_list.end()) return static_cast<GameInfo *>(it->second);
45 return nullptr;
46 }
47
48 if (force_exact_match) {
49 /* Try to find a direct 'name.version' match */
50 std::string name_with_version = fmt::format("{}.{}", name, version);
51 auto it = this->info_list.find(name_with_version);
52 if (it != this->info_list.end()) return static_cast<GameInfo *>(it->second);
53 return nullptr;
54 }
55
56 GameInfo *info = nullptr;
57 int highest_version = -1;
58
59 /* See if there is a compatible Game script which goes by that name, with the highest
60 * version which allows loading the requested version */
61 for (const auto &item : this->info_list) {
62 GameInfo *i = static_cast<GameInfo *>(item.second);
63 if (StrEqualsIgnoreCase(name, i->GetName()) && i->CanLoadFromVersion(version) && (highest_version == -1 || i->GetVersion() > highest_version)) {
64 highest_version = item.second->GetVersion();
65 info = i;
66 }
67 }
68
69 return info;
70}
71
72
73void GameScannerLibrary::Initialize()
74{
75 ScriptScanner::Initialize("GSScanner");
76}
77
79{
80 GameLibrary &library = static_cast<GameLibrary &>(info);
81 return fmt::format("{}.{}", library.GetCategory(), library.GetInstanceName());
82}
83
88
89GameLibrary *GameScannerLibrary::FindLibrary(const std::string &library, int version)
90{
91 /* Internally we store libraries as 'library.version' */
92 std::string library_name = fmt::format("{}.{}", library, version);
93
94 /* Check if the library + version exists */
95 auto it = this->info_list.find(library_name);
96 if (it == this->info_list.end()) return nullptr;
97
98 return static_cast<GameLibrary *>(it->second);
99}
All static information from an Game like name, version, etc.
Definition game_info.hpp:16
bool CanLoadFromVersion(int version) const
Check if we can start this Game.
Definition game_info.cpp:91
static void RegisterAPI(Squirrel &engine)
Register the functions of this class.
Definition game_info.cpp:30
All static information from an Game library like name, version, etc.
Definition game_info.hpp:52
static void RegisterAPI(Squirrel &engine)
Register the functions of this class.
Definition game_info.cpp:98
const std::string & GetCategory() const
Get the category this library is in.
Definition game_info.hpp:69
std::string GetScriptName(ScriptInfo &info) override
Get the script name how to store the script in memory.
void RegisterAPI(class Squirrel &engine) override
Register the API for this ScriptInfo.
class GameInfo * FindInfo(const std::string &name, int version, bool force_exact_match)
Check if we have a game by name and version available in our list.
std::string GetScriptName(ScriptInfo &info) override
Get the script name how to store the script in memory.
class GameLibrary * FindLibrary(const std::string &library, int version)
Find a library in the pool.
void RegisterAPI(class Squirrel &engine) override
Register the API for this ScriptInfo.
All static information from an Script like name, version, etc.
const std::string & GetInstanceName() const
Get the name of the instance of the script to create.
const std::string & GetName() const
Get the Name of the script.
int GetVersion() const
Get the version of the script.
ScriptInfoList info_list
The list of all script.
ScriptInfoList info_single_list
The list of all unique script. The best script (highest version) is shown.
std::unique_ptr< class Squirrel > engine
The engine we're scanning with.
GameInfo keeps track of all information of an Game, like Author, Description, ...
declarations of the class for Game scanner
bool StrEqualsIgnoreCase(std::string_view str1, std::string_view str2)
Compares two string( view)s for equality, while ignoring the case of the characters.
Definition string.cpp:321