Package com.openinventor.inventor.manips

Class SoTransformerManip

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoTransformation

com.openinventor.inventor.nodes.SoTransform

com.openinventor.inventor.manips.SoTransformManip

com.openinventor.inventor.manips.SoTransformerManip

All Implemented Interfaces:

SafeDisposable

public class SoTransformerManip
extends SoTransformManip

Transform node with 3D interface for changing scaling, rotation, and translation. 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)

File format/default:

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

Nested Class Summary

Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoNode

SoNode.RenderModes

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.nodes.SoTransform

center, rotation, scaleFactor, scaleOrientation, translation

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor	Description
SoTransformerManip()	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	isLocateHighlighting()	Returns whether or not the dragger inside this manip will perform locate highlighting.
void	setLocateHighlighting(boolean onOff)	Sets whether or not the dragger inside this manip will perform locate highlighting.
void	unsquishKnobs()	Tells the dragger inside this manip to unsquish its rotation and scale knobs during the next traversal.

Methods inherited from class com.openinventor.inventor.manips.SoTransformManip

getDragger, replaceManip, replaceNode

Methods inherited from class com.openinventor.inventor.nodes.SoTransform

combineLeft, combineRight, getRotationSpaceMatrix, getScaleSpaceMatrix, getTranslationSpaceMatrix, multLeft, multRight, pointAt, recenter, setMatrix

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getNativeResourceHandle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SoTransformerManip

public SoTransformerManip()

Constructor.

Method Detail

unsquishKnobs

public void 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.

setLocateHighlighting

public void setLocateHighlighting(boolean onOff)

Sets whether or not the dragger inside this manip will perform locate highlighting. Default is true.

isLocateHighlighting

public boolean isLocateHighlighting()

Returns whether or not the dragger inside this manip will perform locate highlighting.