SoJackManip(3IV)

NAME
     SoJackManip (SoJackManip) - transform node with 3D interface for
     rotating, scaling, and translating

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

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

          Fields from class SoTransform:

     SoSFVec3f           translation
     SoSFRotation        rotation
     SoSFVec3f           scaleFactor
     SoSFRotation        scaleOrientation
     SoSFVec3f           center

          Functions from class SoJackManip:

     SoJackManip *       SoJackManipCreate()
     SoType              SoJackManipGetClassTypeId()

          Functions from class SoTransformManip:

     SoDragger *         SoJackManipGetDrag(SoJackManip *this)
     SbBool              SoJackManipReplaceNode(SoJackManip *this, SoPath *p )
     SbBool              SoJackManipReplaceManip(const SoJackManip *this,
                              SoPath *p, SoTransform *newOne )

          Functions from class SoTransform:

     void                SoJackManipPtAt(SoJackManip *this, const SbVec3f
                              *fromPoint, const SbVec3f *toPoint)
     void                SoJackManipGetScaleSpaceMx(const SoJackManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoJackManipGetRotSpaceMx(const SoJackManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoJackManipGetXlateSpaceMx(const SoJackManip *this,
                              SbMatrix *mat, SbMatrix *inv)
     void                SoJackManipMultLeft(SoJackManip *this, const SbMatrix
                              *mat)
     void                SoJackManipMultRight(SoJackManip *this, const
                              SbMatrix *mat)
     void                SoJackManipCombineLeft(SoJackManip *this,
                              SoTransformation *nodeOnRight)
     void                SoJackManipCombineRight(SoJackManip *this,
                              SoTransformation *nodeOnLeft)
     void                SoJackManipSetMx(SoJackManip *this, const SbMatrix
                              *mat)
     void                SoJackManipRecenter(SoJackManip *this, const SbVec3f
                              *newCenter)

          Functions from class SoNode:

     void                SoJackManipSetOverride(SoJackManip *this, SbBool
                              state)
     SbBool              SoJackManipIsOverride(const SoJackManip *this)
     SoNode *            SoJackManipCopy(const SoJackManip *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoJackManipAffectsState(const SoJackManip *this)
     SoNode *            SoJackManipGetByName(const char *name)
     int                 SoJackManipGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoJackManipSetToDflts(SoJackManip *this)
     SbBool              SoJackManipHasDfltVals(const SoJackManip *this)
     SbBool              SoJackManipFldsAreEq(const SoJackManip *this, const
                              SoFieldContainer *fc)
     void                SoJackManipCopyFieldVals(SoJackManip *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoJackManipSet(SoJackManip *this, const char
                              *fieldDataString)
     void                SoJackManipGet(SoJackManip *this, SbString
                              *fieldDataString)
     int                 SoJackManipGetFields(const SoJackManip *this,
                              SoFieldList *resultList)
     SoField *           SoJackManipGetField(const SoJackManip *this, const
                              char *fieldName)
     SbBool              SoJackManipGetFieldName(const SoJackManip *this,
                              const SoField *field, SbName *fieldName)
     SbBool              SoJackManipIsNotifyEnabled(const SoJackManip *this)
     SbBool              SoJackManipEnableNotify(SoJackManip *this, SbBool
                              flag)

          Functions from class SoBase:

     void                SoJackManipRef(SoJackManip *this)
     void                SoJackManipUnref(const SoJackManip *this)
     void                SoJackManipUnrefNoDelete(const SoJackManip *this)
     void                SoJackManipTouch(SoJackManip *this)
     SoType              SoJackManipGetTypeId(const SoJackManip *this)
     SbBool              SoJackManipIsOfType(const SoJackManip *this, SoType
                              type)
     void                SoJackManipSetName(SoJackManip *this, const char
                              *name)
     SbName              SoJackManipGetName(const SoJackManip *this)

DESCRIPTION
     SoJackManip 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, 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 SoJackManip is exactly the same as that of the
     SoJackDragger. To find out more about the interface, see the reference
     page for SoJackDragger. 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
     SoJackManip *       SoJackManipCreate()
          Constructor.

     SoType              SoJackManipGetClassTypeId()
          Returns type identifier for this class.


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