Main Page   Class Hierarchy   Alphabetical List   Compound List   File List   Compound Members   File Members   Related Pages  

vtkCamera Class Reference

#include <vtkCamera.h>

Inheritance diagram for vtkCamera:

Inheritance graph
[legend]
Collaboration diagram for vtkCamera:

Collaboration graph
[legend]
List of all members.

Detailed Description

a virtual camera for 3D rendering

Date:
2003/02/02 19:16:54
Revision:
1.89

vtkCamera is a virtual camera for 3D rendering. It provides methods to position and orient the view point and focal point. Convenience methods for moving about the focal point also are provided. More complex methods allow the manipulation of the computer graphics model including view up vector, clipping planes, and camera perspective.

See also:
vtkPerspectiveTransform
Created by:
  • Martin, Ken
CVS contributions (if > 5%):
  • Martin, Ken (49%)
  • Gobbi, David (28%)
  • Schroeder, Will (6%)
CVS logs (CVSweb):
  • .h (/Rendering/vtkCamera.h)
  • .cxx (/Rendering/vtkCamera.cxx)
Examples:
vtkCamera (Examples)
Tests:
vtkCamera (Tests)

Definition at line 61 of file vtkCamera.h.

Public Types

typedef vtkObject Superclass

Public Methods

void PrintSelf (ostream &os, vtkIndent indent)
virtual const char * GetClassName ()
virtual int IsA (const char *type)
void OrthogonalizeViewUp ()
void Dolly (double distance)
void Roll (double angle)
void Azimuth (double angle)
void Yaw (double angle)
void Elevation (double angle)
void Pitch (double angle)
void Zoom (double factor)
void SetObliqueAngles (double alpha, double beta)
void ApplyTransform (vtkTransform *t)
virtual vtkMatrix4x4GetViewTransformMatrix ()
virtual void Render (vtkRenderer *)
unsigned long GetViewingRaysMTime ()
void ViewingRaysModified ()
virtual void GetFrustumPlanes (float aspect, float planes[24])
void ComputeViewPlaneNormal ()
vtkMatrix4x4GetCameraLightTransformMatrix ()
virtual void UpdateViewport (vtkRenderer *vtkNotUsed(ren))
virtual vtkTransformGetViewTransformObject ()
void SetPosition (double x, double y, double z)
void SetPosition (const double a[3])
void SetPosition (const float a[3])
virtual double * GetPosition ()
virtual void GetPosition (double &, double &, double &)
virtual void GetPosition (double[3])
void GetPosition (float a[3])
void SetFocalPoint (double x, double y, double z)
void SetFocalPoint (const double a[3])
void SetFocalPoint (const float a[3])
virtual double * GetFocalPoint ()
virtual void GetFocalPoint (double &, double &, double &)
virtual void GetFocalPoint (double[3])
void GetFocalPoint (float a[3])
void SetViewUp (double vx, double vy, double vz)
void SetViewUp (const double a[3])
void SetViewUp (const float a[3])
virtual double * GetViewUp ()
virtual void GetViewUp (double &, double &, double &)
virtual void GetViewUp (double[3])
void GetViewUp (float a[3])
void SetDistance (double)
virtual double GetDistance ()
virtual double * GetDirectionOfProjection ()
virtual void GetDirectionOfProjection (double &, double &, double &)
virtual void GetDirectionOfProjection (double[3])
void GetDirectionOfProjection (float a[3])
void SetRoll (double angle)
double GetRoll ()
void SetParallelProjection (int flag)
virtual int GetParallelProjection ()
virtual void ParallelProjectionOn ()
virtual void ParallelProjectionOff ()
void SetUseHorizontalViewAngle (int flag)
virtual int GetUseHorizontalViewAngle ()
virtual void UseHorizontalViewAngleOn ()
virtual void UseHorizontalViewAngleOff ()
void SetViewAngle (double angle)
virtual double GetViewAngle ()
void SetParallelScale (double scale)
virtual double GetParallelScale ()
void SetClippingRange (double near, double far)
void SetClippingRange (const double a[2])
void SetClippingRange (const float a[2])
virtual double * GetClippingRange ()
virtual void GetClippingRange (double &, double &)
virtual void GetClippingRange (double[2])
void GetClippingRange (float a[2])
void SetThickness (double)
virtual double GetThickness ()
void SetWindowCenter (double x, double y)
virtual double * GetWindowCenter ()
virtual void GetWindowCenter (double &, double &)
virtual void GetWindowCenter (double[2])
virtual double * GetViewPlaneNormal ()
virtual void GetViewPlaneNormal (double &, double &, double &)
virtual void GetViewPlaneNormal (double[3])
void GetViewPlaneNormal (float a[3])
void SetViewShear (double dxdz, double dydz, double center)
void SetViewShear (double d[3])
virtual double * GetViewShear ()
virtual void GetViewShear (double &, double &, double &)
virtual void GetViewShear (double[3])
virtual void SetEyeAngle (double)
virtual double GetEyeAngle ()
virtual void SetFocalDisk (double)
virtual double GetFocalDisk ()
virtual vtkMatrix4x4GetPerspectiveTransformMatrix (double aspect, double nearz, double farz)
virtual vtkMatrix4x4GetCompositePerspectiveTransformMatrix (double aspect, double nearz, double farz)
void SetUserTransform (vtkLinearTransform *transform)
virtual vtkLinearTransformGetUserTransform ()
float * GetOrientation ()
float * GetOrientationWXYZ ()
void SetViewPlaneNormal (double x, double y, double z)
void SetViewPlaneNormal (const double a[3])
void SetViewPlaneNormal (const float a[3])

Static Public Methods

int IsTypeOf (const char *type)
vtkCamera * SafeDownCast (vtkObject *o)
vtkCamera * New ()

Protected Methods

 vtkCamera ()
 ~vtkCamera ()
void ComputeDistance ()
void ComputeViewTransform ()
void ComputePerspectiveTransform (double aspect, double nearz, double farz)
void ComputeCompositePerspectiveTransform (double aspect, double nearz, double farz)
void ComputeCameraLightTransform ()

Protected Attributes

double WindowCenter [2]
double ObliqueAngles [2]
double FocalPoint [3]
double Position [3]
double ViewUp [3]
double ViewAngle
double ClippingRange [2]
double EyeAngle
int ParallelProjection
double ParallelScale
int Stereo
int LeftEye
double Thickness
double Distance
double DirectionOfProjection [3]
double ViewPlaneNormal [3]
double ViewShear [3]
int UseHorizontalViewAngle
vtkLinearTransformUserTransform
vtkTransformViewTransform
vtkPerspectiveTransformPerspectiveTransform
vtkPerspectiveTransformTransform
vtkTransformCameraLightTransform
double FocalDisk
vtkTimeStamp ViewingRaysMTime


Member Typedef Documentation

typedef vtkObject vtkCamera::Superclass
 

Reimplemented from vtkObject.

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

Definition at line 65 of file vtkCamera.h.


Constructor & Destructor Documentation

vtkCamera::vtkCamera   [protected]
 

vtkCamera::~vtkCamera   [protected]
 


Member Function Documentation

void vtkCamera::PrintSelf ostream &    os,
vtkIndent    indent
[virtual]
 

Methods invoked by print to print information about the object including superclasses. Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkObject.

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

virtual const char* vtkCamera::GetClassName   [virtual]
 

Reimplemented from vtkObject.

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

int vtkCamera::IsTypeOf const char *    type [static]
 

Return 1 if this class type is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

virtual int vtkCamera::IsA const char *    type [virtual]
 

Return 1 if this class is the same type of (or a subclass of) the named class. Returns 0 otherwise. This method works in combination with vtkTypeRevisionMacro found in vtkSetGet.h.

Reimplemented from vtkObject.

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

vtkCamera* vtkCamera::SafeDownCast vtkObject   o [static]
 

Reimplemented from vtkObject.

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

vtkCamera* vtkCamera::New   [static]
 

Construct camera instance with its focal point at the origin, and position=(0,0,1). The view up is along the y-axis, view angle is 30 degrees, and the clipping range is (.1,1000).

Reimplemented from vtkObject.

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

void vtkCamera::SetPosition double    x,
double    y,
double    z
 

Set/Get the position of the camera in world coordinates. The default position is (0,0,1).

void vtkCamera::SetPosition const double    a[3] [inline]
 

Set/Get the position of the camera in world coordinates. The default position is (0,0,1).

Definition at line 76 of file vtkCamera.h.

void vtkCamera::SetPosition const float    a[3] [inline]
 

Set/Get the position of the camera in world coordinates. The default position is (0,0,1).

Definition at line 78 of file vtkCamera.h.

virtual double* vtkCamera::GetPosition   [virtual]
 

Set/Get the position of the camera in world coordinates. The default position is (0,0,1).

virtual void vtkCamera::GetPosition double &   ,
double &   ,
double &   
[virtual]
 

Set/Get the position of the camera in world coordinates. The default position is (0,0,1).

virtual void vtkCamera::GetPosition double   [3] [virtual]
 

Set/Get the position of the camera in world coordinates. The default position is (0,0,1).

void vtkCamera::GetPosition float    a[3] [inline]
 

Set/Get the position of the camera in world coordinates. The default position is (0,0,1).

Definition at line 81 of file vtkCamera.h.

void vtkCamera::SetFocalPoint double    x,
double    y,
double    z
 

Set/Get the focal of the camera in world coordinates. The default focal point is the origin.

void vtkCamera::SetFocalPoint const double    a[3] [inline]
 

Set/Get the focal of the camera in world coordinates. The default focal point is the origin.

Definition at line 92 of file vtkCamera.h.

void vtkCamera::SetFocalPoint const float    a[3] [inline]
 

Set/Get the focal of the camera in world coordinates. The default focal point is the origin.

Definition at line 94 of file vtkCamera.h.

virtual double* vtkCamera::GetFocalPoint   [virtual]
 

Set/Get the focal of the camera in world coordinates. The default focal point is the origin.

virtual void vtkCamera::GetFocalPoint double &   ,
double &   ,
double &   
[virtual]
 

Set/Get the focal of the camera in world coordinates. The default focal point is the origin.

virtual void vtkCamera::GetFocalPoint double   [3] [virtual]
 

Set/Get the focal of the camera in world coordinates. The default focal point is the origin.

void vtkCamera::GetFocalPoint float    a[3] [inline]
 

Set/Get the focal of the camera in world coordinates. The default focal point is the origin.

Definition at line 97 of file vtkCamera.h.

void vtkCamera::SetViewUp double    vx,
double    vy,
double    vz
 

Set/Get the view up direction for the camera. The default is (0,1,0).

void vtkCamera::SetViewUp const double    a[3] [inline]
 

Set/Get the view up direction for the camera. The default is (0,1,0).

Definition at line 108 of file vtkCamera.h.

void vtkCamera::SetViewUp const float    a[3] [inline]
 

Set/Get the view up direction for the camera. The default is (0,1,0).

Definition at line 110 of file vtkCamera.h.

virtual double* vtkCamera::GetViewUp   [virtual]
 

Set/Get the view up direction for the camera. The default is (0,1,0).

virtual void vtkCamera::GetViewUp double &   ,
double &   ,
double &   
[virtual]
 

Set/Get the view up direction for the camera. The default is (0,1,0).

virtual void vtkCamera::GetViewUp double   [3] [virtual]
 

Set/Get the view up direction for the camera. The default is (0,1,0).

void vtkCamera::GetViewUp float    a[3] [inline]
 

Set/Get the view up direction for the camera. The default is (0,1,0).

Definition at line 113 of file vtkCamera.h.

void vtkCamera::OrthogonalizeViewUp  
 

Recompute the ViewUp vector to force it to be perpendicular to camera->focalpoint vector. Unless you are going to use Yaw or Azimuth on the camera, there is no need to do this.

void vtkCamera::SetDistance double   
 

Move the focal point so that it is the specified distance from the camera position. This distance must be positive.

virtual double vtkCamera::GetDistance   [virtual]
 

Move the focal point so that it is the specified distance from the camera position. This distance must be positive.

virtual double* vtkCamera::GetDirectionOfProjection   [virtual]
 

Get the vector in the direction from the camera position to the focal point. This is usually the opposite of the ViewPlaneNormal, the vector perpendicular to the screen, unless the view is oblique.

virtual void vtkCamera::GetDirectionOfProjection double &   ,
double &   ,
double &   
[virtual]
 

Get the vector in the direction from the camera position to the focal point. This is usually the opposite of the ViewPlaneNormal, the vector perpendicular to the screen, unless the view is oblique.

virtual void vtkCamera::GetDirectionOfProjection double   [3] [virtual]
 

Get the vector in the direction from the camera position to the focal point. This is usually the opposite of the ViewPlaneNormal, the vector perpendicular to the screen, unless the view is oblique.

void vtkCamera::GetDirectionOfProjection float    a[3] [inline]
 

Get the vector in the direction from the camera position to the focal point. This is usually the opposite of the ViewPlaneNormal, the vector perpendicular to the screen, unless the view is oblique.

Definition at line 137 of file vtkCamera.h.

void vtkCamera::Dolly double    distance
 

Move the position of the camera along the direction of projection. Moving towards the focal point (e.g., greater than 1) is a dolly-in, moving away from the focal point (e.g., less than 1) is a dolly-out.

void vtkCamera::SetRoll double    angle
 

Set the roll angle of the camera about the direction of projection.

double vtkCamera::GetRoll  
 

Set the roll angle of the camera about the direction of projection.

void vtkCamera::Roll double    angle
 

Rotate the camera about the direction of projection.

void vtkCamera::Azimuth double    angle
 

Rotate the camera about the view up vector centered at the focal point. Note that the view up vector is not necessarily perpendicular to the direction of projection.

void vtkCamera::Yaw double    angle
 

Rotate the focal point about the view up vector centered at the camera's position. Note that the view up vector is not necessarily perpendicular to the direction of projection.

void vtkCamera::Elevation double    angle
 

Rotate the camera about the cross product of the direction of projection and the view up vector centered on the focal point.

void vtkCamera::Pitch double    angle
 

Rotate the focal point about the cross product of the view up vector and the direction of projection, centered at the camera's position.

void vtkCamera::SetParallelProjection int    flag
 

Set/Get the value of the ParallelProjection instance variable. This determines if the camera should do a perspective or parallel projection.

virtual int vtkCamera::GetParallelProjection   [virtual]
 

Set/Get the value of the ParallelProjection instance variable. This determines if the camera should do a perspective or parallel projection.

virtual void vtkCamera::ParallelProjectionOn   [virtual]
 

Set/Get the value of the ParallelProjection instance variable. This determines if the camera should do a perspective or parallel projection.

virtual void vtkCamera::ParallelProjectionOff   [virtual]
 

Set/Get the value of the ParallelProjection instance variable. This determines if the camera should do a perspective or parallel projection.

void vtkCamera::SetUseHorizontalViewAngle int    flag
 

Set/Get the value of the UseHorizontalViewAngle instance variable. If set, the camera's view angle represents a horizontal view angle, rather than the default vertical view angle. This is useful if the application uses a display device which whose specs indicate a particular horizontal view angle, or if the application varies the window height but wants to keep the perspective transform unchanges.

virtual int vtkCamera::GetUseHorizontalViewAngle   [virtual]
 

Set/Get the value of the UseHorizontalViewAngle instance variable. If set, the camera's view angle represents a horizontal view angle, rather than the default vertical view angle. This is useful if the application uses a display device which whose specs indicate a particular horizontal view angle, or if the application varies the window height but wants to keep the perspective transform unchanges.

virtual void vtkCamera::UseHorizontalViewAngleOn   [virtual]
 

Set/Get the value of the UseHorizontalViewAngle instance variable. If set, the camera's view angle represents a horizontal view angle, rather than the default vertical view angle. This is useful if the application uses a display device which whose specs indicate a particular horizontal view angle, or if the application varies the window height but wants to keep the perspective transform unchanges.

virtual void vtkCamera::UseHorizontalViewAngleOff   [virtual]
 

Set/Get the value of the UseHorizontalViewAngle instance variable. If set, the camera's view angle represents a horizontal view angle, rather than the default vertical view angle. This is useful if the application uses a display device which whose specs indicate a particular horizontal view angle, or if the application varies the window height but wants to keep the perspective transform unchanges.

void vtkCamera::SetViewAngle double    angle
 

Set/Get the camera view angle, which is the angular height of the camera view measured in degrees. The default angle is 30 degrees. This method has no effect in parallel projection mode. The formula for setting the angle up for perfect perspective viewing is: angle = 2*atan((h/2)/d) where h is the height of the RenderWindow (measured in mm by holding a ruler up to your screen) and d is the distance from your eyes to the screen.

virtual double vtkCamera::GetViewAngle   [virtual]
 

Set/Get the camera view angle, which is the angular height of the camera view measured in degrees. The default angle is 30 degrees. This method has no effect in parallel projection mode. The formula for setting the angle up for perfect perspective viewing is: angle = 2*atan((h/2)/d) where h is the height of the RenderWindow (measured in mm by holding a ruler up to your screen) and d is the distance from your eyes to the screen.

void vtkCamera::SetParallelScale double    scale
 

Set/Get the scaling used for a parallel projection, i.e. the height of the viewport in world-coordinate distances. The default is 1. Note that the "scale" parameter works as an "inverse scale" --- larger numbers produce smaller images. This method has no effect in perspective projection mode.

virtual double vtkCamera::GetParallelScale   [virtual]
 

Set/Get the scaling used for a parallel projection, i.e. the height of the viewport in world-coordinate distances. The default is 1. Note that the "scale" parameter works as an "inverse scale" --- larger numbers produce smaller images. This method has no effect in perspective projection mode.

void vtkCamera::Zoom double    factor
 

In perspective mode, decrease the view angle by the specified factor. In parallel mode, decrease the parallel scale by the specified factor. A value greater than 1 is a zoom-in, a value less than 1 is a zoom-out.

void vtkCamera::SetClippingRange double    near,
double    far
 

Set/Get the location of the near and far clipping planes along the direction of projection. Both of these values must be positive. How the clipping planes are set can have a large impact on how well z-buffering works. In particular the front clipping plane can make a very big difference. Setting it to 0.01 when it really could be 1.0 can have a big impact on your z-buffer resolution farther away. The default clipping range is (0.1,1000).

void vtkCamera::SetClippingRange const double    a[2] [inline]
 

Set/Get the location of the near and far clipping planes along the direction of projection. Both of these values must be positive. How the clipping planes are set can have a large impact on how well z-buffering works. In particular the front clipping plane can make a very big difference. Setting it to 0.01 when it really could be 1.0 can have a big impact on your z-buffer resolution farther away. The default clipping range is (0.1,1000).

Definition at line 234 of file vtkCamera.h.

void vtkCamera::SetClippingRange const float    a[2] [inline]
 

Set/Get the location of the near and far clipping planes along the direction of projection. Both of these values must be positive. How the clipping planes are set can have a large impact on how well z-buffering works. In particular the front clipping plane can make a very big difference. Setting it to 0.01 when it really could be 1.0 can have a big impact on your z-buffer resolution farther away. The default clipping range is (0.1,1000).

Definition at line 236 of file vtkCamera.h.

virtual double* vtkCamera::GetClippingRange   [virtual]
 

Set/Get the location of the near and far clipping planes along the direction of projection. Both of these values must be positive. How the clipping planes are set can have a large impact on how well z-buffering works. In particular the front clipping plane can make a very big difference. Setting it to 0.01 when it really could be 1.0 can have a big impact on your z-buffer resolution farther away. The default clipping range is (0.1,1000).

virtual void vtkCamera::GetClippingRange double &   ,
double &   
[virtual]
 

Set/Get the location of the near and far clipping planes along the direction of projection. Both of these values must be positive. How the clipping planes are set can have a large impact on how well z-buffering works. In particular the front clipping plane can make a very big difference. Setting it to 0.01 when it really could be 1.0 can have a big impact on your z-buffer resolution farther away. The default clipping range is (0.1,1000).

virtual void vtkCamera::GetClippingRange double   [2] [virtual]
 

Set/Get the location of the near and far clipping planes along the direction of projection. Both of these values must be positive. How the clipping planes are set can have a large impact on how well z-buffering works. In particular the front clipping plane can make a very big difference. Setting it to 0.01 when it really could be 1.0 can have a big impact on your z-buffer resolution farther away. The default clipping range is (0.1,1000).

void vtkCamera::GetClippingRange float    a[2] [inline]
 

Set/Get the location of the near and far clipping planes along the direction of projection. Both of these values must be positive. How the clipping planes are set can have a large impact on how well z-buffering works. In particular the front clipping plane can make a very big difference. Setting it to 0.01 when it really could be 1.0 can have a big impact on your z-buffer resolution farther away. The default clipping range is (0.1,1000).

Definition at line 239 of file vtkCamera.h.

void vtkCamera::SetThickness double   
 

Set the distance between clipping planes. This method adjusts the far clipping plane to be set a distance 'thickness' beyond the near clipping plane.

virtual double vtkCamera::GetThickness   [virtual]
 

Set the distance between clipping planes. This method adjusts the far clipping plane to be set a distance 'thickness' beyond the near clipping plane.

void vtkCamera::SetWindowCenter double    x,
double    y
 

Set/Get the center of the window in viewport coordinates. The viewport coordinate range is ([-1,+1],[-1,+1]). This method is for if you have one window which consists of several viewports, or if you have several screens which you want to act together as one large screen.

virtual double* vtkCamera::GetWindowCenter   [virtual]
 

Set/Get the center of the window in viewport coordinates. The viewport coordinate range is ([-1,+1],[-1,+1]). This method is for if you have one window which consists of several viewports, or if you have several screens which you want to act together as one large screen.

virtual void vtkCamera::GetWindowCenter double &   ,
double &   
[virtual]
 

Set/Get the center of the window in viewport coordinates. The viewport coordinate range is ([-1,+1],[-1,+1]). This method is for if you have one window which consists of several viewports, or if you have several screens which you want to act together as one large screen.

virtual void vtkCamera::GetWindowCenter double   [2] [virtual]
 

Set/Get the center of the window in viewport coordinates. The viewport coordinate range is ([-1,+1],[-1,+1]). This method is for if you have one window which consists of several viewports, or if you have several screens which you want to act together as one large screen.

void vtkCamera::SetObliqueAngles double    alpha,
double    beta
 

Get/Set the oblique viewing angles. The first angle, alpha, is the angle (measured from the horizontal) that rays along the direction of projection will follow once projected onto the 2D screen. The second angle, beta, is the angle between the view plane and the direction of projection. This creates a shear transform x' = x + dz*cos(alpha)/tan(beta), y' = dz*sin(alpha)/tan(beta) where dz is the distance of the point from the focal plane. The angles are (45,90) by default. Oblique projections commonly use (30,63.435).

void vtkCamera::ApplyTransform vtkTransform   t
 

Apply a transform to the camera. The camera position, focal-point, and view-up are re-calulated using the transform's matrix to multiply the old points by the new transform.

virtual double* vtkCamera::GetViewPlaneNormal   [virtual]
 

Get the ViewPlaneNormal. This vector will point opposite to the direction of projection, unless you have created an sheared output view using SetViewShear/SetObliqueAngles.

virtual void vtkCamera::GetViewPlaneNormal double &   ,
double &   ,
double &   
[virtual]
 

Get the ViewPlaneNormal. This vector will point opposite to the direction of projection, unless you have created an sheared output view using SetViewShear/SetObliqueAngles.

virtual void vtkCamera::GetViewPlaneNormal double   [3] [virtual]
 

Get the ViewPlaneNormal. This vector will point opposite to the direction of projection, unless you have created an sheared output view using SetViewShear/SetObliqueAngles.

void vtkCamera::GetViewPlaneNormal float    a[3] [inline]
 

Get the ViewPlaneNormal. This vector will point opposite to the direction of projection, unless you have created an sheared output view using SetViewShear/SetObliqueAngles.

Definition at line 283 of file vtkCamera.h.

void vtkCamera::SetViewShear double    dxdz,
double    dydz,
double    center
 

Set/get the shear transform of the viewing frustum. Parameters are dx/dz, dy/dz, and center. center is a factor that describes where to shear around. The distance dshear from the camera where no shear occurs is given by (dshear = center * FocalDistance).

void vtkCamera::SetViewShear double    d[3]
 

Set/get the shear transform of the viewing frustum. Parameters are dx/dz, dy/dz, and center. center is a factor that describes where to shear around. The distance dshear from the camera where no shear occurs is given by (dshear = center * FocalDistance).

virtual double* vtkCamera::GetViewShear   [virtual]
 

Set/get the shear transform of the viewing frustum. Parameters are dx/dz, dy/dz, and center. center is a factor that describes where to shear around. The distance dshear from the camera where no shear occurs is given by (dshear = center * FocalDistance).

virtual void vtkCamera::GetViewShear double &   ,
double &   ,
double &   
[virtual]
 

Set/get the shear transform of the viewing frustum. Parameters are dx/dz, dy/dz, and center. center is a factor that describes where to shear around. The distance dshear from the camera where no shear occurs is given by (dshear = center * FocalDistance).

virtual void vtkCamera::GetViewShear double   [3] [virtual]
 

Set/get the shear transform of the viewing frustum. Parameters are dx/dz, dy/dz, and center. center is a factor that describes where to shear around. The distance dshear from the camera where no shear occurs is given by (dshear = center * FocalDistance).

virtual void vtkCamera::SetEyeAngle double    [virtual]
 

Set/Get the separation between eyes (in degrees). This is used when generating stereo images.

virtual double vtkCamera::GetEyeAngle   [virtual]
 

Set/Get the separation between eyes (in degrees). This is used when generating stereo images.

virtual void vtkCamera::SetFocalDisk double    [virtual]
 

Set the size of the cameras lens in world coordinates. This is only used when the renderer is doing focal depth rendering. When that is being done the size of the focal disk will effect how significant the depth effects will be.

virtual double vtkCamera::GetFocalDisk   [virtual]
 

Set the size of the cameras lens in world coordinates. This is only used when the renderer is doing focal depth rendering. When that is being done the size of the focal disk will effect how significant the depth effects will be.

virtual vtkMatrix4x4* vtkCamera::GetViewTransformMatrix   [virtual]
 

Return the matrix of the view transform.

virtual vtkMatrix4x4* vtkCamera::GetPerspectiveTransformMatrix double    aspect,
double    nearz,
double    farz
[virtual]
 

Return the perspective transform matrix, which converts from camera coordinates to viewport coordinates. The 'aspect' is the width/height for the viewport, and the nearz and farz are the Z-buffer values that map to the near and far clipping planes. The viewport coordinates are in the range ([-1,+1],[-1,+1],[nearz,farz]).

virtual vtkMatrix4x4* vtkCamera::GetCompositePerspectiveTransformMatrix double    aspect,
double    nearz,
double    farz
[virtual]
 

Return the concatenation of the ViewTransform and the PerspectiveTransform. This transform will convert world coordinates to viewport coordinates. The 'aspect' is the width/height for the viewport, and the nearz and farz are the Z-buffer values that map to the near and far clipping planes. The viewport coordinates are in the range ([-1,+1],[-1,+1],[nearz,farz]).

void vtkCamera::SetUserTransform vtkLinearTransform   transform
 

In addition to the instance variables such as position and orientation, you can add an additional transformation for your own use. This transformation is concatenated to the camera's PerspectiveTransform

virtual vtkLinearTransform* vtkCamera::GetUserTransform   [virtual]
 

In addition to the instance variables such as position and orientation, you can add an additional transformation for your own use. This transformation is concatenated to the camera's PerspectiveTransform

virtual void vtkCamera::Render vtkRenderer   [inline, virtual]
 

This method causes the camera to set up whatever is required for viewing the scene. This is actually handled by an subclass of vtkCamera, which is created through New()

Reimplemented in vtkMesaCamera, and vtkOpenGLCamera.

Definition at line 355 of file vtkCamera.h.

unsigned long vtkCamera::GetViewingRaysMTime  
 

Return the MTime that concerns recomputing the view rays of the camera.

void vtkCamera::ViewingRaysModified  
 

Mark that something has changed which requires the view rays to be recomputed.

virtual void vtkCamera::GetFrustumPlanes float    aspect,
float    planes[24]
[virtual]
 

Get the plane equations that bound the view frustum. The plane normals point inward. The planes array contains six plane equations of the form (Ax+By+Cz+D=0), the first four values are (A,B,C,D) which repeats for each of the planes. The aspect of the viewport is needed to correctly compute the planes

float* vtkCamera::GetOrientation  
 

Get the orientation of the camera.

float* vtkCamera::GetOrientationWXYZ  
 

Get the orientation of the camera.

void vtkCamera::SetViewPlaneNormal double    x,
double    y,
double    z
 

These methods have been deprecated. The view plane normal is automatically set from the DirectionOfProjection according to the ViewShear.

void vtkCamera::SetViewPlaneNormal const double    a[3] [inline]
 

These methods have been deprecated. The view plane normal is automatically set from the DirectionOfProjection according to the ViewShear.

Definition at line 383 of file vtkCamera.h.

void vtkCamera::SetViewPlaneNormal const float    a[3] [inline]
 

These methods have been deprecated. The view plane normal is automatically set from the DirectionOfProjection according to the ViewShear.

Definition at line 385 of file vtkCamera.h.

void vtkCamera::ComputeViewPlaneNormal  
 

This method is called automatically whenever necessary, it should never be used outside of vtkCamera.cxx.

vtkMatrix4x4* vtkCamera::GetCameraLightTransformMatrix  
 

Returns a transformation matrix for a coordinate frame attached to the camera, where the camera is located at (0, 0, 1) looking at the focal point at (0, 0, 0), with up being (0, 1, 0).

virtual void vtkCamera::UpdateViewport vtkRenderer   vtkNotUsed(ren) [inline, virtual]
 

Update the viewport

Definition at line 399 of file vtkCamera.h.

virtual vtkTransform* vtkCamera::GetViewTransformObject   [inline, virtual]
 

Definition at line 401 of file vtkCamera.h.

void vtkCamera::ComputeDistance   [protected]
 

These methods should only be used within vtkCamera.cxx.

void vtkCamera::ComputeViewTransform   [protected]
 

These methods should only be used within vtkCamera.cxx.

void vtkCamera::ComputePerspectiveTransform double    aspect,
double    nearz,
double    farz
[protected]
 

These methods should only be used within vtkCamera.cxx.

void vtkCamera::ComputeCompositePerspectiveTransform double    aspect,
double    nearz,
double    farz
[protected]
 

These methods should only be used within vtkCamera.cxx.

void vtkCamera::ComputeCameraLightTransform   [protected]
 

These methods should only be used within vtkCamera.cxx.


Member Data Documentation

double vtkCamera::WindowCenter[2] [protected]
 

Definition at line 417 of file vtkCamera.h.

double vtkCamera::ObliqueAngles[2] [protected]
 

Definition at line 418 of file vtkCamera.h.

double vtkCamera::FocalPoint[3] [protected]
 

Definition at line 419 of file vtkCamera.h.

double vtkCamera::Position[3] [protected]
 

Definition at line 420 of file vtkCamera.h.

double vtkCamera::ViewUp[3] [protected]
 

Definition at line 421 of file vtkCamera.h.

double vtkCamera::ViewAngle [protected]
 

Definition at line 422 of file vtkCamera.h.

double vtkCamera::ClippingRange[2] [protected]
 

Definition at line 423 of file vtkCamera.h.

double vtkCamera::EyeAngle [protected]
 

Definition at line 424 of file vtkCamera.h.

int vtkCamera::ParallelProjection [protected]
 

Definition at line 425 of file vtkCamera.h.

double vtkCamera::ParallelScale [protected]
 

Definition at line 426 of file vtkCamera.h.

int vtkCamera::Stereo [protected]
 

Definition at line 427 of file vtkCamera.h.

int vtkCamera::LeftEye [protected]
 

Definition at line 428 of file vtkCamera.h.

double vtkCamera::Thickness [protected]
 

Definition at line 429 of file vtkCamera.h.

double vtkCamera::Distance [protected]
 

Definition at line 430 of file vtkCamera.h.

double vtkCamera::DirectionOfProjection[3] [protected]
 

Definition at line 431 of file vtkCamera.h.

double vtkCamera::ViewPlaneNormal[3] [protected]
 

Definition at line 432 of file vtkCamera.h.

double vtkCamera::ViewShear[3] [protected]
 

Definition at line 433 of file vtkCamera.h.

int vtkCamera::UseHorizontalViewAngle [protected]
 

Definition at line 434 of file vtkCamera.h.

vtkLinearTransform* vtkCamera::UserTransform [protected]
 

Definition at line 435 of file vtkCamera.h.

vtkTransform* vtkCamera::ViewTransform [protected]
 

Definition at line 437 of file vtkCamera.h.

vtkPerspectiveTransform* vtkCamera::PerspectiveTransform [protected]
 

Definition at line 438 of file vtkCamera.h.

vtkPerspectiveTransform* vtkCamera::Transform [protected]
 

Definition at line 439 of file vtkCamera.h.

vtkTransform* vtkCamera::CameraLightTransform [protected]
 

Definition at line 440 of file vtkCamera.h.

double vtkCamera::FocalDisk [protected]
 

Definition at line 442 of file vtkCamera.h.

vtkTimeStamp vtkCamera::ViewingRaysMTime [protected]
 

Definition at line 447 of file vtkCamera.h.


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