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

Synopsis

scale [-absolute] [-centerPivot] [-distanceOnly] [-objectCenterPivot] [-pivot linear linear linear] [-preserveUV] [-reflection] [-reflectionAboutBBox] [-reflectionAboutOrigin] [-reflectionAboutX] [-reflectionAboutY] [-reflectionAboutZ] [-reflectionTolerance float] [-relative] [-scaleX] [-scaleXY] [-scaleXYZ] [-scaleXZ] [-scaleY] [-scaleYZ] [-scaleZ] float float float [objects]

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) create
Perform an absolute operation.
-relative(-r) create
Perform a operation relative to the object's current position
-reflection(-rfl) create
To move the corresponding symmetric components also.
-reflectionAboutOrigin(-rao) create
Sets the position of the reflection axis at the origin
-reflectionAboutBBox(-rab) create
Sets the position of the reflection axis at the geometry bounding box
-reflectionAboutX(-rax) create
Specifies the X=0 as reflection plane
-reflectionAboutY(-ray) create
Specifies the Y=0 as reflection plane
-reflectionAboutZ(-raz) create
Specifies the Z=0 as reflection plane
-reflectionTolerance(-rft) float create
Specifies the tolerance to findout the corresponding reflected components
-centerPivot(-cp) create
Let the pivot be the center of the bounding box of all objects
-objectCenterPivot(-ocp) 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) create
Scale only the distance between the objects.
-scaleX(-x) create
Scale in X direction
-scaleY(-y) create
Scale in Y direction
-scaleZ(-z) create
Scale in Z direction
-scaleXY(-xy) create
Scale in X and Y direction
-scaleXZ(-xz) create
Scale in X and Z direction
-scaleYZ(-yz) create
Scale in Y and Z direction
-scaleXYZ(-xyz) create
Scale in all directions (default)
-preserveUV(-puv) 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 be used more than once in a command.

MEL examples

scale 1 1 1;
scale -pivot 1 0 0 -abs 3 3 3 curve1;