blendShape

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

概要

blendShape [-after] [-afterReference] [-automatic] [-before] [-components] [-copyDelta uint uint uint] [-copyInBetweenDelta uint uint uint uint] [-copyWeights uint uint uint] [-deformerTools] [-dumpInfo] [-editTarget] [-envelope float] [-exclusive string] [-export string] [-exportTarget int int] [-fixedSetupData string] [-flipTarget uint uint] [-frontOfChain] [-geometry string] [-geometryIndices] [-ignoreSelected] [-import string] [-inBetween] [-inBetweenIndex uint] [-inBetweenType string] [-includeHiddenSelections] [-mergeSource int] [-mergeTarget uint] [-mirrorDirection uint] [-mirrorTarget uint uint] [-name string] [-normalizationGroups] [-origin string] [-parallel] [-prune] [-remove] [-resetTargetDelta uint uint] [-selectedComponents] [-split] [-suppressDialog] [-symmetryAxis string] [-symmetryEdge string] [-symmetrySpace uint] [-tangentSpace] [-target string uint string float] [-topologyCheck boolean] [-transform string] [-useComponentTags] [-weight uint float] [-weightCount uint] [objects]

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

作成モードの場合、セレクション リストの最初の項目はベース シェイプとして、その他の入力はターゲット シェイプとして扱われます。リストの最初の項目に複数のシェイプがグループ化されている場合、ターゲットにも同じシェイプの階層がある必要があります。デフォーマの -g フラグを使用して、さらにベース シェイプを編集モードに追加することができます。

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-after(-af)
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの後にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
-afterReference(-ar)
-afterReference フラグを使用して、-before と -after のどちらかが自動的に選択されるハイブリッド法でデフォーマの順序を指定します。変形されているジオメトリが参照される場合、新しいデフォーマを追加するときには -after モード が使用され、そうでないときには -before モードが使用されます。-afterReference を使ってデフォーマ チェーンを構築する場合の真の効果は、デフォーマ チェーンの内部シェイプ ノードがリファレンス ファイルの境界でしか表示されないため、デフォーマ ネットワークの負担が軽くなり、リファレンスの入れ替えをより柔軟にできる場合があることです。
-automatic(-at)
-automatic フラグを使用すると、-frontOfChain と -before のいずれかを自動的に選択する方法でデフォーマの順序を指定できます。変形するジオメトリが可逆的なデフォーマの影響のみを受ける場合は、-frontOfChain モードが使用され、そうでない場合は -before モードが使用されます。
-before(-bf)
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの前にデフォーマ ノードを強制的に配置させることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
-components(-cmp)
デフォーマで使用されているコンポーネントを返します。
-copyDelta(-cd)	uint uint uint
ベース、ソース、宛先デルタ インデックス値を設定します。
-copyInBetweenDelta(-cid)	uint uint uint uint
ベース、ターゲット、ソース、宛先デルタ インデックス値を設定します。
-copyWeights(-cw)	uint uint uint
ベース、ソース、および宛先の重みインデックス値をコピーします。
-deformerTools(-dt)
デフォーマ ツール オブジェクト(存在する場合)の名前を string string ... として返します。
-dumpInfo(-dui)
このフラグは Python と共に使用することが想定されています。デフォーマに関連する情報を含む Python ディクショナリを返します。Mel と共に使用した場合は、multiIndex、affectCount、fullCount を示すデフォーマの multiIndex ごとにトリプルを含む単一のリストを返します。
-editTarget(-edt)
存在する場合は、blendShape の編集ターゲットの名前を返します。これは シェイプ エディタ(Shape Editor)に表示されます。編集中のターゲットがインビトウィーンの場合、インビトウィーンの値をシェイプ名に追加します(例: pSphere2_0.564)。
-envelope(-en)	float
デフォメーション全体のどの程度を適用するかを制御する、デフォーマのエンベロープ値を設定します。既定は 1.0 です。
-exclusive(-ex)	string
デフォメーション セットを変形パーティションに置きます。
-export(-ep)	string
名前の付いたファイル パスにシェイプを書き出します。
-exportTarget(-et)	int int
書き出しのためのベース インデックスとターゲット インデックスのペアを指定します。
-fixedSetupData(-fsd)	string
このフラグは Python と共に使用することが想定されています。デフォーマに関連する情報を含む Python ディクショナリを返します。 照会モードでは、このフラグに値が必要になります。
-flipTarget(-ft)	uint uint
ベースとターゲットのペアのリストを反転します。
-frontOfChain(-foc)
このコマンドを使用して、新しいデフォーマ ノードが、シェイプのヒストリで既存のデフォーマとスキン ノードの前(上流、ただし既存の微調整ノードの前ではありません)に配置されるように指定します。デフォーマへの入力は、表示される下流のシェイプではなく上流のシェイプです。したがって、このフラグの動作は、新しいデフォーマが追加されたときに下流のデフォーマがリセット位置（hasNoEffect）にある場合に、最も直感的になります。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
-geometry(-g)	string
-rm フラグも指定していない限り、指定したオブジェクトは、このデフォーマ オブジェクトによって変形されるオブジェクトのリストに追加されます。照会すると string string string ...を返します。
-geometryIndices(-gi)
照会モードで -geometry フラグを補完します。各ジオメトリのマルチ インデックスを返します。
-ignoreSelected(-is)
現在のセレクション リスト上のオブジェクトを変形しないようにコマンドに指示します。
-import(-ip)	string
名前の付いたファイル パスからシェイプを読み込みます。
-inBetween(-ib)
指定したターゲットがインビトウィーンとして機能することを示します。インビトウィーン ターゲットは、ベース シェイプと別のターゲット間の中間的なターゲットとして機能するものです。
-inBetweenIndex(-ibi)	uint
このインデックスで定義されたインビトウィーン ターゲット ジオメトリ内でポイントのデルタ値を除去する場合に限り、-rtd/-resetTargetDelta フラグと一緒に使用されます。
-inBetweenType(-ibt)	string
作成するインビトウィーン ターゲットがヒーロー ターゲットに対して相対的であるか、または絶対であるかを指定します。ヒーロー ターゲットに対して相対的である場合、インビトウィーン ターゲットにはヒーロー ターゲットに加えられた変更がすべて反映されます。有効な値は、相対(relative)または絶対(absolute)です。このフラグは、常に -ib/-inBetween と -t/-target フラグと一緒に使用する必要があります。
-includeHiddenSelections(-ihs)
セレクション リスト内の任意の表示および非表示オブジェクトにデフォーマを適用します。既定は false です。
-mergeSource(-mgs)	int
マージするソース インデックスのリストです。
-mergeTarget(-mgt)	uint
マージするターゲット インデックスです。
-mirrorDirection(-md)	uint
ミラー方向です。0 = 負、1 = 正
-mirrorTarget(-mt)	uint uint
ベースとターゲットのペアのリストをミラーします。
-name(-n)	string
作成されるノードの名前を指定するために使用されます。
-normalizationGroups(-ng)
使用した正規化グループ ID のリストを返します。
-origin(-o)	string
既定では、blendShape はワールド空間に対して実行されます。有効な値は「world」と「local」です。local フラグは、シェイプのローカルの原点に対してブレンド シェイプを実行します。
-parallel(-par)
オブジェクトのヒストリの既存のデフォーマに平行するチェーンの新規デフォーマを挿入します。blendShape を挿入して、平行の結果とブレンドします。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
-prune(-pr)
現在の設定のデフォーマによって変形されないポイントをデフォーマ セットから除去します。
-remove(-rm)
-g フラグの後ろにリストされているオブジェクトをこのデフォーマから除去するように指定します。
-resetTargetDelta(-rtd)	uint uint
ターゲット インデックスによって定義されたすべての連続ターゲットを含む、ターゲット ジオメトリ内のポイントのすべてのデルタ値を除去します。 パラメータ リスト: uint: ベース オブジェクトのインデックス uint: ターゲットのインデックス
-selectedComponents(-cms)
現在選択されているデフォーマで使用されているコンポーネントを返します。これは、現在の選択項目とデフォーマの影響を受けるコンポーネントを交差させます。
-split(-sp)
デフォーマを既存のチェーンに挿入/アペンドする代わりに、ディペンデンシー グラフで新しいチェーンを分岐させます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
-suppressDialog(-sd)
ダイアログ ボックスを表示しないで、ユーザが定義したとおりにコマンドを実行します。
-symmetryAxis(-sa)	string
対称の軸です。有効な値は「X」、「Y」、「Z」です。
-symmetryEdge(-se)	string
「.」で区切られた 1 つまたは 2 つの対称エッジの名前です。有効な値については、blendShape ノードの symmetryEdge アトリビュートを参照してください。
-symmetrySpace(-ss)	uint
対称のスペースです。0 = トポロジ、1 = オブジェクト、2 = UV
-tangentSpace(-ts)
指定したターゲットのデルタが、サーフェスの接線空間に対して相対的になるべきであることを示します。
-target(-t)	string uint string float
ベース シェイプ ベース オブジェクトのインデックス ターゲット シェイプとしてターゲット オブジェクトを設定します。シェイプのウェイトが targetValue の場合、ターゲット シェイプの影響を 100%受けます。 パラメータ リスト: string: ベース オブジェクト int:インデックス string: ターゲット オブジェクト double:ターゲット値
-topologyCheck(-tc)	boolean
ブレンドするシェイプ間のトポロジ一致のチェック状態を設定します。既定はオンです。
-transform(-tr)	string
ターゲットのトランスフォームを設定します。デルタはポスト トランスフォームに対して相対的になります。通常、このオプションに最適なワークフローは、導入した修正に関連するジョイントを選択することです。このフラグは、blendShape ノードの「変形順序」が「前」である場合のみ使用する必要があります。
-useComponentTags(-uct)
このフラグを指定すると、componentTags を使用した設定が作成されます。つまり、groupId、groupParts、tweak、または objectSet ノードは作成されず、新しいデフォーマに接続されません。
-weight(-w)	uint float
インデックス(最初のパラメータ)のウェイト値(2 番目のパラメータ)を設定します。
-weightCount(-wc)	uint
シェイプのウェイト値を数値で設定します。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

//
// Perform a blendShape using the currently-selected objects.
// The lead (last-selected) object will be the base shape, and each
// of the others become targets.
//
blendShape;

//
// Create a blendShape that starts with curve3 as the base, and blends
// in curve1 and curve2 as targets.

blendShape curve1 curve2 curve3;

//
// Apply 80% of the total blendShape deformation, by setting
// the envelope parameter to 0.8
blendShape -edit -en 0.8 blendShape1;

//
// Set the weights for the first two target shapes to 0.6
// and 0.1 respectively
blendShape -edit -w 0 0.6 -w 1 0.1 blendShape1;

//
// Add a third target (target1) to the blendShape on curve3
blendShape -edit -t curve3 2 target1 1.0 blendShape1;

//
// Add "smirk", an inbetween on the third target for base
// shape curve3. The inbetween will take effect at a weight of 0.2
blendShape -edit -ib -t curve3 2 smirk 0.2 blendShape1;

// Edit target 1
//
sculptTarget -e -target 1 blendShape1;

// Query the edit target
//
blendShape -q -edt blendShape1;