ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.
dagPose(
[objects]
, [addToPose=boolean], [atPose=boolean], [bindPose=boolean], [g=boolean], [members=boolean], [name=string], [remove=boolean], [reset=boolean], [restore=boolean], [save=boolean], [selection=boolean], [worldParent=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
dagPose は、取り消し可能、照会可能、および編集可能です。
このコマンドを使用して、DAG 階層のマトリックス情報を保存と復元することができます。具体的には、格納されたデータは、その階層の全オブジェクトの移動、回転、スケール、スケール ピボット、回転ピボット、とジョイントの順番を復元します。ほかのアトリビュートのデータは、このコマンドでは格納されません。
このコマンドを使用して、オブジェクトの bindPose を格納することもできます。オブジェクトにスキンを作成する場合、そのスキンには dagPose が自動的に作成されます。
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
bindSkin, skinCluster
addToPose, atPose, bindPose, g, members, name, remove, reset, restore, save, selection, worldParent
| ロング ネーム(ショート ネーム) |
引数タイプ |
プロパティ |
|
addToPose(a)
|
boolean
|
|
|
選択した項目の dagPose への追加を許可します。
|
|
atPose(ap)
|
boolean
|
|
|
階層がポーズと同じ場所にあるかどうか照会します。ポーズと同じ場所にない階層メンバーの名前が返されます。空のリストが返された場合、階層が同じ場所にあるということです。
|
|
bindPose(bp)
|
boolean
|
|
|
使用して、選択した階層の bindPose を指定します。各階層には、スキンのバインド時に自動的に保存される、bindPose を 1 つだけ設定することができます。bindPose は、インフルエンス オブジェクトの追加、新しいスキンのバインド、フレクサの追加時に使用されます。-rs/-reset または -rm/-remove フラグで bindPose を修正する場合には、bindPose の定義が誤っているとそれ以降のスキン操作に問題が生じるため、十分注意してください。
|
|
g(g)
|
boolean
|
|
|
このフラグを restore フラグと一緒に使用して、ポーズのメンバーをグローバル ポーズに復元することができます。グローバル ポーズとは、その親に関してローカルに作成された各オブジェクトだけではなく、ポーズが保存されたときの同じグローバル位置にあることも意味します。ポーズを保存してから階層のペアレント化が変更された場合、グローバル ポーズに関して問題が生じることがあります。
|
|
members(m)
|
boolean
|
|
|
指定したポーズのメンバーを照会します。セレクション リスト、-bp/-bindPose または -n/-name フラグを使用してポーズを指定する必要があります。
|
|
name(n)
|
string
|
|
|
ポーズの名前を指定します。このコマンドは、作成、復元、リセット、除去、と照会の操作中に使用して、作成するポーズまたは基準にするポーズを指定することができます。
|
|
remove(rm)
|
boolean
|
|
|
指定したポーズから選択したジョイントを除去します。
|
|
reset(rs)
|
boolean
|
|
|
選択したジョイントのポーズをリセットします。bindPose のデータをリセットする場合には、慎重に行ってください。ジョイントが再度ペアレント化されたり正確に bindPose で表示された場合、-rs/-reset フラグの使用が適切です。ただし、bindPose が正確な bindPose とはかなり異なる場合、それ以降のスキン操作に問題が生じる可能性があります。
|
|
restore(r)
|
boolean
|
|
|
保存されたポーズに階層を復元します。ポーズを指定するには、ポーズ ノードを選択するか、-bp/-bindPose または -n/-name フラグを使用します。
|
|
save(s)
|
boolean
|
|
|
選択した DAG 階層の dagPose を保存します。新しいポーズの名前が返されます。
|
|
selection(sl)
|
boolean
|
|
|
階層の全項目のポーズを格納するかどうか、選択した項目のみのポーズを選択するかどうかです。
|
|
worldParent(wp)
|
boolean
|
|
|
ワールドに対してペアレント化するように選択したポーズ メンバーを再計算すべきだということを示します。通常、次の操作としてワールドにオブジェクトを再ペアレント化する予定の場合に使用します。
|
|
|
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# To create a pose for all objects parented above and below
# the selected items.
#
cmds.dagPose( save=True )
# To create a dagPose named "mypose" for the selected items only and not
# the dag objects parented below the selected items.
#
cmds.dagPose( save=True, selection=True, name='mypose' )
# To restore the local (rather than global) mypose pose
#
cmds.dagPose( 'mypose', restore=True )
# To restore the mypose pose in global mode.
#
cmds.dagPose( 'mypose', restore=True, global=True )
# To query the members of the mypose pose.
#
cmds.dagPose( 'mypose', query=True, members=True )
# To return the name (if any) of the bindPose attached to the
# selected items.
#
cmds.dagPose( q=True, bindPose=True )
# To reset the pose data on a joint named bigToe for "mypose"
#
cmds.dagPose( 'bigToe', reset=True, n='mypose' )
# To remove a joint named pinky from "mypose"
#
cmds.dagPose( 'pinky', remove=True, n='mypose' )
# To restore the skeleton to its bindPose
#
cmds.dagPose( restore=True, global=True, bindPose=True )