omni::visual::CameraInterface Class Reference

A generic camera interface. More...

#include <CameraInterface.h>

Inheritance diagram for omni::visual::CameraInterface:

Collaboration diagram for omni::visual::CameraInterface:

Public Member Functions
	CameraInterface ()
	CameraInterface (const Tracker &_tracker, qreal _near=0.1, qreal _far=1000.0, const QVector3D &_up=QVector3D(0.0, 0.0, 1.0))
QVector3D	right () const
	Right vector. More...
void	strafe (qreal _right)
	Move camera to the right (or to the left if value is negative) More...
void	lift (qreal _up)
	Move camera upwards (or downwards if value is negative) More...
QVector3D	up () const
	Camera orientation. More...
void	setUp (QVector3D const &)
qreal	near () const
	Camera's near plane. More...
void	setNear (qreal)
qreal	far () const
	Camera's far plane. More...
void	setFar (qreal)
virtual void	setup (qreal _aspect) const =0
	Setup perspective camera in OpenGL. More...
void	fromStream (QDataStream &)
	Deserialize from stream. More...
void	toStream (QDataStream &) const
	Serialize to stream. More...
virtual qreal	fov () const
	Expose field of field. More...
virtual void	setFov (qreal _fov)
Public Member Functions inherited from omni::visual::Tracker
	Tracker ()
	Tracker (const QVector3D &_center, const PolarVec &_direction)
void	track (float _longitude, float _latitude, float _radius)
QVector3D	eye () const
	get tracker position More...
void	setEye (const QVector3D &_pos)
	Set eye position. More...
void	setCenter (QVector3D const &)
	Set center position. More...
QVector3D &	center ()
	Return center position. More...
QVector3D const &	center () const
	Return center position (const version) More...
void	setDirection (PolarVec const &)
	Set direction from polar vector. More...
void	setDistance (float _t)
	Set direction with a certain distance. More...
PolarVec &	direction ()
	Return direction as polar vector. More...
PolarVec const &	direction () const
	Return direction as polar vector (const version) More...
void	limitDistance (float _minDist, float _maxDist)
	Keep distance in limits. More...

Private Attributes
QVector3D	up_
	camera orientation More...
qreal	near_ = 0.1
	Near plane. More...
qreal	far_ = 1000.0
	Far plane. More...

Friends
bool	operator== (CameraInterface const &, CameraInterface const &)
	Test for equality. ScreenSetup is ignored. More...

Detailed Description

A generic camera interface.

Constructor & Destructor Documentation

omni::visual::CameraInterface::CameraInterface

(

)

                                     :
      up_(0.0, 0.0, 1.0)
    {}

omni::visual::CameraInterface::CameraInterface	(	const Tracker &	_tracker,
		qreal	_near = 0.1,
		qreal	_far = 1000.0,
		const QVector3D &	_up = QVector3D(0.0, 0.0, 1.0)
	)

                                         :
      Tracker(_tracker),
      up_(_up),
      near_(_near),
      far_(_far)
    {}

Member Function Documentation

qreal omni::visual::CameraInterface::far

(

)

const

Camera's far plane.

    {
      return far_;
    }

virtual qreal omni::visual::CameraInterface::fov ( ) const

inlinevirtual

Expose field of field.

Reimplemented in omni::visual::PerspectiveCamera.

                                         {
          return 0.0;
        }

void omni::visual::CameraInterface::fromStream ( QDataStream &  _is )

virtual

Deserialize from stream.

Reimplemented from omni::visual::Tracker.

Reimplemented in omni::visual::PerspectiveCamera.

                                                     {
      Tracker::fromStream(_is);
      _is >> up_ >> near_ >> far_;
    }

void omni::visual::CameraInterface::lift

(

qreal

_up

)

Move camera upwards (or downwards if value is negative)

    {
      QVector3D _orthoUp = QVector3D::crossProduct(right(),
                                                   Tracker::direction().vec());
      Tracker::setCenter(Tracker::center() + _orthoUp.normalized() * _up);
    }

qreal omni::visual::CameraInterface::near

(

)

const

Camera's near plane.

    {
      return near_;
    }

QVector3D omni::visual::CameraInterface::right

(

)

const

Right vector.

    {
      return QVector3D::crossProduct(Tracker::direction().vec(), up_);
    }

void omni::visual::CameraInterface::setFar

(

qreal

_far

)

    {
      far_ = _far;
    }

virtual void omni::visual::CameraInterface::setFov ( qreal  _fov )

inlinevirtual

Reimplemented in omni::visual::PerspectiveCamera.

                                               {
        }

void omni::visual::CameraInterface::setNear

(

qreal

_near

)

    {
      near_ = _near;
    }

void omni::visual::CameraInterface::setUp

(

QVector3D const &

_up

)

    {
      up_ = _up.normalized();
    }

virtual void omni::visual::CameraInterface::setup ( qreal  _aspect ) const

pure virtual

Setup perspective camera in OpenGL.

Implemented in omni::visual::PerspectiveCamera.

void omni::visual::CameraInterface::strafe

(

qreal

_right

)

Move camera to the right (or to the left if value is negative)

    {
      Tracker::setCenter(Tracker::center() + right().normalized() * _right);
    }

void omni::visual::CameraInterface::toStream ( QDataStream &  _os ) const

virtual

Serialize to stream.

Reimplemented from omni::visual::Tracker.

Reimplemented in omni::visual::PerspectiveCamera.

                                                         {
      Tracker::toStream(_os);
      _os << up_ << near_ << far_;
    }

QVector3D omni::visual::CameraInterface::up

(

)

const

Camera orientation.

    {
      return up_;
    }

Friends And Related Function Documentation

bool operator== ( CameraInterface const &  _lhs, CameraInterface const &  _rhs  )

friend

Test for equality. ScreenSetup is ignored.

                                                                              {
      return
        OMNI_TEST_MEMBER_EQUAL(up_) &&
        OMNI_TEST_MEMBER_EQUAL(near_) &&
        OMNI_TEST_MEMBER_EQUAL(far_);
    }

Field Documentation

qreal omni::visual::CameraInterface::far_ = 1000.0

private

Far plane.

qreal omni::visual::CameraInterface::near_ = 0.1

private

Near plane.

QVector3D omni::visual::CameraInterface::up_

private

camera orientation

---

The documentation for this class was generated from the following files:

• include/omni/visual/CameraInterface.h
• src/lib/visual/CameraInterface.cpp