SoOrthographicCamera

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

Purpose

An orthographic camera defines a parallel projection from a viewpoint.

This camera does not diminish objects with distance, as an SoPerspectiveCamera does. The viewing volume for an orthographic camera is a rectangular parallelepiped (a box).

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 field defines the total height of the viewing volume; this and the Aspect Ratio field determine its width.

Windows

Default Panel

../../../Modules/Inventor/InventorBase/mhelp/Images/Screenshots/SoOrthographicCamera._default.png

Output Fields

self

name: self, type: SoNode

Parameter Fields

Field Index

Aspect Ratio: Float
Far Distance: Float
Focal Distance: Float
Height: 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

name: height, type: Float, default: 2

Defines the total height of the viewing volume.