scale

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

Synopsis

scale [-absolute] [-centerPivot] [-componentSpace] [-constrainAlongNormal] [-deletePriorHistory boolean] [-distanceOnly] [-localSpace] [-objectCenterPivot] [-objectSpace] [-orientAxes angle angle angle] [-pivot linear linear linear] [-preserveChildPosition] [-preserveGeometryPosition] [-preserveUV] [-reflection] [-reflectionAboutBBox] [-reflectionAboutOrigin] [-reflectionAboutX] [-reflectionAboutY] [-reflectionAboutZ] [-reflectionTolerance float] [-relative] [-scaleX] [-scaleXY] [-scaleXYZ] [-scaleXZ] [-scaleY] [-scaleYZ] [-scaleZ] [-symNegative] [-worldSpace] [-xformConstraint string] float float float [objects]

scale is undoable, NOT queryable, and NOT editable.

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

Flags

Long name (short name)	Argument types	Properties
-absolute(-a)
Perform an absolute operation.
-centerPivot(-cp)
Let the pivot be the center of the bounding box of all objects
-componentSpace(-cs)
Move in local component space
-constrainAlongNormal(-xn)
When true, transform constraints are applied along the vertex normal first and only use the closest point when no intersection is found along the normal.
-deletePriorHistory(-dph)	boolean
If true then delete the history prior to the current operation.
-distanceOnly(-dso)
Scale only the distance between the objects.
-localSpace(-ls)
Use local space for scaling
-objectCenterPivot(-ocp)
Let the pivot be the center of the bounding box of each object
-objectSpace(-os)
Use object space for scaling
-orientAxes(-oa)	angle angle angle
Use the angles for the orient axes.
-pivot(-p)	linear linear linear
Define the pivot point for the transformation
-preserveChildPosition(-pcp)
When true, transforming an object will apply an opposite transform to its child transform to keep them at the same world-space position. Default is false.
-preserveGeometryPosition(-pgp)
When true, transforming an object will apply an opposite transform to its geometry points to keep them at the same world-space position. Default is false.
-preserveUV(-puv)
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.
-reflection(-rfl)
To move the corresponding symmetric components also.
-reflectionAboutBBox(-rab)
Sets the position of the reflection axis at the geometry bounding box
-reflectionAboutOrigin(-rao)
Sets the position of the reflection axis at the origin
-reflectionAboutX(-rax)
Specifies the X=0 as reflection plane
-reflectionAboutY(-ray)
Specifies the Y=0 as reflection plane
-reflectionAboutZ(-raz)
Specifies the Z=0 as reflection plane
-reflectionTolerance(-rft)	float
Specifies the tolerance to findout the corresponding reflected components
-relative(-r)
Perform a operation relative to the object's current position
-scaleX(-x)
Scale in X direction
-scaleXY(-xy)
Scale in X and Y direction
-scaleXYZ(-xyz)
Scale in all directions (default)
-scaleXZ(-xz)
Scale in X and Z direction
-scaleY(-y)
Scale in Y direction
-scaleYZ(-yz)
Scale in Y and Z direction
-scaleZ(-z)
Scale in Z direction
-symNegative(-smn)
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)
Use world space for scaling
-xformConstraint(-xc)	string
Apply a transform constraint to moving components. none - no constraint surface - constrain components to the surface edge - constrain components to surface edges live - constraint components to the live surface

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;