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.
allows any iterable object to be passed as first argument:
scale("pSphere1", [0,1,2])
NOTE: this command also reorders the argument order to be more intuitive, with the object first
Long name (short name) | Argument Types | Properties | |
---|---|---|---|
absolute (a) | bool | ![]() |
|
|
|||
centerPivot (cp) | bool | ![]() |
|
|
|||
deletePriorHistory (dph) | bool | ||
distanceOnly (dso) | bool | ![]() |
|
|
|||
localSpace (ls) | bool | ||
objectCenterPivot (ocp) | bool | ![]() |
|
|
|||
objectSpace (os) | bool | ||
orientAxes (oa) | float, float, float | ||
pivot (p) | float, float, float | ![]() |
|
|
|||
preserveChildPosition (pcp) | bool | ||
preserveUV (puv) | bool | ![]() |
|
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 have multiple arguments, passed either as a tuple or a list. |
|||
reflection (rfl) | bool | ![]() |
|
|
|||
reflectionAboutBBox (rab) | bool | ![]() |
|
|
|||
reflectionAboutOrigin (rao) | bool | ![]() |
|
|
|||
reflectionAboutX (rax) | bool | ![]() |
|
|
|||
reflectionAboutY (ray) | bool | ![]() |
|
|
|||
reflectionAboutZ (raz) | bool | ![]() |
|
|
|||
reflectionTolerance (rft) | float | ![]() |
|
|
|||
relative (r) | bool | ![]() |
|
|
|||
scaleX (x) | bool | ![]() |
|
|
|||
scaleXY (xy) | bool | ![]() |
|
|
|||
scaleXYZ (xyz) | bool | ![]() |
|
|
|||
scaleXZ (xz) | bool | ![]() |
|
|
|||
scaleY (y) | bool | ![]() |
|
|
|||
scaleYZ (yz) | bool | ![]() |
|
|
|||
scaleZ (z) | bool | ![]() |
|
|
|||
symNegative (smn) | bool | ![]() |
|
When set the component transformation is flipped so it is relative to the negative side of the symmetry plane. The default (no flag) is to transform components relative to the positive side of the symmetry plane. |
|||
worldSpace (ws) | bool | ||
Derived from mel command maya.cmds.scale
Example:
import pymel.core as pm
pm.scale( 1, 1, 1 )
pm.scale( 3, 3, 3, 'curve1', pivot=(1, 0, 0), absolute=True )