source: orxonox.OLD/orxonox/trunk/src/world_entities/weapons/weapon_manager.h @ 4954

/*!
 * @file weapon_manager.h
 * every big WorldEntity has the ability to carry many different Weapons.
 * for this to be easy there is the WeaponManager, that handels these weapons,
 * and changes between them.
 *
 *
 *
 * @TODO 1. WeaponManager should also handle a List of availiableWeapons.
 * @TODO 2. Weapons should now Types the counteract to capabilities, so we know where we can put them on the ship.
 */

#include "base_object.h"

#include "p_node.h"

// FORWARD DECLARATION
class PNode;
class Weapon;
class Crosshair;
template <class T> class tAnimation;


#define    WM_MAX_SLOTS            8              //!< How many slots the WeaponManager has at its max
#define    WM_MAX_CONFIGS          4              //!< The maximum number of predefined Configurations
#define    WM_MAX_LOADED_WEAPONS   20             //!< The

//! an enumerator defining capabilities of a WeaponSlot
typedef enum
{
  WM_SLOTC_DIRECTIONAL   = 0x00000001,           //!< if the Slot is able to carry directional weapons
  WM_SLOTC_TURRET        = 0x00000002,           //!< if the Slot is able to carry turrets
  WM_SLOTC_ALLKINDS      = 0x0000000f,           //!< if the Slot is able to carry all kinds of weapons

  WM_SLOTC_FORWARD       = 0x00000010,           //!< if the Slot is able to carry weapons firing forward
  WM_SLOTC_BACKWARD      = 0x00000020,           //!< if the Slot is able to carry weapons firing backwards
  WM_SLOTC_LEFT          = 0x00000040,           //!< if the Slot is able to carry weapons firing to the left
  WM_SLOTC_RIGHT         = 0x00000080,           //!< if the Slot is able to carry weapons firing to the right
  WM_SLOTC_ALLDIRS       = 0x000000f0,           //!< this slot can fire into all directions

  WM_SLOTC_ALL           = 0x000000ff,           //!< everything allowed in this slot
} WM_SlotCapability;

//! an enumerator defining a Slot, where a Weapon can be stored inside.
typedef struct
{
  PNode         position;               //!< the relative Position to the position of the carrying entity. (const PNode* parent; of WeaponManager)
  long          capability;             //!< the capabilities of the Slot @see WM_SlotCapability.

  Weapon*       currentWeapon;          //!< The current weapon this slot is carrying.
  Weapon*       nextWeapon;             //!< either NULL or the next weapon that will be set (require currentWeapon to deactivate)
} WM_Slot;

//! This is a special class, that can handle many different Weapons of a ship/man/whatever.
/**
 * this class is designed to interactively changeing multiple weapons (or just one),
 * and to allow the Weapon itself to enable/disable itself.
 *
 * How to configure
 * 1. set the default values.
 * 2. define weapons. connect them to the WeaponManager's configurations
 * 3. go on and run :)....
 */
class WeaponManager : public BaseObject {
  public:
    WeaponManager(PNode* parent);
    WeaponManager(const TiXmlElement* root);
    ~WeaponManager();

    void init();
    void loadParams(const TiXmlElement* root);
    void loadWeapons(const TiXmlElement* root);

    // setting up the WeaponManager with the following functions
    void setSlotPosition(int slot, const Vector& position);
    /** @param slot the slot to get the relative position from @returns the relative position of the Carrier to the Slot */
    const Vector& getSlotPosition(int slot) const { return this->currentSlotConfig[slot].position.getRelCoor(); };
    void setSlotCapability(int slot, long slotCapability);
    /** @param slot the slot to get the capabilities from @returns the capabilies */
    long getSlotCapability(int slot) const { return this->currentSlotConfig[slot].capability; };

    void setParent(PNode* parent);
    /** @returns the Parent (carrier) of this WeaponManager */
    PNode* getParent() const { return this->parent; };

    void addWeapon(Weapon* weapon, int configID = -1, int slotID = -1);
    void removeWeapon(Weapon* weapon, int configID = -1);

    void nextWeaponConfig();
    void previousWeaponConfig();
    void changeWeaponConfig(int weaponConfig);

    void fire();

    void tick(float dt);
    void draw() const;

    void debug() const;

  private:
    void setSlotCount(unsigned int slotCount);

    int getNextFreeSlot(int configID);

  private:
    PNode*                  parent;                                   //!< The parent, this WeaponManager is connected to.

    int                     slotCount;                                //!< number of weapon slots the ship has.
    int                     currentConfigID;                          //!< the currently selected config.
    Weapon*                 configs[WM_MAX_CONFIGS][WM_MAX_SLOTS];    //!< An array of predefined configurations and assigned weapon.
    WM_Slot                 currentSlotConfig[WM_MAX_SLOTS];          //!< The currentConfigureation.

    Weapon*                 availiableWeapons[WM_MAX_LOADED_WEAPONS]; //!< The availiable Weapons of this WeaponManager

    bool                    weaponChange;

    Crosshair*              crosshair;                                //!< an aim.
    tAnimation<Crosshair>*  crossHairSizeAnim;                        //!< An animation for the crosshair (scaling)
};