SoPerspectiveCamera

InventorModule

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

Purpose

The module SoPerspectiveCamera 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, along with the Aspect Ratio field, determines 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 rendered as a filled gray area.
Crop Viewport Line Frame	CROP_VIEWPORT_LINE_FRAME	Crops the viewport but renders a thin frame around it.
Crop Viewport No Frame	CROP_VIEWPORT_NO_FRAME	Crops the viewport but provides no visual feedback regarding the viewport dimensions within the window.
Adjust Camera	ADJUST_CAMERA	Adjusts the camera’s aspect ratio and height to fit within the given window. The camera’s fields remain unaffected; only the values sent to the graphics library are adjusted.
Leave Alone	LEAVE_ALONE	Do nothing. The camera image may become stretched out of proportion.

Position

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

Sets the location of the camera viewpoint.

Orientation

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

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

Aspect Ratio

name: aspectRatio, type: Float, default: 1

Sets the ratio of the camera’s viewing width to height. This value must be greater than 0.0.

Several standard camera aspect ratios are defined in SoCamera.h.

Near Distance

name: nearDistance, type: Float, default: 1

Sets the distance from the camera viewpoint to the near clipping plane.

Far Distance

name: farDistance, type: Float, default: 10

Sets the distance from the camera viewpoint to the far clipping plane.

Focal Distance

name: focalDistance, type: Float, default: 5

Sets the distance from the viewpoint to the point of focus.

This distance 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

Sets the vertical angle of the viewing volume.