ジャンプ先: 概要. 戻り値. 関連. フラグ. 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
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
addPercent(ap) boolean create
-v フラグで指定したパーセント値を既存パーセント値に加算します。
dropoffAxis(dax) [linear, linear, linear] create
dropoffPosition から始めて、パーセント値をドロップオフさせる軸を指定します。
dropoffCurve(dc) string create
パーセント値をドロップオフさせるカーブを指定します。
dropoffDistance(dds) linear create
-dp フラグ、-dax フラグ、-dc フラグで指定した、ポイント、プレーン、カーブからのドロップオフ距離を指定します。
dropoffPosition(dp) [linear, linear, linear] create
パーセント値をドロップオフさせるポイントを指定します。
dropoffType(dt) string create
ドロップオフの種類を指定します。-dp、-dax または -dc フラグと連動して使用されます。既定は linear です。有効な値は、linear、sine、exponential、linearSquared、none です。
multiplyPercent(mp) boolean create
-v フラグで指定したパーセント値を既存パーセント値に乗算します。
value(v) float createquery
パーセント値が適用されます。既定は 1 です。照会モードの場合、選択したオブジェクト コンポーネントのウェイトに対応する double の配列が返されます。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

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 )