SoPerspectiveCamera

InventorModule

genre	InventorNodesAutomatic,InventorCameras
author	Silicon Graphics Inc
package	MeVisLab/Standard
definition	inventor.def

Purpose

A perspective camera defines a perspective projection from a viewpoint.

The viewing volume for a perspective camera is a truncated right pyramid. By default, the camera is located at (0,0,1) and looks along the negative z-axis; the Position and Orientation fields can be used to change these values. The Height Angle field defines the total vertical angle of the viewing volume; this and the Aspect Ratio field determine the horizontal angle.

Windows

Default Panel

Output Fields

self

name: self, type: SoNode

Parameter Fields

Field Index

Aspect Ratio: Float

Far Distance: Float

Focal Distance: Float

Height Angle: Float

Near Distance: Float

Orientation: Rotation

Position: Vector3

Viewport Mapping: Enum

Visible Fields

Viewport Mapping

name: viewportMapping, type: Enum, default: ADJUST_CAMERA

Defines how to map the rendered image into the current viewport, when the aspect ratio of the camera differs from that of the viewport.

Values:

Title	Name	Description
Crop Viewport Fill Frame	CROP_VIEWPORT_FILL_FRAME	Crops the viewport within the current window, so that the aspect ratio matches that of the camera. As the window size changes, the aspect ratio remains unchanged. The cropped region is drawn as a filled gray area.
Crop Viewport Line Frame	CROP_VIEWPORT_LINE_FRAME	Crops the viewport, but draws a thin frame around the viewport.
Crop Viewport No Frame	CROP_VIEWPORT_NO_FRAME	Crops the viewport, but gives no visual feedback as to the viewport dimensions within the window.
Adjust Camera	ADJUST_CAMERA	Adjusts the camera aspect ratio and height to make it fit within the given window. (The camera’s fields are not affected, just the values sent to the graphics library.)
Leave Alone	LEAVE_ALONE	Do nothing. Camera image may become stretched out of proportion.

Position

name: position, type: Vector3, default: 0 0 1

The location of the camera viewpoint.

Orientation

name: orientation, type: Rotation, default: 0 0 1 0

The orientation of the camera viewpoint, defined as a rotation of the viewing direction from its default (0,0,-1) vector.

Aspect Ratio

name: aspectRatio, type: Float, default: 1

The ratio of camera viewing width to height. This value must be greater than 0.0.

There are several standard camera aspect ratios defined in SoCamera.h.

Near Distance

name: nearDistance, type: Float, default: 1

The distance from the camera viewpoint to the near clipping planes.

Far Distance

name: farDistance, type: Float, default: 10

The distance from the camera viewpoint to the far clipping planes.

Focal Distance

name: focalDistance, type: Float, default: 5

The distance from the viewpoint to the point of focus. This is typically ignored during rendering, but may be used by some viewers to define a point of interest.

Height Angle

name: heightAngle, type: Float, default: 0.78539819

Defines the total vertical angle of the viewing volume.