移動先: 概要 戻り値 関連項目 フラグ Python の例
percent(
node [objects]
, [addPercent=boolean], [dropoffAxis=[linear, linear, linear]], [dropoffCurve=string], [dropoffDistance=linear], [dropoffPosition=[linear, linear, linear]], [dropoffType=string], [multiplyPercent=boolean], [value=float])
注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。
percent は「元に戻す」が可能、「照会」が可能、「編集」が不可能です。
クラスタや jointCluster など、ウェイトをかけたノードのメンバーでパーセント値を設定します。
フラグを指定しないと、指定したノードで選択したコンポーネントのパーセント値が、指定したパーセント値に設定されます。指定されたパーセント値から 0 へのドロップオフは、シェイプの周りのドロップオフ距離を使用して、ポイント、プレーン、またはカーブから指定できます。パーセント値は、ノード コンポーネントの既存パーセント値と加算したり乗算したりすることもできます。
なし
戻り値の型は照会モードでは照会フラグが基になります。
cluster, deformer, flexor, lattice, sculpt, wire, wrinkle
addPercent, dropoffAxis, dropoffCurve, dropoffDistance, dropoffPosition, dropoffType, multiplyPercent, value
ロング ネーム(ショート ネーム) |
引数型 |
プロパティ |
value(v)
|
float
|
|
|
パーセント値が適用されます。デフォルトは 1 です。
照会モードの場合、選択したオブジェクト コンポーネントのウェイトに対応する double の配列が返されます。
|
|
dropoffPosition(dp)
|
[linear, linear, linear]
|
|
|
パーセント値をドロップオフさせるポイントを指定します。
|
|
dropoffAxis(dax)
|
[linear, linear, linear]
|
|
|
dropoffPosition から始めて、パーセント値をドロップオフさせる軸を指定します。
|
|
dropoffCurve(dc)
|
string
|
|
|
パーセント値をドロップオフさせるカーブを指定します。
|
|
dropoffDistance(dds)
|
linear
|
|
|
-dp フラグ、-dax フラグ、-dc フラグで指定した、ポイント、プレーン、カーブからのドロップオフ距離を指定します。
|
|
dropoffType(dt)
|
string
|
|
|
ドロップオフの種類を指定します。-dp、-dax または -dc フラグと連動して使用されます。デフォルトは linear です。有効な値は、linear、sine、exponential、linearSquared、none です。
|
|
addPercent(ap)
|
boolean
|
|
|
-v フラグで指定したパーセント値を既存パーセント値に加算します。
|
|
multiplyPercent(mp)
|
boolean
|
|
|
-v フラグで指定したパーセント値を既存パーセント値に乗算します。
|
|
: コマンドの作成モードで使用可能なフラグ
|
: コマンドの編集モードで使用可能なフラグ
|
: コマンドの照会モードで使用可能なフラグ
|
: タプルまたはリストとして渡された複数の引数を持てるフラグ
|
import maya.cmds as cmds
# set percents on the selected items to 0.6
#
cmds.percent( 'cluster1', v=0.6 )
# set percents on the selected items dropping off along the
# z-axis starting at the origin. Dropoff distance is 5, and
# the initial value is 1. Dropoff type is linear.
#
cmds.percent( 'cluster1', dp=(0, 0, 0), dax=(0, 0, 1), dt='linear', dds=5, v=1 )
# set percents on the selected items dropping off along
# curve1. Dropoff distance is 5, and
# the initial value is 0.3.
#
cmds.percent( 'cluster2', dc='curve2', dds=3, v=0.3 )
# add 0.1 to the percents of the selected items
#
cmds.percent( 'cluster1', v=0.1, ap=True )