1

/* $Id$ */

     2

     3

/** @file ai_event.hpp Everything to handle events from the game */

     4

     5

#ifndef AI_EVENT_HPP

     6

#define AI_EVENT_HPP

     7

     8

#include "ai_object.hpp"

     9

    10

/**

    11

 * A single event that can be triggered by the game.

    12

 * You can lookup the type, and than convert it to the real event-class.

    13

 * That way you can request more detailed information about the event.

    14

 */

    15

class AIEvent : public AIObject {

    16

public:

    17

	/**

    18

	 * The type of event. Needed to lookup the detailed class.

    19

	 */

    20

	enum AIEventType {

    21

		AI_ET_INVALID = 0,

    22

		AI_ET_TEST,

    23

		AI_ET_CRASHED_VEHICLE,

    25

	};

    26

    27

	/**

    28

	 * Constructor of AIEvent, to get the type of event.

    29

	 */

    30

	AIEvent(AIEvent::AIEventType type) :

    31

		type(type)

    32

	{}

    33

    34

	/**

    35

	 * Get the event-type.

    36

	 */

    37

	AIEventType GetEventType() { return this->type; }

    38

    39

	/**

    40

	 * The name of the class, needed by several sub-processes.

    41

	 */

    42

	static const char *GetClassName() { return "AIEvent"; }

    43

    44

protected:

    45

	/**

    46

	 * The type of this event.

    47

	 */

    48

	AIEventType type;

    49

};

    50

    51

/**

    52

 * Class that handles all event related functions.

    53

 * @note it is not needed to create an instance of AIEvent to access it, as

    54

 *  all members are static, and all data is stored AI-wide.

    55

 */

    56

class AIEventController : public AIObject {

    57

public:

    58

	/**

    59

	 * The name of the class, needed by several sub-processes.

    60

	 */

    61

	static const char *GetClassName() { return "AIEventController"; }

    62

    63

	/**

    64

	 * Check if there is an event waiting.

    65

	 * @return true if there is an event on the stack.

    66

	 */

    67

	static bool IsEventWaiting();

    68

    69

	/**

    70

	 * Get the next event.

    71

	 * @return a class of the event-child issues.

    72

	 */

    73

	static AIEvent *GetNextEvent();

    74

    75

	/**

    76

	 * No longer report an event of this type.

    77

	 * @param event the event to no longer report.

    78

	 */

    79

	static void DisableEvent(AIEvent::AIEventType event);

    80

    81

	/**

    82

	 * Report events of this type.

    83

	 * @param event the event to report again.

    84

	 */

    85

	static void EnableEvent(AIEvent::AIEventType event);

    86

    87

	/**

    88

	 * Disable all events.

    89

	 */

    90

	static void DisableAllEvents();

    91

    92

	/**

    93

	 * Enable all events.

    94

	 */

    95

	static void EnableAllEvents();

    96

    97

	/**

    98

	 * Insert an event to the queue for the player.

    99

	 */

   100

	static void InsertEvent(AIEvent *event);

   101

   102

	/**

   103

	 * Give a test event to the system.

   104

	 */

   105

	static void Test();

   106

   107

	/**

   108

	 * Free the event pointer.

   109

	 * @note DO NOT CALL YOURSELF; leave it to the internal AI programming.

   110

	 */

   111

	static void FreeEventPointer();

   112

   113

private:

   114

	/**

   115

	 * Create the event pointer.

   116

	 */

   117

	static void CreateEventPointer();

   118

};

   119

   120

#endif /* AI_EVENT_HPP */