SoTrackballManip¶

InventorModule¶

genre	`InventorManipulators`
author	`Silicon Graphics Inc`
package	`MeVisLab/Standard`
definition	inventor.def
keywords	`interaction`, `3D`

Purpose¶

SoTrackballManip is derived SoTransform (via SoTransformerManip). When its fields change, nodes following it in the scene graph rotate, scale, and/or translate.

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

A manipulator differs from a dragger. When you move a dragger, no other nodes are affected. When you move a SoTransformerManip, other nodes move along with it.

Interaction¶

Press the Ctrl key to scale the trackball uniformly instead of rotating it.

Press the Shift key, and the user axis appears; this is a draggable axis with an extra stripe around it. Moving the mouse along the surface of the sphere drags the ‘pole’ of the axis. Release the Shift key, and the user axis remains; drag the new stripe for constrained rotation around the user axis. To make the user axis disappear, press Shift and drag the pole to where two other stripes intersect. This aligns the user axis with a primary axis, at which point the user axis disappears.

Windows¶

Default Panel¶

../../../Modules/Inventor/InventorBase/mhelp/Images/Screenshots/SoTrackballManip._default.png

Output Fields¶

self¶

name: self, type: SoNode¶

Parameter Fields¶

Field Index¶

Center: Vector3

Rotation: Rotation

Scale Factor: Vector3

Scale Orientation: Rotation

Translation: Vector3

Visible Fields¶

Translation¶

name: translation, type: Vector3, default: 0 0 0¶: Sets and shows the translation of the manipulator.

Rotation¶

name: rotation, type: Rotation, default: 0 0 1 0¶: Sets and shows the rotation of the manipulator.

Scale Factor¶

name: scaleFactor, type: Vector3, default: 1 1 1¶: Sets and shows the scaling of the manipulator.

Scale Orientation¶

name: scaleOrientation, type: Rotation, default: 0 0 1 0¶: Sets and shows the scale orientation of the manipulator.

Center¶

name: center, type: Vector3, default: 0 0 0¶: Sets and shows the center of rotation and scale of the manipulator.