ジャンプ先: 概要. 戻り値. 関連. フラグ. 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 )