source: orxonox.OLD/orxonox/trunk/src/camera.h @ 3228

/*! 
    \file camera.h
    \brief Viewpoint controlling class definitions
*/ 

#ifndef _CAMERA_H
#define _CAMERA_H

#include "stdincl.h"

class WorldEntity;
class World;

//! Camera
/**
   This class controls the viewpoint from which the World is rendered. To use the 
   Camera it has to be bound to a WorldEntity which serves as the reference focus 
   point. The Camera itself calls the WorldEntity::get_lookat() and 
   World::calc_camera_pos() functions to calculate the position it currently should
   be in.
*/

enum CAMERA_MODE {NORMAL, SMOTH_FOLLOW, STICKY, ELLIPTICAL};

class Camera {
 private:
  WorldEntity* bound;           //!< the WorldEntity the Camera is bound to
  Placement actual_place;               //!< the Camera's current position
  Placement desiredPlace;        //!< where the Camera should be according to calculations
  World* world;
  
  /* physical system - not needed yet */
  float m; //!< mass
  Vector *fs; //!< seil-kraft
  Vector *a;  //!< acceleration
  Vector *v;  //!< velocity
  
  /* elliptical camera mode variables */
  Placement plLastBPlace;
  float cameraOffset;
  float cameraOffsetZ;
  float deltaTime;
  float t;
  Vector r;
  float rAbs;
  float ka;
  float a0;

  Quaternion *from;
  Quaternion *to;
  Quaternion *res;
  
  
  CAMERA_MODE cameraMode; //!< saves the camera mode: how the camera follows the entity
  
  void updateDesiredPlace ();
  
 public:
  Camera (World* world);
  ~Camera ();
  
  void timeSlice (Uint32 deltaT);
  void apply ();
  void bind (WorldEntity* entity);
  void jump (Placement* plc);
  void destroy();

  void setWorld(World* world);  

};

#endif /* _CAMERA_H */