source: orxonox.OLD/branches/playability/src/world_entities/camera.h @ 10429

/*!
 * @file camera.h
 * Viewpoint controlling class definitions
*/

#ifndef _CAMERA_H
#define _CAMERA_H

#include "p_node.h"
#include "event_listener.h"
#include "plane.h"

class World;
class CameraTarget;
class Event;


//! Camera
/**
 * This class controls the viewpoint from which the World is rendered.
*/
class Camera : public PNode, public EventListener
{
  ObjectListDeclaration(Camera);
public:
  //! an enumerator for different types of view
  typedef enum ViewMode
  {
    ViewNormal,
    ViewBehind,
    ViewFront,
    ViewLeft,
    ViewRight,
    ViewTop
  };

  Camera();
  Camera(const TiXmlElement* root);
  virtual ~Camera();

  void lookAt(PNode* target);
  CameraTarget* getTarget() const { return this->target; };
  PNode* getTargetNode() const;

  void setAspectRatio(float aspectRatio);
  inline float getAspectRatio() {return this->aspectRatio;};

  void setClipRegion(float nearClip, float farClip);

  /** @param fovy new field of view factor (in degrees) */
  inline void setFovy(float fovy) 
  { 
    this->fovy = fovy; 
    this->toFovy = fovy;
  };

  inline float getFovy() {return this->fovy;};
  /** @param fovy new field of view factor (in degrees) to iterate to */
  void setToFovy(float toFovy) { this->toFovy = toFovy; };

  void setViewMode(Camera::ViewMode mode);
  inline const Vector& getViewVector() const { return this->viewVector; }
  inline const Vector& getUpVector() const { return this->upVector; }
  inline const Plane& getViewFrustum() const { return this->frustumPlane; }

  inline float distance(const Vector& distance) const { return this->frustumPlane.distancePoint(distance); }
  inline float distance(const PNode* node) const { return distance(node->getAbsCoor()); }

  inline void setEventHandling(bool b) {this->eventHandling = b;}
  inline bool getEventHandling() {return this->eventHandling;}

  void tick(float dt);
  void apply ();
  void project();

  void process(const Event &event);

  //virtual void loadParams(const TiXmlElement* root);

  void              setViewTopFovy(float fovy);
  void              setViewLeftFovy(float fovy);
  void              setViewRightFovy(float fovy);
  void              setViewBehindFovy(float fovy);
  void              setViewFrontFovy(float fovy);
  void              setViewNormalFovy(float fovy);

  void              setViewTopDistance(float Distance);
  void              setViewLeftDistance(float Distance);
  void              setViewRightDistance(float Distance);
  void              setViewBehindDistance(float Distance);
  void              setViewFrontDistance(float Distance);
  void              setViewNormalDistance(float Distance);

private:

  void              init();

  CameraTarget*     target;          //!< The Target of the Camera (where this Camera Looks at)

  bool              eventHandling;    //!< True, if the Camera handles the processing of events itself. Set false to overwrite the standard handling.

  float             fovy;            //!< The field of view Angle (in degrees).
  float             aspectRatio;     //!< The aspect ratio (width / height).
  float             nearClip;        //!< The near clipping plane.
  float             farClip;         //!< The far clipping plane.

  float             toFovy;          //!< The fovy-mode to iterate to.
  Camera::ViewMode  currentMode;     //!< The ViewMode the camera is in

  Vector            delay;
  Plane             frustumPlane;    //!< plane that marks the view frustum
  Vector            viewVector;      //!< the direction of the camera view
  Vector            upVector;        //!< direction of the up vector

  float             viewTopFovy;
  float             viewLeftFovy;
  float             viewRightFovy;
  float             viewBehindFovy;
  float             viewFrontFovy;
  float             viewNormalFovy;

  float             viewTopDistance;
  float             viewLeftDistance;
  float             viewRightDistance;
  float             viewBehindDistance;
  float             viewFrontDistance;
  float             viewNormalDistance;
  
};

//! A CameraTarget is where the Camera is looking at.
class CameraTarget : public PNode
{
  friend class Camera;             //! The CameraTarget is a friend of Camera. noone else needs a CameraTarget, so noone else can create it.
  ObjectListDeclaration(CameraTarget);

private:
  CameraTarget();

public:
};


#endif /* _CAMERA_H */