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 {
          SoAntiSquish::X     fits the other two axes to match the X axis, whose size is unchanged
          SoAntiSquish::Y     fits the other two axes to match the Y axis, whose size is unchanged
          SoAntiSquish::Z     fits the other two axes to match the Z axis, whose size is unchanged
          SoAntiSquish::AVERAGE_DIMENSION
                              uses average of 3 scales in the matrix
          SoAntiSquish::BIGGEST_DIMENSION
                              uses biggest of 3 scales in the matrix
          SoAntiSquish::SMALLEST_DIMENSION
                              uses smallest of 3 scales in the matrix
          SoAntiSquish::LONGEST_DIAGONAL
                              accounts  for  shearing;  transforms  a cube by the matrix and then uses length of
                                   longest diagonal
     }

          Fields from class SoAntiSquish:

     SoSFEnum            sizing
     SoSFBool            recalcAlways

          Methods from class SoAntiSquish:

                         SoAntiSquish()
     static SoType       getClassTypeId()
     void                recalc()

          Methods from class SoNode:

     void                setOverride(SbBool state)
     SbBool              isOverride() const
     SoNode *            copy(SbBool copyConnections = FALSE) const
     virtual SbBool      affectsState() const
     static SoNode *     getByName(const SbName &name)
     static int          getByName(const SbName &name, SoNodeList &list)

          Methods from class SoFieldContainer:

     void                setToDefaults()
     SbBool              hasDefaultValues() const
     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
     void                copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)
     SbBool              set(const char *fieldDataString)
     void                get(SbString &fieldDataString)
     virtual int         getFields(SoFieldList &resultList) const
     virtual SoField *   getField(const SbName &fieldName) const
     SbBool              getFieldName(const SoField *field, SbName &fieldName) const
     SbBool              isNotifyEnabled() const
     SbBool              enableNotify(SbBool flag)

          Methods from class SoBase:

     void                ref()
     void                unref() const
     void                unrefNoDelete() const
     void                touch()
     virtual SoType      getTypeId() const
     SbBool              isOfType(SoType type) const
     virtual void        setName(const SbName &name)
     virtual SbName      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

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

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

METHODS

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

     static SoType       getClassTypeId()
          Returns type identifier for this class.

     void                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

                                                                                             SoAntiSquish(3IV)()