man SoTransformerManip () - transform node with 3D interface for changing scaling, rotation, and translation

NAME

SoTransformerManip - transform node with 3D interface for changing scaling, rotation, and translation

INHERITS FROM

SoBase > SoFieldContainer > SoNode > SoTransformation > SoTransform > SoTransformManip > SoTransformerManip

SYNOPSIS

#include <Inventor/manips/SoTransformerManip.h> Fields from class SoTransform: c } c } translation

c } c } rotation

c } c } scaleFactor

c } c } scaleOrientation

c } c } center Methods from class SoTransformerManip: c } c } SoTransformerManip()

c } c } getClassTypeId()

c } c } setLocateHighlighting(SbBool onOff )

c } c } isLocateHighlighting()

c } c } unsquishKnobs() Methods from class SoTransformManip: c } c } getDragger()

c } c } replaceNode(SoPath *p )

c } c } replaceManip(SoPath *p, SoTransform *newOne ) const Methods from class SoTransform: c } c } pointAt(const SbVec3f &fromPoint, const SbVec3f &toPoint)

c } c } getScaleSpaceMatrix(SbMatrix &mat, SbMatrix &inv) const

c } c } getRotationSpaceMatrix(SbMatrix &mat, SbMatrix &inv) const

c } c } getTranslationSpaceMatrix(SbMatrix &mat, SbMatrix &inv) const

c } c } multLeft(const SbMatrix &mat)

c } c } multRight(const SbMatrix &mat)

c } c } combineLeft(SoTransformation *nodeOnRight)

c } c } combineRight(SoTransformation *nodeOnLeft)

c } c } setMatrix(const SbMatrix &mat)

c } c } recenter(const SbVec3f &newCenter) Methods from class SoNode: c } c } setOverride(SbBool state)

c } c } isOverride() const

c } c } copy(SbBool copyConnections = FALSE) const

c } c } affectsState() const

c } c } getByName(const SbName &name)

c } c } getByName(const SbName &name, SoNodeList &list) Methods from class SoFieldContainer: c } c } setToDefaults()

c } c } hasDefaultValues() const

c } c } fieldsAreEqual(const SoFieldContainer *fc) const

c } c } copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)

c } c } set(const char *fieldDataString)

c } c } get(SbString &fieldDataString)

c } c } getFields(SoFieldList &resultList) const

c } c } getField(const SbName &fieldName) const

c } c } getFieldName(const SoField *field, SbName &fieldName) const

c } c } isNotifyEnabled() const

c } c } enableNotify(SbBool flag) Methods from class SoBase: c } c } ref()

c } c } unref() const

c } c } unrefNoDelete() const

c } c } touch()

c } c } getTypeId() const

c } c } isOfType(SoType type) const

c } c } setName(const SbName &name)

c } c } getName() const

DESCRIPTION

This is a new manipulator with some improvements over the older inventor manips. It has the following features: [1] full interface for rotate, translate, and scale, [2] better feedback, [3] locate highlighting. SoTransformerManip 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 SoTransformerManip is exactly the same as that of the SoTransformerDragger. To find out more about the interface, see the reference page for SoTransformerDragger. 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)

METHODS

c } c } SoTransformerManip()

Constructor. c } c } getClassTypeId()

Returns type identifier for this class. c } c } setLocateHighlighting(SbBool onOff )

c } c } isLocateHighlighting()

Controls whether or not the dragger inside this manip will perform locate highlighting is used. Default is TRUE. c } c } unsquishKnobs()

Tells the dragger inside this manip to unsquish its rotation and scale knobs during the next traversal. Ordinarily, the knobs are only unsquished upon readin from file and when the mouse button is released at the end of a drag. If you want this to happen more often, then you should call this method.

FILE FORMAT/DEFAULTS

TransformerManip {
translation	0 0 0
rotation	0 0 1  0
scaleFactor	1 1 1
scaleOrientation	0 0 1  0
center	0 0 0
}

SEE ALSO

SoTransformerDragger, SoTransform, SoCenterballManip, SoHandleBoxManip, SoJackManip, SoTabBoxManip, SoTrackballManip, SoTransformBoxManip, SoTransformManip