移動先: 概要 戻り値 フラグ. Python 例.
propMove(
[objects]
, [percent=float], [percentX=float], [percentY=float], [percentZ=float], [pivot=[float, float, float]], [rotate=[angle, angle, angle]], [scale=[float, float, float]], [translate=[linear, linear, linear]])
注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
propMove は 「元に戻す」が可能、「照会」が不可能、「編集」が不可能 です。
任意の数のオブジェクトの比率変換、スケールおよび回転を行います。
回転、スケール、または変換のパーセンテージは、-p フラグあるいは -px、-py、-pz フラグを使って指定することができます。それぞれの選択したオブジェクトには、対応する -p あるいは -px、-py、-pz フラグがなければなりません。回転、スケールまたは変換は相対的に行われます。
なし
percent, percentX, percentY, percentZ, pivot, rotate, scale, translate
ロング ネーム(ショート ネーム) |
引数型 |
プロパティ |
percent(p)
|
float
|

|
|
指定した x、y、z が、オブジェクトに与えるエフェクトのパーセンテージです。
このフラグは各オブジェクトにつき 1 つ指定しなければなりません。つまり 4 つのオブジェクトが指定されている場合、4 つの "-p" フラグが必要になります(このフラグが指定されていない場合は、1.0%が使用されます)。このフラグは通常 0.0~1.0 ですが、任意の浮動小数点を取ることもできます。
|
|
percentX(px)
|
float
|

|
|
指定した x がオブジェクトに与えるエフェクトのパーセンテージです。
このフラグは、各オブジェクトに 1 つずつ指定します。
値の範囲は 0.0~1.0 ですが、任意の浮動小数点値を取ることもできます。
-p フラグがすでに指定されている場合、このフラグの使用は無効になります。
|
|
percentY(py)
|
float
|

|
|
指定した y がオブジェクトに与えるエフェクトのパーセンテージです。
このフラグは、各オブジェクトに 1 つずつ指定します。
値の範囲は 0.0~1.0 ですが、任意の浮動小数点値を取ることもできます。
-p フラグがすでに指定されている場合、このフラグの使用は無効になります。
|
|
percentZ(pz)
|
float
|

|
|
指定した z がオブジェクトに与えるエフェクトのパーセンテージです。
このフラグは、各オブジェクトに 1 つずつ指定します。
値の範囲は 0.0~1.0 ですが、任意の浮動小数点値を取ることもできます。
-p フラグがすでに指定されている場合、このフラグの使用は無効になります。
|
|
rotate(r)
|
[angle, angle, angle]
|
|
|
各オブジェクトを指定した角度で均等に回転します。回転値は、オブジェクトの対応する "-percent" フラグで指定したパーセンテージでスケールされます。
角度はすべて度単位です。
回転の中心は、"-pivot" フラグで指定したピボットです。また "-pivot" フラグがない場合は、(0, 0, 0)です。
|
|
scale(s)
|
[float, float, float]
|
|
|
各オブジェクトを指定した量だけ均等にスケールします。スケール値は、オブジェクトの対応する "-percent" フラグで指定したパーセンテージでスケールされます。
各オブジェクトの位置と大きさは、"-pivot" フラグで指定したピボットとの関係で測定されます。デフォルトでは、各オブジェクトの個々のピボットが使用されます。
制御点などのオブジェクト コンポーネントの場合、デフォルトは親オブジェクトのピボットです。
|
|
translate(t)
|
[linear, linear, linear]
|
|
|
各オブジェクトを指定した量だけ均等に移動します。移動値は、オブジェクトの対応する "-percent" フラグで指定したパーセンテージでスケールされます。
"-pivot" フラグは移動には影響しません。
|
|
pivot(pi)
|
[float, float, float]
|
|
|
回転またはスケールの中心となるピボットを指定します。
ピボットの変更はカレントの「propMove」コマンドでのみ有効なので、エフェクトを際立たせるためには、上記の移動フラグの 1 つと連動して使用する必要があります。
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
: コマンドの照会モードで使用可能なフラグ
|
: タプルまたはリストとして渡された複数の引数を持てるフラグ
|
import maya.cmds as cmds
cmds.propMove( 3, 6, 0, 'surface1', 'surface2', 'surface3', 'surface4', 'surface5', 'surface6', 'surface7', p=[0.1, 0.5, 0.7, 1.0, 0.7, 0.5, 0.1] )
# This performs a proportional translate of (3,6,0) on seven surfaces.
# Note that there are 7 "-p" flags, one for each surface.
cmds.propMove( 'surface1', 'surface2', 'surface3', 'surface4', 'surface5', 'surface6', 'surface7', p=[0.1, 0.5, 0.7, 1.0, 0.7, 0.5, 0.1], pivot=(1, 1, 1), s=(3, 3, 3) )
# 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).
cmds.propMove( 'surface1', 'surface2', 'surface3', 'surface4', 'surface5', 'surface6', 'surface7', p=[0.1, 0.5, 0.7, 1.0, 0.7, 0.5, 0.1], r=(30, 60, 90) )
# This performs a proportional rotate of (30,60,90) on seven surfaces.
# Note that there are 7 "-p" flags, one for each surface.
cmds.propMove( 'surface1', 'surface2', 'surface3', 'surface4', 'surface5', 'surface6', 'surface7', px=[0.1, 0.5, 0.7, 1.0, 0.7, 0.5, 0.1], r=(30, 60, 90) )
# 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.