OpenTTD Source  20240919-master-gdf0233f4c2
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 
21 void GameScannerInfo::Initialize()
22 {
23  ScriptScanner::Initialize("GSScanner");
24 }
25 
27 {
28  return info->GetName();
29 }
30 
32 {
34 }
35 
36 GameInfo *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 
73 void 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 
85 {
87 }
88 
89 GameLibrary *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  ScriptInfoList::iterator 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 }
game_info.hpp
GameScannerInfo::GetScriptName
std::string GetScriptName(ScriptInfo *info) override
Get the script name how to store the script in memory.
Definition: game_scanner.cpp:26
GameScannerLibrary::FindLibrary
class GameLibrary * FindLibrary(const std::string &library, int version)
Find a library in the pool.
Definition: game_scanner.cpp:89
ScriptScanner::engine
class Squirrel * engine
The engine we're scanning with.
Definition: script_scanner.hpp:87
GameLibrary::GetCategory
const std::string & GetCategory() const
Get the category this library is in.
Definition: game_info.hpp:66
Squirrel
Definition: squirrel.hpp:23
GameScannerInfo::RegisterAPI
void RegisterAPI(class Squirrel *engine) override
Register the API for this ScriptInfo.
Definition: game_scanner.cpp:31
GameInfo::CanLoadFromVersion
bool CanLoadFromVersion(int version) const
Check if we can start this Game.
Definition: game_info.cpp:94
ScriptInfo::GetName
const std::string & GetName() const
Get the Name of the script.
Definition: script_info.hpp:46
GameLibrary::RegisterAPI
static void RegisterAPI(Squirrel *engine)
Register the functions of this class.
Definition: game_info.cpp:101
game_scanner.hpp
GameInfo::RegisterAPI
static void RegisterAPI(Squirrel *engine)
Register the functions of this class.
Definition: game_info.cpp:34
ScriptScanner::info_list
ScriptInfoList info_list
The list of all script.
Definition: script_scanner.hpp:91
ScriptInfo::GetVersion
int GetVersion() const
Get the version of the script.
Definition: script_info.hpp:61
GameScannerLibrary::GetScriptName
std::string GetScriptName(ScriptInfo *info) override
Get the script name how to store the script in memory.
Definition: game_scanner.cpp:78
GameInfo
All static information from an Game like name, version, etc.
Definition: game_info.hpp:16
StrEqualsIgnoreCase
bool StrEqualsIgnoreCase(const std::string_view str1, const std::string_view str2)
Compares two string( view)s for equality, while ignoring the case of the characters.
Definition: string.cpp:347
GameScannerInfo::FindInfo
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.
Definition: game_scanner.cpp:36
GameScannerLibrary::RegisterAPI
void RegisterAPI(class Squirrel *engine) override
Register the API for this ScriptInfo.
Definition: game_scanner.cpp:84
GameLibrary
All static information from an Game library like name, version, etc.
Definition: game_info.hpp:49
ScriptInfo::GetInstanceName
const std::string & GetInstanceName() const
Get the name of the instance of the script to create.
Definition: script_info.hpp:71
ScriptInfo
All static information from an Script like name, version, etc.
Definition: script_info.hpp:30
ScriptScanner::info_single_list
ScriptInfoList info_single_list
The list of all unique script. The best script (highest version) is shown.
Definition: script_scanner.hpp:92