ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
blendShape(
[objects]
, [after=boolean], [afterReference=boolean], [before=boolean], [deformerTools=boolean], [envelope=float], [exclusive=string], [frontOfChain=boolean], [geometry=string], [geometryIndices=boolean], [ignoreSelected=boolean], [inBetween=boolean], [name=string], [normalizationGroups=boolean], [origin=string], [parallel=boolean], [prune=boolean], [remove=boolean], [split=boolean], [target=[string, uint, string, float]], [topologyCheck=boolean], [weight=[uint, float]], [weightCount=uint])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
blendShape は、取り消し可能、照会可能、および編集可能です。
このコマンドは、ブレンド シェイプ デフォーマで、初期のベースシェイプに対して各ターゲットシェイプの指定量だけブレンドするブレンド シェイプ デフォーマを作成します。ベース シェイプはそれぞれ、固有のターゲット シェイプのセットで変形されます。ターゲット シェイプには、シェイプのウェイト値の 1 つに関連付けるインデックスがあります。
作成モードの場合、セレクション リストの最初の項目はベース シェイプとして、その他の入力はターゲット シェイプとして扱われます。リストの最初の項目に複数のシェイプがグループ化されている場合、ターゲットにも同じシェイプの階層がある必要があります。デフォーマの -g フラグを使用して、さらにベース シェイプを編集モードに追加することができます。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
bindSkin, boneLattice, copyFlexor, copySkinWeights, flexor, skinCluster, skinPercent, wire, wrinkle
after, afterReference, before, deformerTools, envelope, exclusive, frontOfChain, geometry, geometryIndices, ignoreSelected, inBetween, name, normalizationGroups, origin, parallel, prune, remove, split, target, topologyCheck, weight, weightCount
ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
name(n)
|
string
|
|
|
作成されるノードの名前を指定するために使用されます。
|
|
geometry(g)
|
string
|
|
|
-rm フラグも指定していない限り、指定したオブジェクトは、このデフォーマ オブジェクトによって変形されるオブジェクトのリストに追加されます。照会すると string string string ...を返します。
|
|
geometryIndices(gi)
|
boolean
|
|
|
照会モードで -geometry フラグを補完します。各ジオメトリのマルチ インデックスを返します。
|
|
remove(rm)
|
boolean
|
|
|
-g フラグの後ろにリストされているオブジェクトをこのデフォーマから除去するように指定します。
|
|
before(bf)
|
boolean
|
|
|
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、強制的にこのコマンドによってチェーンの選択したノードの前にデフォーマ ノードをスティックさせることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
|
|
after(af)
|
boolean
|
|
|
既存のチェーンに対する挿入やアペンドの既定動作が目的どおりでない場合、新しいジオメトリ シェイプを作成する必要があっても、このフラグを使用して、コマンドによってチェーンの選択したノードの後にデフォーマ ノードを強制的にスティックさせることができます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
|
|
afterReference(ar)
|
boolean
|
|
|
-afterReference フラグを使用して、-before と -after のどちらかが自動的に選択されるハイブリッド法でデフォーマの順序を指定します。デフォームされているジオメトリが参照される場合は、-before モードではなく、-after モードを使用して新しいデフォーマを追加します。-afterReference を使ってデフォーマ チェーンを構築する場合の真の効果は、デフォーマ チェーンの内部シェイプ ノードがリファレンス ファイルの境界でしか表示されないため、デフォーマ ネットワークの負担が軽くなり、リファレンスの入れ替えをより柔軟にできる場合があることです。
|
|
split(sp)
|
boolean
|
|
|
デフォーマを既存のチェーンに挿入/アペンドする代わりに、ディペンデンシー グラフで新しいチェーンを分岐させます。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
|
|
frontOfChain(foc)
|
boolean
|
|
|
このコマンドを使用して、新しいデフォーマ ノードが、シェイプのヒストリで既存のデフォーマとスキン ノードの前(上流、ただし既存の微調整ノードの前ではありません)に配置されるように指定します。デフォーマへの入力は、表示される下流のシェイプではなく上流のシェイプです。したがって、このフラグの動作は、新しいデフォーマが追加されたときに下流のデフォーマがリセット位置(hasNoEffect)にある場合に、最も直感的になります。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
|
|
parallel(par)
|
boolean
|
|
|
オブジェクトのヒストリの既存のデフォーマに平行するチェーンの新規デフォーマを挿入します。blendShape を挿入して、平行の結果とブレンドします。作成モード(デフォーマにジオメトリが追加されていない場合は編集モード)で動作します。
|
|
ignoreSelected(ignoreSelected)
|
boolean
|
|
|
現在のセレクション リスト上のオブジェクトを変形しないようにコマンドに指示します。
|
|
deformerTools(dt)
|
boolean
|
|
|
デフォーマ ツール オブジェクト(ある場合)の名前を string string ... として返します。
|
|
prune(pr)
|
boolean
|
|
|
現在の設定のデフォーマによって変形されないポイントをデフォーマ セットから除去します。
|
|
exclusive(ex)
|
string
|
|
|
デフォメーション セットをデフォーム パーティションに置きます。
|
|
envelope(en)
|
float
|
|
|
デフォメーション全体のどの程度を適用するかを制御する、デフォーマのエンベロープ値を設定します。既定は 1.0 です。
|
|
target(t)
|
[string, uint, string, float]
|
|
|
ベース シェイプ ベース オブジェクトのインデックス ターゲット シェイプとしてターゲット オブジェクトを設定します。シェイプのウェイトが targetValue の場合、ターゲット シェイプの影響を 100%受けます。 パラメータ リスト:
- string: ベース オブジェクト
- int:インデックス
- string: ターゲット オブジェクト
- double:ターゲット値
|
|
inBetween(ib)
|
boolean
|
|
|
指定したターゲットがインビトウィーンとして機能することを示します。インビトウィーン ターゲットは、ベース シェイプと別のターゲット間の中間的なターゲットとして機能するものです。
|
|
topologyCheck(tc)
|
boolean
|
|
|
ブレンドするシェイプ間のトポロジ一致のチェック状態を設定します。既定はオンです。
|
|
weight(w)
|
[uint, float]
|
|
|
インデックス(最初のパラメータ)のウェイト値(2 番目のパラメータ)を設定します。
|
|
weightCount(wc)
|
uint
|
|
|
origin(o)
|
string
|
|
|
既定では、blendShape はワールド空間に対して実行されます。有効な値は「world」と「local」です。local フラグは、シェイプのローカルの原点に対してブレンド シェイプを実行します。
|
|
normalizationGroups(ng)
|
boolean
|
|
|
使用したグループ ID の正規化のリストを返します。
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
#
# 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.
#
cmds.blendShape()
#
# Create a blendShape that starts with curve3 as the base, and blends
# in curve1 and curve2 as targets.
cmds.blendShape( 'curve1', 'curve2', 'curve3' )
#
# Apply 80% of the total blendShape deformation, by setting
# the envelope parameter to 0.8
cmds.blendShape( 'blendShape1', edit=True, en=0.8 )
#
# Set the weights for the first two target shapes to 0.6
# and 0.1 respecxtively
cmds.blendShape( 'blendShape1', edit=True, w=[(0, 0.6), (1, 0.1)] )
#
# Add a third target (target3) to the blendShape on curve3
cmds.blendShape( 'blendShape1', edit=True, t=('curve3', 1, 'target3', 1.0) )
#
# Add an inbetween (smirk) on target3 for base shape curve3
# The inbetween will take effect at a weight of 0.2
cmds.blendShape( 'blendShape2', edit=True, ib=True, t=('curve3', 2, 'smirk', 0.2) )