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

Synopsis

scale( float float float [objects] , [absolute=boolean], [centerPivot=boolean], [distanceOnly=boolean], [objectCenterPivot=boolean], [pivot=[linear, linear, linear]], [preserveUV=boolean], [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, NOT queryable, and NOT 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

Related

move, rotate, xform

Flags

absolute, centerPivot, distanceOnly, objectCenterPivot, pivot, preserveUV, 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) [linear, linear, linear] 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)
preserveUV(puv) boolean create
When true, UV values on scaled components are projected along the axis of scaling in 3d space. For small edits, this will freeze the world space texture mapping on the object. When false, the UV values will not change for a selected vertices. Default is false.

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 )