SoTransformBoxManip(3IV)

NAME
     SoTransformBoxManip (SoXfBoxManip) - transform node with 3D interface for
     changing scaling, rotation, and translation

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoTransformation > SoTransform >
     SoTransformManip > SoTransformBoxManip

SYNOPSIS
     #include <Inventor_c/manips/SoTransformBoxManip.h>

     typedef SoTransformBoxManip  SoXfBoxManip

          Fields from class SoTransform:

     SoSFVec3f           translation
     SoSFRotation        rotation
     SoSFVec3f           scaleFactor
     SoSFRotation        scaleOrientation
     SoSFVec3f           center

          Functions from class SoTransformBoxManip:

     SoTransformBoxManip *  SoXfBoxManipCreate()
     SoType                 SoXfBoxManipGetClassTypeId()

          Functions from class SoTransformManip:

     SoDragger *         SoXfBoxManipGetDrag(SoXfBoxManip *this)
     SbBool              SoXfBoxManipReplaceNode(SoXfBoxManip *this, SoPath *p
                              )
     SbBool              SoXfBoxManipReplaceManip(const SoXfBoxManip *this,
                              SoPath *p, SoTransform *newOne )

          Functions from class SoTransform:

     void                SoXfBoxManipPtAt(SoXfBoxManip *this, const SbVec3f
                              *fromPoint, const SbVec3f *toPoint)
     void                SoXfBoxManipGetScaleSpaceMx(const SoXfBoxManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoXfBoxManipGetRotSpaceMx(const SoXfBoxManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoXfBoxManipGetXlateSpaceMx(const SoXfBoxManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoXfBoxManipMultLeft(SoXfBoxManip *this, const
                              SbMatrix *mat)
     void                SoXfBoxManipMultRight(SoXfBoxManip *this, const
                              SbMatrix *mat)
     void                SoXfBoxManipCombineLeft(SoXfBoxManip *this,
                              SoTransformation *nodeOnRight)
     void                SoXfBoxManipCombineRight(SoXfBoxManip *this,
                              SoTransformation *nodeOnLeft)
     void                SoXfBoxManipSetMx(SoXfBoxManip *this, const SbMatrix
                              *mat)
     void                SoXfBoxManipRecenter(SoXfBoxManip *this, const
                              SbVec3f *newCenter)

          Functions from class SoNode:

     void                SoXfBoxManipSetOverride(SoXfBoxManip *this, SbBool
                              state)
     SbBool              SoXfBoxManipIsOverride(const SoXfBoxManip *this)
     SoNode *            SoXfBoxManipCopy(const SoXfBoxManip *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoXfBoxManipAffectsState(const SoXfBoxManip *this)
     SoNode *            SoXfBoxManipGetByName(const char *name)
     int                 SoXfBoxManipGetByNameList(const char *name,
                              SoNodeList *list)

          Functions from class SoFieldContainer:

     void                SoXfBoxManipSetToDflts(SoXfBoxManip *this)
     SbBool              SoXfBoxManipHasDfltVals(const SoXfBoxManip *this)
     SbBool              SoXfBoxManipFldsAreEq(const SoXfBoxManip *this, const
                              SoFieldContainer *fc)
     void                SoXfBoxManipCopyFieldVals(SoXfBoxManip *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoXfBoxManipSet(SoXfBoxManip *this, const char
                              *fieldDataString)
     void                SoXfBoxManipGet(SoXfBoxManip *this, SbString
                              *fieldDataString)
     int                 SoXfBoxManipGetFields(const SoXfBoxManip *this,
                              SoFieldList *resultList)
     SoField *           SoXfBoxManipGetField(const SoXfBoxManip *this, const
                              char *fieldName)
     SbBool              SoXfBoxManipGetFieldName(const SoXfBoxManip *this,
                              const SoField *field, SbName *fieldName)
     SbBool              SoXfBoxManipIsNotifyEnabled(const SoXfBoxManip *this)
     SbBool              SoXfBoxManipEnableNotify(SoXfBoxManip *this, SbBool
                              flag)

          Functions from class SoBase:

     void                SoXfBoxManipRef(SoXfBoxManip *this)
     void                SoXfBoxManipUnref(const SoXfBoxManip *this)
     void                SoXfBoxManipUnrefNoDelete(const SoXfBoxManip *this)
     void                SoXfBoxManipTouch(SoXfBoxManip *this)
     SoType              SoXfBoxManipGetTypeId(const SoXfBoxManip *this)
     SbBool              SoXfBoxManipIsOfType(const SoXfBoxManip *this, SoType
                              type)
     void                SoXfBoxManipSetName(SoXfBoxManip *this, const char
                              *name)

     SbName              SoXfBoxManipGetName(const SoXfBoxManip *this)


DESCRIPTION
     SoTransformBoxManip is derived from SoTransform (by way of
     SoTransformManip). When its fields change, nodes following it in the
     scene graph rotate, scale, and/or translate.

     As a subclass of SoTransformManip, this manipulator also has a 3D
     interface to edit some of its fields. In this case, the interface edits
     the scaleFactor, rotation and translation fields.

     A manipulator differs from a dragger. When you move a dragger, no other
     nodes are affected. When you move an SoTransformManip, other nodes move
     along with it. (See the reference page for SoTransformManip).

     The interface for an SoTransformBoxManip is exactly the same as that of
     the SoTransformBoxDragger. To find out more about the interface, see the
     reference page for SoTransformBoxDragger. To find out how the manipulator
     uses a dragger to provide its interface, see the reference page for
     SoTransformManip.

     On screen, this manipulator will surround the objects influenced by its
     motion. This is because it turns on the surroundScale part of the dragger
     (See the reference page for SoSurroundScale)

FUNCTIONS
     SoTransformBoxManip *  SoXfBoxManipCreate()
          Constructor.

     SoType                 SoXfBoxManipGetClassTypeId()
          Returns type identifier for this class.


FILE FORMAT/DEFAULTS
     TransformBoxManip {
          translation       0 0 0
          rotation          0 0 1  0
          scaleFactor       1 1 1
          scaleOrientation  0 0 1  0
          center            0 0 0
     }

SEE ALSO
     SoCenterballManip, SoHandleBoxManip, SoJackManip, SoTabBoxManip,
     SoTrackballManip, SoTransform, SoTransformBoxDragger, SoTransformerManip,
     SoTransformManip