Translate

Description

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.

Scripting Syntax

Translate( [InputObjs], [X], [Y], [Z], [Delta], [RefMode], [Center], [AxesFilter], [Snap], [SnapReference], [SnapFilter], [SplitLocalComponents], [PropTagOnly], [Pivot], [PivotX], [PivotY], [PivotZ], [ConstructionMode], [SlideComponents] );

Parameters

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

Examples

VBScript Example

' 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

See Also

Scale Rotate ResetTransform