SoResetTransform(3IV)

NAME
     SoResetTransform (SoResetXf) - node that resets the current
     transformation to identity

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoTransformation > SoResetTransform

SYNOPSIS
     #include <Inventor_c/nodes/SoResetTransform.h>

     typedef SoResetTransform  SoResetXf

     enum SoResetTransformResetType {
          SO_RESET_XF_TRANSFORM  Reset the current transformation to identity
          SO_RESET_XF_BBOX       Reset the bounding box to empty
     }

          Fields from class SoResetTransform:

     SoSFBitMask         whatToReset

          Functions from class SoResetTransform:

     SoResetTransform *  SoResetXfCreate()
     SoType              SoResetXfGetClassTypeId()

          Functions from class SoNode:

     void                SoResetXfSetOverride(SoResetXf *this, SbBool state)
     SbBool              SoResetXfIsOverride(const SoResetXf *this)
     SoNode *            SoResetXfCopy(const SoResetXf *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoResetXfAffectsState(const SoResetXf *this)
     SoNode *            SoResetXfGetByName(const char *name)
     int                 SoResetXfGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoResetXfSetToDflts(SoResetXf *this)
     SbBool              SoResetXfHasDfltVals(const SoResetXf *this)
     SbBool              SoResetXfFldsAreEq(const SoResetXf *this, const
                              SoFieldContainer *fc)
     void                SoResetXfCopyFieldVals(SoResetXf *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoResetXfSet(SoResetXf *this, const char
                              *fieldDataString)
     void                SoResetXfGet(SoResetXf *this, SbString
                              *fieldDataString)
     int                 SoResetXfGetFields(const SoResetXf *this, SoFieldList
                              *resultList)
     SoField *           SoResetXfGetField(const SoResetXf *this, const char
                              *fieldName)
     SbBool              SoResetXfGetFieldName(const SoResetXf *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoResetXfIsNotifyEnabled(const SoResetXf *this)
     SbBool              SoResetXfEnableNotify(SoResetXf *this, SbBool flag)

          Functions from class SoBase:

     void                SoResetXfRef(SoResetXf *this)
     void                SoResetXfUnref(const SoResetXf *this)
     void                SoResetXfUnrefNoDelete(const SoResetXf *this)
     void                SoResetXfTouch(SoResetXf *this)
     SoType              SoResetXfGetTypeId(const SoResetXf *this)
     SbBool              SoResetXfIsOfType(const SoResetXf *this, SoType type)
     void                SoResetXfSetName(SoResetXf *this, const char *name)
     SbName              SoResetXfGetName(const SoResetXf *this)


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

FIELDS
     SoSFBitMask         whatToReset
          Specifies which items to reset when the node is traversed.


FUNCTIONS
     SoResetTransform *  SoResetXfCreate()
          Creates a reset transformation node with default settings.

     SoType              SoResetXfGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction, SoRayPickAction
          If specified, resets current transformation matrix to identity.

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

     SoGetMatrixAction
          Returns identity matrix.
FILE FORMAT/DEFAULTS
     ResetTransform {
          whatToReset  TRANSFORM
     }

SEE ALSO
     SoTransform