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