manipulation
Translates elements to an absolute position or by a relative amount. Translation can be performed on all axes, or limited to a specific axis. It can also snap to the 3D grid.
Translate( [InputObjs], [X], [Y], [Z], [Delta], [RefMode], [Center], [AxesFilter], [Snap], [SnapReference], [SnapFilter], [SplitLocalComponents], [PropTagOnly], [Pivot], [PivotX], [PivotY], [PivotZ], [ConstructionMode], [SlideComponents] ); |
| Parameter | Type | Description |
|---|---|---|
| InputObjs | String | List of objects or
components to translate.
Default Value: Selected elements |
| X | Double | X position
Default Value: 0.0 |
| Y | Double | Y position
Default Value: 0.0 |
| Z | Double | Z position
Default Value: 0.0 |
| Delta | siDeltaMode | Specifies whether the translation is relative or absolute
Default Value: siRelative |
| RefMode | siRefMode | The reference mode to translate within
Default Value: siLocal |
| Center | siCenterMode | Specifies whether to translate the object or its center. Note: If an object does not have a moveable center, then translating its center moves the object. Default Value: siObj |
| AxesFilter | siAxesFilter | Determines which of the x,y,z arguments are valid (used with
Absolute mode only).
Default Value: siXYZ |
| Snap | Boolean | Specifies whether to snap the translation values to the nearest
3D grid increment
Default Value: False |
| SnapReference | String | Object Name reference frame for snap filtering. |
| SnapFilter | siAxesFilter | Optional x,y,z absolute snap filter
Default Value: siXYZ |
| SplitLocalComponents | Boolean | Specifies whether to translate all components independently in
Local mode
Default Value: False |
| PropTagOnly | Boolean | Specifies whether to restrict proportional to tagged components
only
Default Value: False |
| Pivot | Boolean | If true the specified global pivot point is used for snapping
Default Value: False |
| PivotX | Double | X position of the pivot point
Default Value: 0.0 |
| PivotY | Double | Y position of the pivot point
Default Value: 0.0 |
| PivotZ | Double | Z position of the pivot point
Default Value: 0.0 |
| ConstructionMode | siConstructionMode | In which construction mode will the deformation be applied.
This only applies when translating geometry components.
Default Value: Use the current construction mode |
| SlideComponents | Boolean | Constrain components to surface during translation. Works like
shrink wrap for points/polygons while edges are constrained along
adjacent polygon edges. Currently only supported for mesh objects.
Default Value: False |
' Create a Sphere CreatePrim "Sphere", "NurbsSurface", "MySphere" ' Translate the Sphere by (6,6,6) using siRelative mode translate "MySphere", 2, 2, 2, siRelative translate "MySphere", 2, 2, 2, siRelative translate "MySphere", 2, 2, 2, siRelative ' Translate the Sphere to (2,2,2) using Absolute mode translate "MySphere", 2, 2, 2, siAbsolute, , , siXYZ ' Return to position (0,0,0) translate "MySphere", , , , siAbsolute |