source: orxonox.OLD/trunk/src/world_entities/playable.h @ 7342

/*!
 * @file playable.h
 * Interface for a basic controllable WorldEntity
 */
#ifndef _PLAYABLE_H
#define _PLAYABLE_H

#include "world_entity.h"
#include "extendable.h"
#include "event.h"
#include <vector>

#include "world_entities/weapons/weapon_manager.h"

class Weapon;
class DotEmitter;
class Player;
class SpriteParticles;
class Explosion;

//! Basic controllable WorldEntity
/**
 *
 */
class Playable : public WorldEntity, public Extendable
{
public:
  typedef enum {
    Vertical         = 1,
    Horizontal       = 2,
    FromBehind       = 4,
    Full3D           = 8,
  } Playmode;


public:
  virtual ~Playable();

  virtual void loadParams(const TiXmlElement* root);

  virtual void die();
  virtual void respawn();

  virtual bool pickup(PowerUp* powerUp);

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

  inline WeaponManager& getWeaponManager() { return this->weaponMan; };
  void weaponConfigChanged();


  bool setPlayer(Player* player);
  Player* getCurrentPlayer() const { return this->currentPlayer; };

  void attachCamera();
  void detachCamera();
  virtual void setCameraMode(unsigned int cameraMode = 0);
  bool playmodeSupported(Playable::Playmode playmode) const { return this->supportedPlaymodes & playmode; };
  bool setPlaymode(Playable::Playmode playmode);
  Playable::Playmode getPlaymode() const { return this->playmode; };

  virtual void collidesWith(WorldEntity* entity, const Vector& location);
  virtual void process(const Event &event);

  virtual void tick(float dt);

  /** @return a List of Events in PEV_* sytle */
  inline const std::vector<int>& getEventList() { return this->events; };

  int       writeSync(const byte* data, int length, int sender);
  int       readSync(byte* data, int maxLength );
  bool      needsReadSync();


  //
  virtual void setStartDirection(const Quaternion& rot) = 0;
  void setStartDirection(float angle, float dirX, float dirY, float dirZ) { this->setStartDirection(Quaternion(angle, Vector(dirX, dirY, dirZ))); }

  inline void setScore( int score ) { this->score = score; }
  inline int  getScore() { return this->score; }


  // Transformations:
  static Playable::Playmode stringToPlaymode(const std::string& playmode);
  static const char* playmodeToString(Playable::Playmode playmode);
protected:
  Playable();

  virtual void enter() = 0;
  virtual void leave() = 0;

  void setSupportedPlaymodes(short playmodes) { this->supportedPlaymodes = playmodes; };

  void registerEvent(int eventType);
  void unregisterEvent(int eventType);

private:
  WeaponManager         weaponMan;          //!< the weapon manager: managing a list of weapon to wepaon-slot mapping
  std::vector<int>      events;             //!< A list of Events, that are captured for this playable

  Player*               currentPlayer;      //!< The Player currently connected to this Playable (the one that has controll) otherwise NULL

  bool                  bFire;              //!< If the Ship is firing.
  int                   oldFlags;           //!< Used for synchronisation

  int                   score;
  int                   oldScore;

  bool                  bDead;
  short                 supportedPlaymodes; //!< What Playmodes are Supported in this Playable.
  Playable::Playmode    playmode;           //!< The current playmode.

  WorldEntity* collider;
};

#endif /* _PLAYABLE_H */