SoHandleBoxManip(3IV)

NAME
     SoHandleBoxManip (SoHBoxManip) - transform node with 3D Interface for
     Editing ScaleFactor and Translation

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

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

     typedef SoHandleBoxManip  SoHBoxManip

          Fields from class SoTransform:

     SoSFVec3f           translation
     SoSFRotation        rotation
     SoSFVec3f           scaleFactor
     SoSFRotation        scaleOrientation
     SoSFVec3f           center

          Functions from class SoHandleBoxManip:

     SoHandleBoxManip *  SoHBoxManipCreate()
     SoType              SoHBoxManipGetClassTypeId()

          Functions from class SoTransformManip:

     SoDragger *         SoHBoxManipGetDrag(SoHBoxManip *this)
     SbBool              SoHBoxManipReplaceNode(SoHBoxManip *this, SoPath *p )
     SbBool              SoHBoxManipReplaceManip(const SoHBoxManip *this,
                              SoPath *p, SoTransform *newOne )

          Functions from class SoTransform:

     void                SoHBoxManipPtAt(SoHBoxManip *this, const SbVec3f
                              *fromPoint, const SbVec3f *toPoint)
     void                SoHBoxManipGetScaleSpaceMx(const SoHBoxManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoHBoxManipGetRotSpaceMx(const SoHBoxManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoHBoxManipGetXlateSpaceMx(const SoHBoxManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoHBoxManipMultLeft(SoHBoxManip *this, const SbMatrix
                              *mat)
     void                SoHBoxManipMultRight(SoHBoxManip *this, const
                              SbMatrix *mat)
     void                SoHBoxManipCombineLeft(SoHBoxManip *this,
                              SoTransformation *nodeOnRight)
     void                SoHBoxManipCombineRight(SoHBoxManip *this,
                              SoTransformation *nodeOnLeft)
     void                SoHBoxManipSetMx(SoHBoxManip *this, const SbMatrix
                              *mat)
     void                SoHBoxManipRecenter(SoHBoxManip *this, const SbVec3f
                              *newCenter)

          Functions from class SoNode:

     void                SoHBoxManipSetOverride(SoHBoxManip *this, SbBool
                              state)
     SbBool              SoHBoxManipIsOverride(const SoHBoxManip *this)
     SoNode *            SoHBoxManipCopy(const SoHBoxManip *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoHBoxManipAffectsState(const SoHBoxManip *this)
     SoNode *            SoHBoxManipGetByName(const char *name)
     int                 SoHBoxManipGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoHBoxManipSetToDflts(SoHBoxManip *this)
     SbBool              SoHBoxManipHasDfltVals(const SoHBoxManip *this)
     SbBool              SoHBoxManipFldsAreEq(const SoHBoxManip *this, const
                              SoFieldContainer *fc)
     void                SoHBoxManipCopyFieldVals(SoHBoxManip *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoHBoxManipSet(SoHBoxManip *this, const char
                              *fieldDataString)
     void                SoHBoxManipGet(SoHBoxManip *this, SbString
                              *fieldDataString)
     int                 SoHBoxManipGetFields(const SoHBoxManip *this,
                              SoFieldList *resultList)
     SoField *           SoHBoxManipGetField(const SoHBoxManip *this, const
                              char *fieldName)
     SbBool              SoHBoxManipGetFieldName(const SoHBoxManip *this,
                              const SoField *field, SbName *fieldName)
     SbBool              SoHBoxManipIsNotifyEnabled(const SoHBoxManip *this)
     SbBool              SoHBoxManipEnableNotify(SoHBoxManip *this, SbBool
                              flag)

          Functions from class SoBase:

     void                SoHBoxManipRef(SoHBoxManip *this)
     void                SoHBoxManipUnref(const SoHBoxManip *this)
     void                SoHBoxManipUnrefNoDelete(const SoHBoxManip *this)
     void                SoHBoxManipTouch(SoHBoxManip *this)
     SoType              SoHBoxManipGetTypeId(const SoHBoxManip *this)
     SbBool              SoHBoxManipIsOfType(const SoHBoxManip *this, SoType
                              type)
     void                SoHBoxManipSetName(SoHBoxManip *this, const char
                              *name)
     SbName              SoHBoxManipGetName(const SoHBoxManip *this)


DESCRIPTION
     SoHandleBoxManip 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 manip also has a 3D interface to
     edit some of its fields. In this case, the interface edits the
     scaleFactor 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 SoHandleBoxManip is exactly the same as that of the
     SoHandleBoxDragger. To find out more about the interface, see the
     reference page for SoHandleBoxDragger. To find out how the manipulator
     uses a dragger to provide its interface, see the reference page for
     SoTransformManip.

     On screen, this manip 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
     SoHandleBoxManip *  SoHBoxManipCreate()
          Constructor.

     SoType              SoHBoxManipGetClassTypeId()
          Returns type identifier for this class.


FILE FORMAT/DEFAULTS
     HandleBoxManip {
          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, SoHandleBoxDragger, SoJackManip, SoTabBoxManip,
     SoTrackballManip, SoTransformBoxManip, SoTransformerManip, SoTransform,
     SoTransformManip