Go to: Synopsis. Return value. Flags. MEL examples.
propMove [-percent float] [-percentX float] [-percentY float] [-percentZ float] [-pivot float float float] [-rotate angle angle angle] [-scale float float float] [-translate linear linear linear] [-worldSpace boolean]
[objects]
propMove is undoable, NOT queryable, and NOT editable.
Performs a proportional translate, scale or rotate operation on any
number of objects. The percentages to rotate, scale or translate by
can be specified using either the -p flags or -px, -py, -pz
flags. Each selected object must have a corresponding -p or -px, -py,
-pz flag. The rotate, scale or translate performed is relative.
None
percent, percentX, percentY, percentZ, pivot, rotate, scale, translate, worldSpace
Long name (short name) |
Argument types |
Properties |
|
-percent(-p)
|
float
|
|
|
The percentage effect that the specified x,y,z has on an object.
This flag must be specified once for each object, ie. if there
are 4 objects specified, there must be 4 "-p" flags, (otherwise
a percentage of 1.0 will be used). This flag generally has a
range between 0.0 and 1.0, but can be any float value.
|
|
-percentX(-px)
|
float
|
|
|
The percentage effect that the specified x has on an object.
This flag is specified one per object.
The value ranges between 0.0 and 1.0, but can be any float value.
If the -p flag has been specified, this flag usage is invalid.
|
|
-percentY(-py)
|
float
|
|
|
The percentage effect that the specified y has on an object.
This flag is specified one per object.
The value ranges between 0.0 and 1.0, but can be any float value.
If the -p flag has been specified, this flag usage is invalid.
|
|
-percentZ(-pz)
|
float
|
|
|
The percentage effect that the specified z has on an object.
This flag is specified one per object.
The value ranges between 0.0 and 1.0, but can be any float value.
If the -p flag has been specified, this flag usage is invalid.
|
|
-pivot(-pi)
|
float float float
|
|
|
Specify the pivot about which a rotation or scale will occur.
The change in pivot lasts only as long as the current 'propMove' command, and so
must be used in conjunction with one of the above move flags for any effect to be
noticeable.
|
|
-rotate(-r)
|
angle angle angle
|
|
|
Proportionally rotate each object by the given angles. The rotation values
are scaled by the percentage specified by that object's
corresponding "-percent" flag.
All angles are in degrees.
The rotation is about the pivot specified by the "-pivot" flag, or (0, 0, 0)
if the "-pivot" flag is not present.
|
|
-scale(-s)
|
float float float
|
|
|
Proportionally scale each object by the given amounts. The scale values
are scaled by the percentage specified by that object's
corresponding "-percent" flag.
The position and size of each object is measured relative to the pivot
specified by the "-pivot" flag, and defaults to each object's individual pivot.
In the case of control vertices, or some other object component, the
default is the parent object's pivot.
|
|
-translate(-t)
|
linear linear linear
|
|
|
Proportionally translate each object by the given amounts. The translation
values are scaled by the percentage specified by that object's
corresponding "-percent" flag.
The "-pivot" flag has no effect on translation.
|
|
-worldSpace(-ws)
|
boolean
|
|
|
Use worldspace for the calculations.
|
|
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.
|
propMove -p 0.1 -p 0.5 -p 0.7 -p 1.0 -p 0.7 -p 0.5 -p 0.1 3 6 0
surface1 surface2 surface3 surface4 surface5 surface6 surface7;
// This performs a proportional translate of (3,6,0) on seven surfaces.
// Note that there are 7 "-p" flags, one for each surface.
propMove -p 0.1 -p 0.5 -p 0.7 -p 1.0 -p 0.7 -p 0.5 -p 0.1 -pivot 1 1 1 -s 3 3 3
surface1 surface2 surface3 surface4 surface5 surface6 surface7;
// This performs a proportional scale of (3,3,3) on seven surfaces.
// Note that there are 7 "-p" flags, one for each surface. The scale
// happened about the specified pivot (1,1,1).
propMove -p 0.1 -p 0.5 -p 0.7 -p 1.0 -p 0.7 -p 0.5 -p 0.1 -r 30 60 90
surface1 surface2 surface3 surface4 surface5 surface6 surface7;
// This performs a proportional rotate of (30,60,90) on seven surfaces.
// Note that there are 7 "-p" flags, one for each surface.
propMove -px 0.1 -px 0.5 -px 0.7 -px 1.0 -px 0.7 -px 0.5 -px 0.1 -r 30 60 90
surface1 surface2 surface3 surface4 surface5 surface6 surface7;
// This performs a proportional rotate of (30,60,90) on seven surfaces.
// The percentages are only applied on the rotation 30 about the X axis. The
// percentages along Y and Z are 1.0. Note that there are 7 "-px" flags, one
// for each surface. The surfaces are rotated by 60, 90 in Y and Z.