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

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

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 )