pymel.core.general.scale

scale(obj, *args, **kwargs)

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.

Modifications:
  • 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

Flags:
  • absolute : a (bool) [create]

    Perform an absolute operation.

  • centerPivot : cp (bool) [create]

    Let the pivot be the center of the bounding box of all objects

  • deletePriorHistory : dph (bool) []

  • distanceOnly : dso (bool) [create]

    Scale only the distance between the objects.

  • localSpace : ls (bool) []

  • objectCenterPivot : ocp (bool) [create]

    Let the pivot be the center of the bounding box of each object

  • objectSpace : os (bool) []

  • orientAxes : oa (float, float, float) []

  • pivot : p (float, float, float) [create]

    Define the pivot point for the transformation

  • preserveChildPosition : pcp (bool) []

  • preserveUV : puv (bool) [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 have multiple arguments, passed either as a tuple or a list.

  • reflection : rfl (bool) [create]

    To move the corresponding symmetric components also.

  • reflectionAboutBBox : rab (bool) [create]

    Sets the position of the reflection axis at the geometry bounding box

  • reflectionAboutOrigin : rao (bool) [create]

    Sets the position of the reflection axis at the origin

  • reflectionAboutX : rax (bool) [create]

    Specifies the X=0 as reflection plane

  • reflectionAboutY : ray (bool) [create]

    Specifies the Y=0 as reflection plane

  • reflectionAboutZ : raz (bool) [create]

    Specifies the Z=0 as reflection plane

  • reflectionTolerance : rft (float) [create]

    Specifies the tolerance to findout the corresponding reflected components

  • relative : r (bool) [create]

    Perform a operation relative to the object’s current position

  • scaleX : x (bool) [create]

    Scale in X direction

  • scaleXY : xy (bool) [create]

    Scale in X and Y direction

  • scaleXYZ : xyz (bool) [create]

    Scale in all directions (default)

  • scaleXZ : xz (bool) [create]

    Scale in X and Z direction

  • scaleY : y (bool) [create]

    Scale in Y direction

  • scaleYZ : yz (bool) [create]

    Scale in Y and Z direction

  • scaleZ : z (bool) [create]

    Scale in Z direction

  • worldSpace : ws (bool) []

Derived from mel command maya.cmds.scale

Previous topic

pymel.core.general.saveToolSettings

Next topic

pymel.core.general.scaleComponents

Core

Core Modules

Other Modules

This Page