Rotate

Description

Rotates elements to an absolute rotation or by a relative amount.

Scripting Syntax

Rotate( [InputObjs], [X], [Y], [Z], [Delta], [RefMode], [Center], [AxesFilter], [Reference], [SplitLocalComponents], [PropTagOnly], [Pivot], [PivotX], [PivotY], [PivotZ], [ConstructionMode], [SlideComponents] );

Parameters

Parameter Type Description
InputObjs String List of objects or components to rotate.

Default Value: Selected elements

X Double X rotation in degrees

Default Value: 0.0

Y Double Y rotation

Default Value: 0.0

Z Double Z rotation

Default Value: 0.0

Delta siDeltaMode Specifies whether to rotate the object a relative or absolute amount

Default Value: siRelative

RefMode siRefMode The reference mode to rotate within

Default Value: siLocal

Center siCenterMode Specifies whether to rotate the object or its center.

Note: If an object does not have a moveable center, then rotating its center rotates 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

Reference String In By Reference mode, the rotation is relative to the center of this object

Default Value: ""

Possible Values:

Description:

Reference not used (World)
Grid Use the center of the Grid
SplitLocalComponents Boolean Specifies whether to rotate 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 rotation

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 rotating 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

dim object

set object = GetPrim( "Null" )

' Rotate the selected objects 5 degrees about the global X

Rotate ,5

' Rotate the selected objects about the y-axis to 5 degrees in world space

Rotate ,,5,,siAbsolute

' Rotate the selected objects to align with their parents rotation

Rotate ,,,,siAbsolute,siParent

' Rotate the objects in the selection 6 degrees about the Z-axis of their parent's centers

Rotate ,,,6,siRelative,siParent

' Rotate a given object 5 degrees about their X axis

Rotate object,5,0,0

See Also

Translate Scale ResetTransform