com.openinventor.inventor.nodes

Class SoAntiSquish

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

All Implemented Interfaces:

SafeDisposable

public class SoAntiSquish
extends SoTransformation

Transformation node that undoes non-uniform 3D scales. This node removes nonuniform 3D scaling from the current transformation matrix when traversed by an action. It is used by draggers such as the SoTrackballDragger that need to stay uniformly scaled no matter where they are located in the scene graph.

The magnitude of the new scale is determined by the current transformation matrix and the sizing field. This node does not change the translation or rotation in the matrix.

File format/default:

AntiSquish {

sizing	AVERAGE_DIMENSION
recalcAlways	true

}

Action behavior:

SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoGetMatrixAction, SoRayPickAction
Appends the current transformation with a new matrix to create an unsquished result.

See also:

SoCenterballDragger, SoJackDragger, SoTrackballDragger, SoTransformerDragger, SoTransformation, SoTransformBoxDragger

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SoAntiSquish.Sizings Sizing.

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

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	AVERAGE_DIMENSION Deprecated. Use SoAntiSquish.Sizings.AVERAGE_DIMENSION instead.
static int	BIGGEST_DIMENSION Deprecated. Use SoAntiSquish.Sizings.BIGGEST_DIMENSION instead.
static int	LONGEST_DIAGONAL Deprecated. Use SoAntiSquish.Sizings.LONGEST_DIAGONAL instead.
SoSFBool	recalcAlways If recalcAlways is true, this node calculates its unsquishing matrix every time it is traversed.
SoSFEnum<SoAntiSquish.Sizings>	sizing Determines which of the algorithms enumerated by the type Sizing will be used to select the new scale when the x,y, and z scales are not equal.
static int	SMALLEST_DIMENSION Deprecated. Use SoAntiSquish.Sizings.SMALLEST_DIMENSION instead.
static int	X Deprecated. Use SoAntiSquish.Sizings.X instead.
static int	Y Deprecated. Use SoAntiSquish.Sizings.Y instead.
static int	Z Deprecated. Use SoAntiSquish.Sizings.Z instead.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor and Description
SoAntiSquish() Creates an anti-squish node with default settings.

Method Summary

Modifier and Type	Method and Description
void	recalc() Sets a flag so that the next time the node is traversed, it will recalculate its unsquishing matrix.

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

X

@Deprecated
public static final int X

Deprecated. Use SoAntiSquish.Sizings.X instead.

Y

@Deprecated
public static final int Y

Deprecated. Use SoAntiSquish.Sizings.Y instead.

Z

@Deprecated
public static final int Z

Deprecated. Use SoAntiSquish.Sizings.Z instead.

AVERAGE_DIMENSION

@Deprecated
public static final int AVERAGE_DIMENSION

Deprecated. Use SoAntiSquish.Sizings.AVERAGE_DIMENSION instead.

BIGGEST_DIMENSION

@Deprecated
public static final int BIGGEST_DIMENSION

Deprecated. Use SoAntiSquish.Sizings.BIGGEST_DIMENSION instead.

SMALLEST_DIMENSION

@Deprecated
public static final int SMALLEST_DIMENSION

Deprecated. Use SoAntiSquish.Sizings.SMALLEST_DIMENSION instead.

LONGEST_DIAGONAL

@Deprecated
public static final int LONGEST_DIAGONAL

Deprecated. Use SoAntiSquish.Sizings.LONGEST_DIAGONAL instead.

sizing

public final SoSFEnum<SoAntiSquish.Sizings> sizing

Determines which of the algorithms enumerated by the type Sizing will be used to select the new scale when the x,y, and z scales are not equal. . Default is AVERAGE_DIMENSION.

recalcAlways

public final SoSFBool recalcAlways

If recalcAlways is true, this node calculates its unsquishing matrix every time it is traversed. If false, then this only occurs during the first traversal folllowing a call to recalc(). Default is true.

Constructor Detail

SoAntiSquish

public SoAntiSquish()

Creates an anti-squish node with default settings.

Method Detail

recalc

public void recalc()

Sets a flag so that the next time the node is traversed, it will recalculate its unsquishing matrix.