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 and Description
static class	SoResetTransform.ResetTypes Reset Type enumeration values; defines which things get reset.

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	BBOX Deprecated. Use SoResetTransform.ResetTypes.BBOX instead.
static int	TRANSFORM Deprecated. Use SoResetTransform.ResetTypes.TRANSFORM instead.
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 and 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, 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

TRANSFORM

@Deprecated
public static final int TRANSFORM

Deprecated. Use SoResetTransform.ResetTypes.TRANSFORM instead.

BBOX

@Deprecated
public static final int BBOX

Deprecated. Use SoResetTransform.ResetTypes.BBOX instead.

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.