2009-08-21 22:21:05 +02:00
|
|
|
/*
|
|
|
|
* This file is part of OpenTTD.
|
|
|
|
* 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.
|
|
|
|
* 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.
|
|
|
|
* 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/>.
|
|
|
|
*/
|
|
|
|
|
2009-01-12 18:11:45 +01:00
|
|
|
/** @file ai_info.hpp AIInfo keeps track of all information of an AI, like Author, Description, ... */
|
|
|
|
|
2010-12-22 12:46:41 +01:00
|
|
|
#ifndef AI_INFO_HPP
|
|
|
|
#define AI_INFO_HPP
|
2009-01-12 18:11:45 +01:00
|
|
|
|
2009-03-15 23:41:57 +01:00
|
|
|
#include "../script/script_info.hpp"
|
2009-01-12 18:11:45 +01:00
|
|
|
|
2010-08-01 00:16:34 +02:00
|
|
|
/** All static information from an AI like name, version, etc. */
|
2011-11-30 00:21:52 +01:00
|
|
|
class AIInfo : public ScriptInfo {
|
2009-01-12 18:11:45 +01:00
|
|
|
public:
|
2009-12-06 21:22:21 +01:00
|
|
|
AIInfo();
|
2009-01-12 18:11:45 +01:00
|
|
|
|
2011-11-30 00:21:52 +01:00
|
|
|
/**
|
|
|
|
* Register the functions of this class.
|
|
|
|
*/
|
|
|
|
static void RegisterAPI(Squirrel *engine);
|
|
|
|
|
2009-01-12 18:11:45 +01:00
|
|
|
/**
|
|
|
|
* Create an AI, using this AIInfo as start-template.
|
|
|
|
*/
|
|
|
|
static SQInteger Constructor(HSQUIRRELVM vm);
|
2010-08-01 00:16:34 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a dummy-AI.
|
|
|
|
*/
|
2009-01-12 18:11:45 +01:00
|
|
|
static SQInteger DummyConstructor(HSQUIRRELVM vm);
|
|
|
|
|
2009-02-13 02:44:56 +01:00
|
|
|
/**
|
|
|
|
* Check if we can start this AI.
|
|
|
|
*/
|
2009-02-13 03:11:54 +01:00
|
|
|
bool CanLoadFromVersion(int version) const;
|
2009-02-13 02:44:56 +01:00
|
|
|
|
2009-04-21 21:13:32 +02:00
|
|
|
/**
|
|
|
|
* Use this AI as a random AI.
|
|
|
|
*/
|
|
|
|
bool UseAsRandomAI() const { return this->use_as_random; }
|
|
|
|
|
2009-08-18 20:51:42 +02:00
|
|
|
/**
|
|
|
|
* Get the API version this AI is written for.
|
|
|
|
*/
|
2023-05-04 23:06:21 +02:00
|
|
|
const std::string &GetAPIVersion() const { return this->api_version; }
|
2009-08-18 20:51:42 +02:00
|
|
|
|
2009-01-12 18:11:45 +01:00
|
|
|
private:
|
2011-11-30 00:26:35 +01:00
|
|
|
int min_loadable_version; ///< The AI can load savegame data if the version is equal or greater than this.
|
|
|
|
bool use_as_random; ///< Should this AI be used when the user wants a "random AI"?
|
2023-05-04 23:06:21 +02:00
|
|
|
std::string api_version; ///< API version used by this AI.
|
2009-01-12 18:11:45 +01:00
|
|
|
};
|
|
|
|
|
2010-08-01 00:16:34 +02:00
|
|
|
/** All static information from an AI library like name, version, etc. */
|
2011-11-30 00:21:52 +01:00
|
|
|
class AILibrary : public ScriptInfo {
|
2009-01-12 18:11:45 +01:00
|
|
|
public:
|
2023-05-06 09:53:57 +02:00
|
|
|
AILibrary() : ScriptInfo() {};
|
2009-01-15 16:56:10 +01:00
|
|
|
|
2011-11-30 00:21:52 +01:00
|
|
|
/**
|
|
|
|
* Register the functions of this class.
|
|
|
|
*/
|
|
|
|
static void RegisterAPI(Squirrel *engine);
|
|
|
|
|
2009-01-12 18:11:45 +01:00
|
|
|
/**
|
|
|
|
* Create an AI, using this AIInfo as start-template.
|
|
|
|
*/
|
|
|
|
static SQInteger Constructor(HSQUIRRELVM vm);
|
|
|
|
|
2009-01-15 16:56:10 +01:00
|
|
|
/**
|
|
|
|
* Get the category this library is in.
|
|
|
|
*/
|
2023-05-06 09:53:57 +02:00
|
|
|
const std::string &GetCategory() const { return this->category; }
|
2009-01-15 16:56:10 +01:00
|
|
|
|
|
|
|
private:
|
2023-05-06 09:53:57 +02:00
|
|
|
std::string category; ///< The category this library is in.
|
2009-01-12 18:11:45 +01:00
|
|
|
};
|
|
|
|
|
2010-12-22 12:46:41 +01:00
|
|
|
#endif /* AI_INFO_HPP */
|