com.openinventor.inventor.nodes

Class SoPerspectiveCamera

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoCamera

com.openinventor.inventor.nodes.SoPerspectiveCamera

All Implemented Interfaces:

SafeDisposable

Direct Known Subclasses:

SoStereoCamera

public class SoPerspectiveCamera
extends SoCamera

Perspective camera node. 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 heightAngle field defines the total vertical angle of the viewing volume; this and the aspectRatio field determine the horizontal angle.

See the base class SoCamera for more information about the inherited fields.

Useful algorithms for manipulating a camera are provided in the SoCameraInteractor class.

File format/default:

PerspectiveCamera {

viewportMapping	ADJUST_CAMERA
position	0 0 1
orientation	0 0 1 0
aspectRatio	1
nearDistance	1
farDistance	10
focalDistance	5
heightAngle	0.785398

}

Action behavior:

SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoHandleEventAction, SoRayPickAction
Sets the viewport and camera information in the state. Sets: SoFocalDistanceElement, SoProjectionMatrixElement, SoViewportRegionElementSoViewVolumeElement, SoViewingMatrixElement

See also:

SbViewVolume, SoOrthographicCamera, SoCameraInteractor

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoCamera

SoCamera.StereoModes, SoCamera.ViewportMappings

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
SoSFFloat	heightAngle Vertical angle of the viewing volume.

Fields inherited from class com.openinventor.inventor.nodes.SoCamera

ADJUST_CAMERA, aspectRatio, CROP_VIEWPORT_FILL_FRAME, CROP_VIEWPORT_LINE_FRAME, CROP_VIEWPORT_NO_FRAME, farDistance, focalDistance, LEAVE_ALONE, LEFT_VIEW, MONOSCOPIC, nearDistance, orientation, position, RIGHT_VIEW, viewportMapping

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoPerspectiveCamera() Creates a perspective camera node with default settings.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoCamera

allowStereo, getBalanceAdjustment, getStereoAbsoluteAdjustment, getStereoAdjustment, getStereoMode, getViewportBounds, getViewVolume, getViewVolume, isBalanceAdjustmentNearFrac, pointAt, scaleHeight, setBalanceAdjustment, setBalanceAdjustment, setStereoAbsoluteAdjustments, setStereoAdjustment, setStereoMode, viewAll, viewAll, viewAll, viewAll, viewAll

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

heightAngle

public final SoSFFloat heightAngle

Vertical angle of the viewing volume.

Constructor Detail

SoPerspectiveCamera

public SoPerspectiveCamera()

Creates a perspective camera node with default settings.