man SoAntiSquish () - transformation node that undoes non-uniform 3D scales

NAME

SoAntiSquish - transformation node that undoes non-uniform 3D scales

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoTransformation > SoAntiSquish

SYNOPSIS

#include <Inventor/nodes/SoAntiSquish.h> enum Sizing { c } c } fits the other two axes to match the X axis, whose size is unchanged

c } c } fits the other two axes to match the Y axis, whose size is unchanged

c } c } fits the other two axes to match the Z axis, whose size is unchanged

c } c } uses average of 3 scales in the matrix

c } c } uses biggest of 3 scales in the matrix

c } c } uses smallest of 3 scales in the matrix

c } c } accounts for shearing; transforms a cube by the matrix and then uses length of longest diagonal

} Fields from class SoAntiSquish: c } c } sizing

c } c } recalcAlways Methods from class SoAntiSquish: c } c } SoAntiSquish()

c } c } getClassTypeId()

c } c } recalc() Methods from class SoNode: c } c } setOverride(SbBool state)

c } c } isOverride() const

c } c } copy(SbBool copyConnections = FALSE) const

c } c } affectsState() const

c } c } getByName(const SbName &name)

c } c } getByName(const SbName &name, SoNodeList &list) Methods from class SoFieldContainer: c } c } setToDefaults()

c } c } hasDefaultValues() const

c } c } fieldsAreEqual(const SoFieldContainer *fc) const

c } c } copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

c } c } set(const char *fieldDataString)

c } c } get(SbString &fieldDataString)

c } c } getFields(SoFieldList &resultList) const

c } c } getField(const SbName &fieldName) const

c } c } getFieldName(const SoField *field, SbName &fieldName) const

c } c } isNotifyEnabled() const

c } c } enableNotify(SbBool flag) Methods from class SoBase: c } c } ref()

c } c } unref() const

c } c } unrefNoDelete() const

c } c } touch()

c } c } getTypeId() const

c } c } isOfType(SoType type) const

c } c } setName(const SbName &name)

c } c } getName() const

DESCRIPTION

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.

FIELDS

c } c } 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. c } c } 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().

METHODS

c } c } SoAntiSquish()

Creates an anti-squish node with default settings. c } c } getClassTypeId()

Returns type identifier for this class. c } c } recalc()

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

ACTION BEHAVIOR

SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoGetMatrixAction, SoRayPickAction

Appends the current transformation with a new matrix to create an unsquished result.

FILE FORMAT/DEFAULTS

AntiSquish {
sizing	AVERAGE_DIMENSION
recalcAlways	TRUE
}

SEE ALSO

SoCenterballDragger, SoJackDragger, SoTrackballDragger, SoTransformerDragger, SoTransformation, SoTransformBoxDragger