Package com.openinventor.inventor.nodes

Class SoResetTransform

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.SoTransformation

com.openinventor.inventor.nodes.SoResetTransform

All Implemented Interfaces:

SafeDisposable

public class SoResetTransform
extends SoTransformation

Node that resets the current transformation to identity. This node resets the current transformation to identity. It can be used to apply an absolute world space transformation afterwards, such as translating to a specific point from within a hierarchy. An SoResetTransform node should probably be used under an SoSeparator or SoTransformSeparator so it won't change transformations for the rest of the scene graph. An SoResetTransform node can also be used to reset the current bounding box to empty during traversal of an SoGetBoundingBoxAction, if the whatToReset field has the BBOX bit set.

CAUTION: Picking on a shape below an SoResetTransform may fail if bounding box caching is enabled (default). Bounding box caching is set using SoSeparator.

Clipping and culling anomalies may also occur.

File format/default:

ResetTransform {

whatToReset

TRANSFORM

}

Action behavior:

SoGLRenderAction, SoCallbackAction, SoRayPickAction
If specified, resets current transformation matrix to identity. Sets: SoModelMatrixElement, SoUnitsElement

SoGetBoundingBoxAction
If specified, resets current transformation matrix to identity and current computed bounding box to be empty. Sets: SoBBoxModelMatrixElement

SoGetMatrixAction
Returns identity matrix.

See Also:

SoTransform

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	SoResetTransform.ResetTypes	Reset Type enumeration values; defines which things get reset.

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

SoNode.RenderModes

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field	Description
SoSFBitMask<SoResetTransform.ResetTypes>	whatToReset	Specifies which items to reset when the node is traversed.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor	Description
SoResetTransform()	Creates a reset transformation node with default settings.

Method Summary

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

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, 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, getName, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Field Detail

whatToReset

public final SoSFBitMask<SoResetTransform.ResetTypes> whatToReset

Specifies which items to reset when the node is traversed. . Default is TRANSFORM.

Constructor Detail

SoResetTransform

public SoResetTransform()

Creates a reset transformation node with default settings.