Go to: Synopsis. Return value. Related. Flags. Python examples.


scaleComponents( float float float [objects] , [pivot=[linear, linear, linear]], [rotation=[angle, angle, angle]])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

scaleComponents is undoable, NOT queryable, and NOT editable.

This is a limited version of the scale command. First, it only works on selected components. You provide a pivot in world space, and you can provide a rotation. This rotation affects the scaling, so that rather than scaling in X, Y, Z, this is scaling in X, Y, and Z after they have been rotated by the given rotation.

This allows selected components to be scaled in any arbitrary space, not just object or world space as the regular scale allows.

Scale values are always relative, not absolute.

Return value



move, rotate, scale, xform


pivot, rotation
Long name (short name) Argument types Properties
pivot(p) [linear, linear, linear] create
The pivot position in world space (default is origin)
rotation(ro) [angle, angle, angle] create
The rotational offset for the scaling (default is none)

Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

cmds.scaleComponents( 2, 2, 2, pivot=(0, 10, 0), rotation=(30, 40, 50) )