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

Synopsis

scale( x y z [object 1] [object 2] ... , [absolute=boolean], [centerPivot=boolean], [distanceOnly=boolean], [objectCenterPivot=boolean], [pivot=[double, double, double]], [reflection=boolean], [reflectionAboutBBox=boolean], [reflectionAboutOrigin=boolean], [reflectionAboutX=boolean], [reflectionAboutY=boolean], [reflectionAboutZ=boolean], [reflectionTolerance=float], [relative=boolean], [scaleX=boolean], [scaleXY=boolean], [scaleXYZ=boolean], [scaleXZ=boolean], [scaleY=boolean], [scaleYZ=boolean], [scaleZ=boolean])

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

scale is undoable, queryable, and editable.

The scale command is used to change the sizes of geometric objects.

The default behaviour, when no objects or flags are passed, is to do a relative scale on each currently selected object object using each object's existing scale pivot point.

Return value

None

In query mode, return type is based on queried flag.

Related

move, rotate, xform

Flags

absolute, centerPivot, distanceOnly, objectCenterPivot, pivot, reflection, reflectionAboutBBox, reflectionAboutOrigin, reflectionAboutX, reflectionAboutY, reflectionAboutZ, reflectionTolerance, relative, scaleX, scaleXY, scaleXYZ, scaleXZ, scaleY, scaleYZ, scaleZ
Long name (short name) argument types Properties
absolute(a) boolean create
Perform an absolute operation.
relative(r) boolean create
Perform a operation relative to the object's current position
reflection(rfl) boolean create
To move the corresponding symmetric components also.
reflectionAboutOrigin(rao) boolean create
Sets the position of the reflection axis at the origin
reflectionAboutBBox(rab) boolean create
Sets the position of the reflection axis at the geometry bounding box
reflectionAboutX(rax) boolean create
Specifies the X=0 as reflection plane
reflectionAboutY(ray) boolean create
Specifies the Y=0 as reflection plane
reflectionAboutZ(raz) boolean create
Specifies the Z=0 as reflection plane
reflectionTolerance(rft) float create
Specifies the tolerance to findout the corresponding reflected components
centerPivot(cp) boolean create
Let the pivot be the center of the bounding box of all objects
objectCenterPivot(ocp) boolean create
Let the pivot be the center of the bounding box of each object
pivot(p) [double, double, double] create
Define the pivot point for the transformation
distanceOnly(dso) boolean create
Scale only the distance between the objects.
scaleX(x) boolean create
Scale in X direction
scaleY(y) boolean create
Scale in Y direction
scaleZ(z) boolean create
Scale in Z direction
scaleXY(xy) boolean create
Scale in X and Y direction
scaleXZ(xz) boolean create
Scale in X and Z direction
scaleYZ(yz) boolean create
Scale in Y and Z direction
scaleXYZ(xyz) boolean create
Scale in all directions (default)
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.scale( 1, 1, 1 )
cmds.scale( 3, 3, 3, 'curve1', pivot=(1, 0, 0), absolute=True )