(svn r15027) -Merge: tomatos and bananas left to be, here is NoAI for all to see.
NoAI is an API (a framework) to build your own AIs in. See: http://wiki.openttd.org/wiki/index.php/AI:Main_Page With many thanks to: - glx and Rubidium for their syncing, feedback and hard work - Yexo for his feedback, patches, and AIs which tested the system very deep - Morloth for his feedback and patches - TJIP for hosting a challenge which kept NoAI on track - All AI authors for testing our AI API, and all other people who helped in one way or another -Remove: all old AIs and their cheats/hacks
This commit is contained in:
truebrain
202
src/ai/api/ai_object.hpp
Normal file
202
src/ai/api/ai_object.hpp
Normal file
@@ -0,0 +1,202 @@
|
||||
/* $Id$ */
|
||||
|
||||
/** @file ai_object.hpp Main object, on which all objects depend. */
|
||||
|
||||
#ifndef AI_OBJECT_HPP
|
||||
#define AI_OBJECT_HPP
|
||||
|
||||
#include "../../stdafx.h"
|
||||
#include "../../misc/countedptr.hpp"
|
||||
#include "../../road_type.h"
|
||||
#include "../../rail_type.h"
|
||||
|
||||
#include "ai_types.hpp"
|
||||
|
||||
/**
|
||||
* The callback function when an AI suspends.
|
||||
*/
|
||||
typedef void (AISuspendCallbackProc)(class AIInstance *instance);
|
||||
|
||||
/**
|
||||
* The callback function for Mode-classes.
|
||||
*/
|
||||
typedef bool (AIModeProc)(TileIndex tile, uint32 p1, uint32 p2, uint cmd, CommandCost costs);
|
||||
|
||||
/**
|
||||
* Uper-parent object of all API classes. You should never use this class in
|
||||
* your AI, as it doesn't publish any public functions. It is used
|
||||
* internally to have a common place to handle general things, like internal
|
||||
* command processing, and command-validation checks.
|
||||
*/
|
||||
class AIObject : public SimpleCountedObject {
|
||||
friend void CcAI(bool success, TileIndex tile, uint32 p1, uint32 p2);
|
||||
friend class AIInstance;
|
||||
friend class AIController;
|
||||
protected:
|
||||
/**
|
||||
* Executes a raw DoCommand for the AI.
|
||||
*/
|
||||
static bool DoCommand(TileIndex tile, uint32 p1, uint32 p2, uint cmd, const char *text = NULL, AISuspendCallbackProc *callback = NULL);
|
||||
|
||||
/**
|
||||
* Sets the DoCommand costs counter to a value.
|
||||
*/
|
||||
static void SetDoCommandCosts(Money value);
|
||||
|
||||
/**
|
||||
* Increase the current value of the DoCommand costs counter.
|
||||
*/
|
||||
static void IncreaseDoCommandCosts(Money value);
|
||||
|
||||
/**
|
||||
* Get the current DoCommand costs counter.
|
||||
*/
|
||||
static Money GetDoCommandCosts();
|
||||
|
||||
/**
|
||||
* Set the DoCommand last error.
|
||||
*/
|
||||
static void SetLastError(AIErrorType last_error);
|
||||
|
||||
/**
|
||||
* Get the DoCommand last error.
|
||||
*/
|
||||
static AIErrorType GetLastError();
|
||||
|
||||
/**
|
||||
* Set the road type.
|
||||
*/
|
||||
static void SetRoadType(RoadType road_type);
|
||||
|
||||
/**
|
||||
* Get the road type.
|
||||
*/
|
||||
static RoadType GetRoadType();
|
||||
|
||||
/**
|
||||
* Set the rail type.
|
||||
*/
|
||||
static void SetRailType(RailType rail_type);
|
||||
|
||||
/**
|
||||
* Get the rail type.
|
||||
*/
|
||||
static RailType GetRailType();
|
||||
|
||||
/**
|
||||
* Set the current mode of your AI to this proc.
|
||||
*/
|
||||
static void SetDoCommandMode(AIModeProc *proc, AIObject *instance);
|
||||
|
||||
/**
|
||||
* Get the current mode your AI is currently under.
|
||||
*/
|
||||
static AIModeProc *GetDoCommandMode();
|
||||
|
||||
/**
|
||||
* Get the instance of the current mode your AI is currently under.
|
||||
*/
|
||||
static AIObject *GetDoCommandModeInstance();
|
||||
|
||||
/**
|
||||
* Set the delay of the DoCommand.
|
||||
*/
|
||||
static void SetDoCommandDelay(uint ticks);
|
||||
|
||||
/**
|
||||
* Get the delay of the DoCommand.
|
||||
*/
|
||||
static uint GetDoCommandDelay();
|
||||
|
||||
/**
|
||||
* Get the latest result of a DoCommand.
|
||||
*/
|
||||
static bool GetLastCommandRes();
|
||||
|
||||
/**
|
||||
* Get the latest stored new_vehicle_id.
|
||||
*/
|
||||
static VehicleID GetNewVehicleID();
|
||||
|
||||
/**
|
||||
* Get the latest stored new_sign_id.
|
||||
*/
|
||||
static SignID GetNewSignID();
|
||||
|
||||
/**
|
||||
* Get the latest stored new_tunnel_endtile.
|
||||
*/
|
||||
static TileIndex GetNewTunnelEndtile();
|
||||
|
||||
/**
|
||||
* Get the latest stored new_group_id.
|
||||
*/
|
||||
static GroupID GetNewGroupID();
|
||||
|
||||
/**
|
||||
* Get the latest stored allow_do_command.
|
||||
* If this is false, you are not allowed to do any DoCommands.
|
||||
*/
|
||||
static bool GetAllowDoCommand();
|
||||
|
||||
/**
|
||||
* Get the pointer to store event data in.
|
||||
*/
|
||||
static void *&GetEventPointer();
|
||||
|
||||
static void SetLastCost(Money last_cost);
|
||||
static Money GetLastCost();
|
||||
static void SetCallbackVariable(int index, int value);
|
||||
static int GetCallbackVariable(int index);
|
||||
|
||||
public:
|
||||
/**
|
||||
* Store the latest result of a DoCommand per company.
|
||||
* @note NEVER use this yourself in your AI!
|
||||
* @param res The result of the last command.
|
||||
*/
|
||||
static void SetLastCommandRes(bool res);
|
||||
|
||||
/**
|
||||
* Store a new_vehicle_id per company.
|
||||
* @note NEVER use this yourself in your AI!
|
||||
* @param vehicle_id The new VehicleID.
|
||||
*/
|
||||
static void SetNewVehicleID(VehicleID vehicle_id);
|
||||
|
||||
/**
|
||||
* Store a new_sign_id per company.
|
||||
* @note NEVER use this yourself in your AI!
|
||||
* @param sign_id The new SignID.
|
||||
*/
|
||||
static void SetNewSignID(SignID sign_id);
|
||||
|
||||
/**
|
||||
* Store a new_tunnel_endtile per company.
|
||||
* @note NEVER use this yourself in your AI!
|
||||
* @param tile The new TileIndex.
|
||||
*/
|
||||
static void SetNewTunnelEndtile(TileIndex tile);
|
||||
|
||||
/**
|
||||
* Store a new_group_id per company.
|
||||
* @note NEVER use this yourself in your AI!
|
||||
* @param group_id The new GroupID.
|
||||
*/
|
||||
static void SetNewGroupID(GroupID group_id);
|
||||
|
||||
/**
|
||||
* Store a allow_do_command per company.
|
||||
* @note NEVER use this yourself in your AI!
|
||||
* @param allow The new allow.
|
||||
*/
|
||||
static void SetAllowDoCommand(bool allow);
|
||||
|
||||
/**
|
||||
* Get the pointer to store log message in.
|
||||
* @note NEVER use this yourself in your AI!
|
||||
*/
|
||||
static void *&GetLogPointer();
|
||||
};
|
||||
|
||||
#endif /* AI_OBJECT_HPP */
|
||||
Reference in New Issue
Block a user