| ## Public API Reference

- Main Page
- Modules
- Namespaces
- Classes
- Files
- Related Pages

- Alphabetical List
- Class List
- Class Hierarchy
- Class Members

# iCamera Struct Reference
[Views & Cameras]

Camera class. More...

`#include <iengine/camera.h>`

Inheritance diagram for iCamera:

[legend]
List of all members.

## Public Member Functions
virtual void | AddCameraSectorListener (iCameraSectorListener *listener)=0
| Add a listener to this camera.
virtual iCamera * | Clone () 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 csPlane3 * | GetFarPlane () 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 iSector * | GetSector () 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 void | InvPerspective (const csVector2 &p, float z, csVector3 &v) 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 void | Perspective (const csVector3 &v, csVector2 &p) const =0
| Calculate perspective corrected point for this camera.
virtual iSceneNode * | QuerySceneNode ()=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:

- Home sector: The sector in which rendering starts.
- Transformation: This is an orthonormal transformation which is applied to all rendered objects to move them from world space to camera space. It is the mathematical representation of position and direction of the camera. The position should be inside the home sector.
- Field of View: Controls the size on screen of the rendered objects and can be used for zooming effects. The FOV can be given either in pixels or as an angle in degrees.
- Shift amount: The projection center in screen coordinates.
- Mirrored Flag: Should be set to true if the transformation is mirrored.
- Far Plane: A distant plane that is orthogonal to the view direction. It is used to clip away all objects that are farther away than a certain distance, usually to improve rendering speed.
- Camera number: An identifier for a camera transformation, used internally in the engine to detect outdated vertex buffers.
- Only Portals Flag: If this is true then no collisions are detected for camera movement except for portals.

Main creators of instances implementing this interface:

- iEngine::CreateCamera()
- csView

Main ways to get pointers to this interface:

- iView::GetCamera()

Main users of this interface:

- csView
- iView

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 void iCamera::InvPerspective | ( | const csVector2 & | p,
|  | float | z,
|  | csVector3 & | v |
| ) |  |  | const`[pure virtual]`

Calculate inverse perspective corrected point for this camera.

Deprecated:
  Use InvPerspective(const csVector2&, float) instead.

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 void iCamera::Perspective | ( | const csVector3 & | v,
|  | csVector2 & | p |
| ) |  |  | const`[pure virtual]`

Calculate perspective corrected point for this camera.

Deprecated:
  Use Perspective(const csVector3&) instead.

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:

- iengine/camera.h