CrystalSpace

Public API Reference

iCamera Struct Reference
[Views & Cameras]

Camera class. More...

#include <iengine/camera.h>

Inheritance diagram for iCamera:

Inheritance graph
[legend]

List of all members.

Public Member Functions

virtual void AddCameraSectorListener (iCameraSectorListener *listener)=0
 Add a listener to this camera.
virtual iCameraClone () const =0
 Create a clone of this camera.
virtual void Correct (int n)=0
 Eliminate roundoff error by snapping the camera orientation to a grid of density n.
virtual long GetCameraNumber () const =0
 Get the camera number.
virtual csPlane3GetFarPlane () const =0
 Get the 3D far plane that should be used to clip all geometry.
virtual int GetFOV () const =0
 Return the FOV (field of view) in pixels.
virtual float GetFOVAngle () const =0
 Return the FOV (field of view) in degrees.
virtual float GetInvFOV () const =0
 Return the inverse flield of view (1/FOV) in pixels.
virtual bool GetOnlyPortals ()=0
 Get the hit-only-portals flag.
virtual iSectorGetSector () const =0
 Get the current sector.
virtual float GetShiftX () const =0
 Set the X shift amount.
virtual float GetShiftY () const =0
 Set the Y shift amount.
virtual const
csOrthoTransform
GetTransform () const =0
 'const' version of GetTransform ()
virtual
csOrthoTransform
GetTransform ()=0
 Get the transform corresponding to this camera.
virtual csVector3 InvPerspective (const csVector2 &p, float z) const =0
 Calculate inverse perspective corrected point for this camera.
virtual bool IsMirrored () const =0
 Return true if space is mirrored.
virtual void Move (const csVector3 &v, bool cd=true)=0
 Moves the camera a relative amount in camera coordinates.
virtual void MoveUnrestricted (const csVector3 &v)=0
 Moves the camera a relative amount in camera coordinates, ignoring portals and walls.
virtual void MoveWorld (const csVector3 &v, bool cd=true)=0
 Moves the camera a relative amount in world coordinates.
virtual void MoveWorldUnrestricted (const csVector3 &v)=0
 Moves the camera a relative amount in world coordinates, ignoring portals and walls.
virtual void OnlyPortals (bool hop)=0
 If the hit-only-portals flag is true then only portals will be checked with the 'MoveWorld()' function.
virtual csVector2 Perspective (const csVector3 &v) const =0
 Calculate perspective corrected point for this camera.
virtual iSceneNodeQuerySceneNode ()=0
 Get the scene node that this object represents.
virtual void RemoveCameraSectorListener (iCameraSectorListener *listener)=0
 Remove a listener from this camera.
virtual void SetFarPlane (csPlane3 *fp)=0
 Set the 3D far plane used to clip all geometry.
virtual void SetFOV (int fov, int width)=0
 Set the FOV in pixels.
virtual void SetFOVAngle (float fov, int width)=0
 Set the FOV in degrees.
virtual void SetMirrored (bool m)=0
 Set mirrored state.
virtual void SetPerspectiveCenter (float x, float y)=0
 Set the shift amount.
virtual void SetSector (iSector *)=0
 Move to another sector.
virtual void SetTransform (const csOrthoTransform &tr)=0
 Set the transform corresponding to this camera.


Detailed Description

Camera class.

This class represents camera objects which can be used to render a world in the engine. A camera has the following properties:

Main creators of instances implementing this interface:

Main ways to get pointers to this interface:

Main users of this interface:

Definition at line 102 of file camera.h.


Member Function Documentation

virtual void iCamera::AddCameraSectorListener ( iCameraSectorListener listener  )  [pure virtual]

Add a listener to this camera.

virtual iCamera* iCamera::Clone (  )  const [pure virtual]

Create a clone of this camera.

Note that the array of listeners is not cloned.

virtual void iCamera::Correct ( int  n  )  [pure virtual]

Eliminate roundoff error by snapping the camera orientation to a grid of density n.

virtual long iCamera::GetCameraNumber (  )  const [pure virtual]

Get the camera number.

This number is changed for every new camera instance and it is also updated whenever the camera transformation changes. This number can be used to cache camera vertex arrays, for example.

virtual csPlane3* iCamera::GetFarPlane (  )  const [pure virtual]

Get the 3D far plane that should be used to clip all geometry.

If this function returns 0 no far clipping is required. Otherwise it must be used to clip the object before drawing.

virtual int iCamera::GetFOV (  )  const [pure virtual]

Return the FOV (field of view) in pixels.

virtual float iCamera::GetFOVAngle (  )  const [pure virtual]

Return the FOV (field of view) in degrees.

virtual float iCamera::GetInvFOV (  )  const [pure virtual]

Return the inverse flield of view (1/FOV) in pixels.

virtual bool iCamera::GetOnlyPortals (  )  [pure virtual]

Get the hit-only-portals flag.

virtual iSector* iCamera::GetSector (  )  const [pure virtual]

Get the current sector.

virtual float iCamera::GetShiftX (  )  const [pure virtual]

Set the X shift amount.

The parameter specified the desired X coordinate on screen of the projection center of the camera.

virtual float iCamera::GetShiftY (  )  const [pure virtual]

Set the Y shift amount.

The parameter specified the desired Y coordinate on screen of the projection center of the camera.

virtual const csOrthoTransform& iCamera::GetTransform (  )  const [pure virtual]

'const' version of GetTransform ()

virtual csOrthoTransform& iCamera::GetTransform (  )  [pure virtual]

Get the transform corresponding to this camera.

In this transform, 'other' is world space and 'this' is camera space. WARNING! It is illegal to directly assign to the given transform in order to modify it. To change the entire transform you have to use SetTransform(). Note that it is legal to modify the returned transform otherwise. Just do not assign to it.

virtual csVector3 iCamera::InvPerspective ( const csVector2 p,
float  z 
) const [pure virtual]

Calculate inverse perspective corrected point for this camera.

virtual bool iCamera::IsMirrored (  )  const [pure virtual]

Return true if space is mirrored.

virtual void iCamera::Move ( const csVector3 v,
bool  cd = true 
) [pure virtual]

Moves the camera a relative amount in camera coordinates.

virtual void iCamera::MoveUnrestricted ( const csVector3 v  )  [pure virtual]

Moves the camera a relative amount in camera coordinates, ignoring portals and walls.

This is used by the wireframe class. In general this is useful by any camera model that doesn't want to restrict its movement by portals and sector boundaries.

virtual void iCamera::MoveWorld ( const csVector3 v,
bool  cd = true 
) [pure virtual]

Moves the camera a relative amount in world coordinates.

If 'cd' is true then collision detection with objects and things inside the sector is active. Otherwise you can walk through objects (but portals will still be correctly checked).

virtual void iCamera::MoveWorldUnrestricted ( const csVector3 v  )  [pure virtual]

Moves the camera a relative amount in world coordinates, ignoring portals and walls.

This is used by the wireframe class. In general this is useful by any camera model that doesn't want to restrict its movement by portals and sector boundaries.

virtual void iCamera::OnlyPortals ( bool  hop  )  [pure virtual]

If the hit-only-portals flag is true then only portals will be checked with the 'MoveWorld()' function.

This is a lot faster but it does mean that you will have to do collision detection with non-portal polygons using another technique. The default for this flag is true.

virtual csVector2 iCamera::Perspective ( const csVector3 v  )  const [pure virtual]

Calculate perspective corrected point for this camera.

virtual iSceneNode* iCamera::QuerySceneNode (  )  [pure virtual]

Get the scene node that this object represents.

Todo:
iCamera doesn't yet support iMovable so scene nodes are not properly working yet.

virtual void iCamera::RemoveCameraSectorListener ( iCameraSectorListener listener  )  [pure virtual]

Remove a listener from this camera.

virtual void iCamera::SetFarPlane ( csPlane3 fp  )  [pure virtual]

Set the 3D far plane used to clip all geometry.

If the pointer is 0 then far plane clipping will be disabled. Otherwise it will be enabled and the plane will be copied (so you can free or reuse the pointer you give here). Note that the far-plane will cull away geometry which is on the negative side of the plane (with csPlane3::Classify() function).

virtual void iCamera::SetFOV ( int  fov,
int  width 
) [pure virtual]

Set the FOV in pixels.

'fov' is the desired FOV in pixels. 'width' is the display width, also in pixels.

virtual void iCamera::SetFOVAngle ( float  fov,
int  width 
) [pure virtual]

Set the FOV in degrees.

'fov' is the desired FOV in degrees. 'width' is the display width in pixels.

virtual void iCamera::SetMirrored ( bool  m  )  [pure virtual]

Set mirrored state.

virtual void iCamera::SetPerspectiveCenter ( float  x,
float  y 
) [pure virtual]

Set the shift amount.

The parameter specified the desired projection center of the camera on screen.

virtual void iCamera::SetSector ( iSector  )  [pure virtual]

Move to another sector.

virtual void iCamera::SetTransform ( const csOrthoTransform tr  )  [pure virtual]

Set the transform corresponding to this camera.

In this transform, 'other' is world space and 'this' is camera space.


The documentation for this struct was generated from the following file:
Generated for Crystal Space 1.2.1 by doxygen 1.5.3