(svn r12431) [NoAI] -Add: added AIEventSubsidiaryOffer, which keeps you informed about new Subsidiaries
/* $Id$ */
/** @file ai_object.hpp declaration of class for AIObject class */
#ifndef AI_OBJECT_HPP
#define AI_OBJECT_HPP
#include "../../stdafx.h"
#include "../../functions.h"
#include "../../misc/countedptr.hpp"
#ifndef _SQUIRREL_H_
/* Life becomes easier when we can tell about a function it needs the VM, but
* without really including 'squirrel.h'. */
typedef void* HSQUIRRELVM;
typedef int SQInteger;
#endif
/**
* The callback function for Mode-classes.
*/
typedef bool (AIModeProc)(TileIndex tile, uint32 p1, uint32 p2, uint procc, 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 {
private:
struct AIDoCommandStruct {
AIModeProc *mode;
AIObject *mode_instance;
uint delay;
CommandCost costs;
bool last_command_res;
VehicleID new_vehicle_id;
SignID new_sign_id;
void *event_data;
};
/**
* The current mode of the AI players.
*/
static AIDoCommandStruct *GetDoCommandStruct(PlayerID player);
protected:
/**
* Executes a raw DoCommand for the AI.
*/
static bool DoCommand(TileIndex tile, uint32 p1, uint32 p2, uint procc, bool water_protection = true);
/**
* 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 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 pointer to store event data in.
*/
static void *&GetEventPointer();
public:
/**
* Store the latest result of a DoCommand per player.
* @note NEVER use this yourself in your AI!
*/
static void SetLastCommandRes(bool res);
/**
* Store a new_vehicle_id per player.
* @note NEVER use this yourself in your AI!
*/
static void SetNewVehicleID(VehicleID vehicle);
/**
* Store a new_sign_id per player.
* @note NEVER use this yourself in your AI!
*/
static void SetNewSignID(SignID vehicle);
/**
* If an AI starts, some internals needs to be resetted. This function
* takes care of that.
* @note NEVER use this yourself in your AI!
*/
static void ResetInternalPlayerData();
};
#endif /* AI_OBJECT_HPP */