移動先: 概要 戻り値 フラグ. 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 createmultiuse
指定した x、y、z が、オブジェクトに与えるエフェクトのパーセンテージです。 このフラグは各オブジェクトにつき 1 つ指定しなければなりません。つまり 4 つのオブジェクトが指定されている場合、4 つの "-p" フラグが必要になります(このフラグが指定されていない場合は、1.0%が使用されます)。このフラグは通常 0.0~1.0 ですが、任意の浮動小数点を取ることもできます。
percentX(px) float createmultiuse
指定した x がオブジェクトに与えるエフェクトのパーセンテージです。 このフラグは、各オブジェクトに 1 つずつ指定します。 値の範囲は 0.0~1.0 ですが、任意の浮動小数点値を取ることもできます。 -p フラグがすでに指定されている場合、このフラグの使用は無効になります。
percentY(py) float createmultiuse
指定した y がオブジェクトに与えるエフェクトのパーセンテージです。 このフラグは、各オブジェクトに 1 つずつ指定します。 値の範囲は 0.0~1.0 ですが、任意の浮動小数点値を取ることもできます。 -p フラグがすでに指定されている場合、このフラグの使用は無効になります。
percentZ(pz) float createmultiuse
指定した z がオブジェクトに与えるエフェクトのパーセンテージです。 このフラグは、各オブジェクトに 1 つずつ指定します。 値の範囲は 0.0~1.0 ですが、任意の浮動小数点値を取ることもできます。 -p フラグがすでに指定されている場合、このフラグの使用は無効になります。
rotate(r) [angle, angle, angle] create
各オブジェクトを指定した角度で均等に回転します。回転値は、オブジェクトの対応する "-percent" フラグで指定したパーセンテージでスケールされます。 角度はすべて度単位です。 回転の中心は、"-pivot" フラグで指定したピボットです。また "-pivot" フラグがない場合は、(0, 0, 0)です。
scale(s) [float, float, float] create
各オブジェクトを指定した量だけ均等にスケールします。スケール値は、オブジェクトの対応する "-percent" フラグで指定したパーセンテージでスケールされます。 各オブジェクトの位置と大きさは、"-pivot" フラグで指定したピボットとの関係で測定されます。デフォルトでは、各オブジェクトの個々のピボットが使用されます。 制御点などのオブジェクト コンポーネントの場合、デフォルトは親オブジェクトのピボットです。
translate(t) [linear, linear, linear] create
各オブジェクトを指定した量だけ均等に移動します。移動値は、オブジェクトの対応する "-percent" フラグで指定したパーセンテージでスケールされます。 "-pivot" フラグは移動には影響しません。
pivot(pi) [float, float, float] create
回転またはスケールの中心となるピボットを指定します。 ピボットの変更はカレントの「propMove」コマンドでのみ有効なので、エフェクトを際立たせるためには、上記の移動フラグの 1 つと連動して使用する必要があります。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

Python 例

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.