#include <vtkCamera.h>
Inheritance diagram for vtkCamera:
Public Methods | |
void | PrintSelf (ostream &os, vtkIndent indent) |
virtual const char * | GetClassName () |
virtual int | IsA (const char *type) |
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 | OrthogonalizeViewUp () |
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 | Dolly (double distance) |
void | SetRoll (double angle) |
double | GetRoll () |
void | Roll (double angle) |
void | Azimuth (double angle) |
void | Yaw (double angle) |
void | Elevation (double angle) |
void | Pitch (double angle) |
void | SetParallelProjection (int flag) |
virtual int | GetParallelProjection () |
virtual void | ParallelProjectionOn () |
virtual void | ParallelProjectionOff () |
void | SetViewAngle (double angle) |
virtual double | GetViewAngle () |
void | SetParallelScale (double scale) |
virtual double | GetParallelScale () |
void | Zoom (double factor) |
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]) |
void | SetObliqueAngles (double alpha, double beta) |
virtual double * | GetObliqueAngles () |
virtual void | GetObliqueAngles (double &, double &) |
virtual void | GetObliqueAngles (double[2]) |
virtual double * | GetViewPlaneNormal () |
virtual void | GetViewPlaneNormal (double &, double &, double &) |
virtual void | GetViewPlaneNormal (double[3]) |
void | GetViewPlaneNormal (float a[3]) |
virtual void | SetEyeAngle (double) |
virtual double | GetEyeAngle () |
virtual void | SetFocalDisk (double) |
virtual double | GetFocalDisk () |
vtkMatrix4x4 * | GetViewTransformMatrix () |
vtkMatrix4x4 * | GetPerspectiveTransformMatrix (double aspect, double nearz, double farz) |
vtkMatrix4x4 * | GetCompositePerspectiveTransformMatrix (double aspect, double nearz, double farz) |
virtual void | Render (vtkRenderer *) |
unsigned long | GetViewingRaysMTime () |
void | ViewingRaysModified () |
void | GetFrustumPlanes (float aspect, float planes[24]) |
float * | GetOrientation () |
float * | GetOrientationWXYZ () |
void | SetViewPlaneNormal (double x, double y, double z) |
void | SetViewPlaneNormal (const double a[3]) |
void | SetViewPlaneNormal (const float a[3]) |
void | ComputeViewPlaneNormal () |
vtkMatrix4x4 * | GetCameraLightTransformMatrix () |
vtkMatrix4x4 & | GetViewTransform () |
vtkMatrix4x4 & | GetPerspectiveTransform (double aspect, double nearz, double farz) |
vtkMatrix4x4 & | GetCompositePerspectiveTransform (double aspect, double nearz, double farz) |
Static Public Methods | |
int | IsTypeOf (const char *type) |
vtkCamera * | SafeDownCast (vtkObject *o) |
vtkCamera * | New () |
Protected Methods | |
vtkCamera () | |
~vtkCamera () | |
vtkCamera (const vtkCamera &) | |
void | operator= (const 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] |
vtkTransform * | ViewTransform |
vtkPerspectiveTransform * | PerspectiveTransform |
vtkPerspectiveTransform * | Transform |
vtkTransform * | CameraLightTransform |
double | FocalDisk |
vtkTimeStamp | ViewingRaysMTime |
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.
|
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. |
|
These methods should only be used within vtkCamera.cxx. |
|
This method is called automatically whenever necessary, it should never be used outside of vtkCamera.cxx. |
|
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. |
|
Rotate the camera about the cross product of the direction of projection and the view up vector centered on the focal point. |
|
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). |
|
Return the class name as a string. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h. Reimplemented from vtkObject. Reimplemented in vtkMesaCamera. |
|
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]). |
|
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. |
|
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 |
|
Get the orientation of the camera. |
|
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]). |
|
Return the MTime that concerns recomputing the view rays of the camera. |
|
Get the ViewPlaneNormal. This vector will point opposite to the direction of projection, unless you have created an oblique view using SetObliqueAngles. |
|
For legacy compatibility. Do not use. |
|
Return the matrix of the view transform. |
|
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 vtkTypeMacro found in vtkSetGet.h. Reimplemented from vtkObject. Reimplemented in vtkMesaCamera. |
|
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 vtkTypeMacro found in vtkSetGet.h. Reimplemented from vtkObject. Reimplemented in vtkMesaCamera. |
|
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. |
|
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. |
|
Rotate the focal point about the cross product of the view up vector and the direction of projection, centered at the camera's position. |
|
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. |
|
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. |
|
Rotate the camera about the direction of projection. |
|
Will cast the supplied object to vtkObject* is this is a safe operation (i.e., a safe downcast); otherwise NULL is returned. This method is defined in all subclasses of vtkObject with the vtkTypeMacro found in vtkSetGet.h. Reimplemented from vtkObject. Reimplemented in vtkMesaCamera. |
|
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). |
|
Move the focal point so that it is the specified distance from the camera position. This distance must be positive. |
|
Set/Get the separation between eyes (in degrees). This is used when generating stereo images. |
|
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. |
|
Set/Get the focal of the camera in world coordinates. The default focal point is the origin. |
|
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(phi)/tan(alpha), y' = dz*sin(phi)/tan(alpha) where dz is the distance of the point from the focal plane. The angles are (90,45) by default. Oblique projections commonly use (63.435,30). |
|
Set/Get the value of the ParallelProjection instance variable. This determines if the camera should do a perspective or parallel projection. |
|
Set/Get the scaling used for a parallel projection, i.e. the height of the viewport in world-coordinate distances. The default is 1. This method has no effect in perspective projection mode. |
|
Set/Get the position of the camera in world coordinates. The default position is (0,0,1). |
|
Set the roll angle of the camera about the direction of projection. |
|
Set the distance between clipping planes. This method adjusts the far clipping plane to be set a distance 'thickness' beyond the near clipping plane. |
|
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. |
|
These methods have been deprecated. The view plane normal is automatically set from the DirectionOfProjection according to the ObliqueAngles. |
|
Set/Get the view up direction for the camera. The default is (0,1,0). |
|
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. |
|
Mark that something has changed which requires the view rays to be recomputed. |
|
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. |
|
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. |