softMod

ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.

概要

softMod( [objects] , [after=boolean], [afterReference=boolean], [before=boolean], [bindState=boolean], [components=boolean], [curveInterpolation=int], [curvePoint=float], [curveValue=float], [deformerTools=boolean], [envelope=float], [exclusive=string], [falloffAroundSelection=boolean], [falloffBasedOnX=boolean], [falloffBasedOnY=boolean], [falloffBasedOnZ=boolean], [falloffCenter=[float, float, float]], [falloffMasking=boolean], [falloffMode=int], [falloffRadius=float], [frontOfChain=boolean], [geometry=string], [geometryIndices=boolean], [ignoreSelected=boolean], [includeHiddenSelections=boolean], [name=string], [parallel=boolean], [prune=boolean], [relative=boolean], [remove=boolean], [resetGeometry=boolean], [selectedComponents=boolean], [split=boolean], [useComponentTags=boolean], [weightedNode=[string, string]])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

softMod は、取り消し可能、照会可能、および編集可能です。

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
after(af)	boolean
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの後にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
afterReference(ar)	boolean
-afterReference フラグを使用して、-before と -after のどちらかが自動的に選択されるハイブリッド法でデフォーマの順序を指定します。変形されているジオメトリが参照される場合、新しいデフォーマを追加するときには -after モード が使用され、そうでないときには -before モードが使用されます。-afterReference を使ってデフォーマ チェーンを構築する場合の真の効果は、デフォーマ チェーンの内部シェイプ ノードがリファレンス ファイルの境界でしか表示されないため、デフォーマ ネットワークの負担が軽くなり、リファレンスの入れ替えをより柔軟にできる場合があることです。
before(bf)	boolean
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの前にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
bindState(bs)	boolean
このフラグを指定して補正に追加し、softMod 化されるオブジェクトが softMod 化時に空間上の位置を保持するようにします。これは、softMod が softMod 時間にトランスフォームする場合に、softMod が作成される時間にジオメトリがジャンプしないようにするときに、必要な機能です。
components(cmp)	boolean
デフォーマで使用されているコンポーネントを返します。
curveInterpolation(ci)	int
指定した curvePoint の位置に対応したランプ補間。0 ～3 の整数値が使用できます。これらはそれぞれ「なし」、「リニア」、「スムーズ」、「スプライン」に対応します。このフラグは curvePoint および curveValue フラグと一緒に使用します。
curvePoint(cp)	float
正規化された 0-1 スケール上でのランプ値の配置。このフラグは curveInterpolation および curveValue フラグと一緒に使用します。
curveValue(cv)	float
指定した curvePoint の位置に対応したランプ値。このフラグは curveInterpolation および curvePoint フラグと一緒に使用します。
deformerTools(dt)	boolean
デフォーマ ツール オブジェクト(ある場合)の名前を string string ... として返します。
envelope(en)	float
デフォーマのエンベロープ値を設定します。既定は 1.0 です。
exclusive(ex)	string
デフォメーション セットを変形パーティションに置きます。
falloffAroundSelection(fas)	boolean
選択した成分の周囲の減衰を計算します。
falloffBasedOnX(fbx)	boolean
X 成分を使用して減衰を計算します。
falloffBasedOnY(fby)	boolean
Y 成分を使用して減衰を計算します。
falloffBasedOnZ(fbz)	boolean
Z 成分を使用して減衰を計算します。
falloffCenter(fc)	[float, float, float]
softMod の減衰の中心点を設定します。
falloffMasking(fm)	boolean
デフォメーションは選択した成分に限定されます。
falloffMode(fom)	int
softMod で使用する減衰方法を設定します。
falloffRadius(fr)	float
softMod の減衰半径を設定します。
frontOfChain(foc)	boolean
このコマンドを使用して、新しいデフォーマ ノードが、シェイプのヒストリで既存のデフォーマとスキン ノードの前(上流、ただし既存の微調整ノードの前ではありません)に配置されるように指定します。デフォーマへの入力は、表示される下流のシェイプではなく上流のシェイプです。したがって、このフラグの動作は、新しいデフォーマが追加されたときに下流のデフォーマがリセット位置(hasNoEffect)にある場合に、最も直感的になります。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
geometry(g)	string
-rm フラグも指定していない限り、指定したオブジェクトは、このデフォーマ オブジェクトによって変形されるオブジェクトのリストに追加されます。照会すると string string string ...を返します。
geometryIndices(gi)	boolean
照会モードで -geometry フラグを補完します。各ジオメトリのマルチ インデックスを返します。
ignoreSelected(ignoreSelected)	boolean
現在のセレクション リスト上のオブジェクトを変形しないようにコマンドに指示します。
includeHiddenSelections(ihs)	boolean
セレクション リスト内の任意の表示および非表示オブジェクトにデフォーマを適用します。既定は false です。
name(n)	string
作成されるノードの名前を指定するために使用されます。
parallel(par)	boolean
オブジェクトのヒストリの既存のデフォーマに平行するチェーンの新規デフォーマを挿入します。blendShape を挿入して、平行の結果とブレンドします。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
prune(pr)	boolean
現在の設定のデフォーマによって変形されないポイントをデフォーマ セットから除去します。
relative(rel)	boolean
softMod の相対モードを有効にします。相対モードでは、softMod のすぐ上の変換のみが softMod に使用されます。既定はオフです。
remove(rm)	boolean
-g フラグの後ろにリストされているオブジェクトをこのデフォーマから除去するように指定します。
resetGeometry(rg)	boolean
softMod で変形されるオブジェクトの、ジオメトリ マトリックスをリセットします。このフラグを使用して、softMod で変形されるオブジェクトをスケールする場合に発生する、不要なエフェクトを削除します。
selectedComponents(cms)	boolean
現在選択されているデフォーマで使用されているコンポーネントを返します。これは、現在の選択項目とデフォーマの影響を受けるコンポーネントを交差させます。
split(sp)	boolean
デフォーマを既存のチェーンに挿入/アペンドする代わりに、ディペンデンシー グラフで新しいチェーンを分岐させます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
useComponentTags(uct)	boolean
このフラグを指定すると、componentTags を使用した設定が作成されます。つまり、groupId、groupParts、tweak、または objectSet ノードは作成されず、新しいデフォーマに接続されません。
weightedNode(wn)	[string, string]
すべてのパーセントが適用される softMod より上の DAG トランスフォーム ノード。2 番目のノードでは、変換行列が評価された場所からの最初のノードの下位ノードを指定します。既定は softMod ハンドルです。

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

Python 例

import maya.cmds as cmds

# Create a softMod which uses the transformation of elbow1
#
cmds.joint(p=(2,0,0),name="elbow1")
cmds.joint(p=(4,0,0),name="wrist1")

cmds.sphere()
cmds.softMod( wn=('elbow1', 'elbow1') )

# Edit softMod1 to use the transformation of wrist1.
#
cmds.softMod( 'softMod1', e=True, wn=('wrist1', 'wrist1') )

# Create a relative softMod with its own softMod handle. The
# softMod handle is drawn as the letter "S".
#
cmds.polyCube();
cmds.softMod( rel=True )

# Modify the membership of an existing softMod. First, find
# the name of the softMod's associated set, then use the sets
# command to edit the set membership (add a cube and remove a plane).
#
cmds.listConnections( 'softMod1', type='objectSet' )
# Result:[u'softMod1Set'] #
cmds.sets( 'pCube2', add='softMod1Set' )
cmds.sets( 'pCube1', rm='softMod1Set' )