Softimage SDK Programmer's Guide > Plug-in Development > Modeling >

# Manipulation Mode Values

Possible bitfield values for getting or setting the Manipulation Mode (sometimes called transformation referential mode) through these scripting commands:

- GetUserPref (returns a bitfield of these values)

- SetUserPref (pass a bitfield of these values in the Value argument)

- SetTransformRefMode (pass either the Major Manipulation Mode values or the Manipulation Modifier Flag values in the Mode argument)

Value | Description
--- | ---
0 | Undefined
Major Manipulation Mode
0x01 | Global mode. Use the scene's global axes to perform translation or rotation.
0x02 | Local mode. Use the axes of the object's local coordinate system as defined by its center to perform translation, rotation, or scaling. Note This is the only major manipulation mode supported for scaling.
0x03 | By Reference mode. Use the X, Y, and Z axes of another element or an arbitrary reference plane to perform translation, rotation, or scaling.
0x04 | View mode. For translations, use the viewing plane of the active 3D view. For rotations, use an axis perpendicular to the viewing plane of the active 3D view.
0x05 | Depth of Field mode. Manipulation is performed in Depth of Field.
0x06 | Object Parent mode. Use the axes of the object's parent to perform translation or rotation.
0x07 | Plane mode. For translations, lets you drag an object along the XZ plane of another element or an arbitrary reference plane. For rotations, lets you rotate an object using an axis (by default, Y) of another element or an arbitrary reference plane.
0x08 | Center Pivot mode. If there is no center pivot, this is the same as Object Parent mode (0x06).
0x0F (15) | Major manipulation mode mask.
Manipulation Modifier Flag
1<<4 (16) | Center of Geometry. Use the center of geometry (the average position of all points) for translation (affects snapping with multiple objects), rotation (pivot position), and scaling.
1<<5 (32) | Relative Grid Snap. Activates snapping to grid (allows you to define a global coordinate grid and a camera viewing plane, as well as any arbitrary reference planes for snapping).
1<<6 (64) | Additive Rotation. Controls the object's local X, Y, and Z rotations as stored relative to its parent. This is especially useful when animating bones and other objects in hierarchies.
1<<7 (128) | Absolute Snap. Activates aboslute snapping (compare with Relative Grid Snap).
1<<8 (256) | Uniform Scale. Scales along all active local axes at the same time with a single mouse button.
1<<9 (512) | View Reference. Activates view reference mode.
1<<10 (1024) | Volume Scale. Scales along one or two local axes, while automatically compensating the other axes so that the volume of the object's bounding box remains constant.
1<<11 (2048) | Symmetry. Activates symmetrical manipulation.
1<<12 (4096) | Last bit.