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