container

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

概要

container [-addNode string[]] [-asset string[]] [-assetMember string] [-bindAttr string string] [-connectionList] [-current boolean] [-fileName string[]] [-findContainer string[]] [-force] [-includeHierarchyAbove] [-includeHierarchyBelow] [-includeNetwork] [-includeNetworkDetails string] [-includeShaders] [-includeShapes] [-includeTransform] [-isContainer] [-name string] [-nodeList] [-nodeNamePrefix] [-parentContainer] [-preview] [-publishAndBind string string] [-publishAsChild string string] [-publishAsParent string string] [-publishAsRoot string boolean] [-publishAttr string] [-publishConnections] [-publishName string] [-removeContainer] [-removeNode string[]] [-type string] [-unbindAndUnpublish string] [-unbindAttr string string] [-unbindChild string] [-unbindParent string] [-unpublishChild string] [-unpublishName string] [-unpublishParent string] [-unsortedOrder] [string...]

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

• コンテナに対するノードの追加と除去
• コンテナ内のノードからの、アトリビュートのパブリッシュ
• 1 つのコンテナから別のコンテナへの、接続と値の置き換え
• コンテナのメンバー ノードを除去しない、コンテナの除去

戻り値

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

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-name(-n)	string
新しく作成するコンテナの名前を設定します。
-addNode(-an)	string[]
コンテナに追加するノードのリストを指定します。
-force(-f)
このフラグは、-addNode フラグおよび -removeNode フラグとしか使用できません。-addNode を指定すると、ノードは、新しいコンテナに追加される前に、現在のコンテナから接続解除されます。-removeNode を指定すると、ノードは、ネストされたコンテナから除去する場合、親コンテナに残るのではなく、すべてのコンテナから除去されます。
-removeNode(-rn)	string[]
コンテナから除去するノードのリストを指定します。ノードがネストされたコンテナのメンバーである場合、親コンテナに追加されます。すべてのコンテナから完全に除去するには、-force フラグを使用します。
-nodeList(-nl)
照会すると、コンテナ内のノードのリストを返します。リストはコンテナに追加された順序でソートされます。また、reorderContainer コマンドによって行われたすべての順序の変更も表示します。
-unsortedOrder(-uso)
このフラグはコンテナ コマンド(OBSOLETE)の動作には影響しません。
-findContainer(-fc)	string[]
照会すると、nodeList のすべてのノードが同じコンテナに属する場合は、コンテナの名前を返します。それ以外の場合、空の文字列を返します。 照会モードでは、このフラグに値が必要になります。
-removeContainer(-rc)
コンテナからすべてのノードを接続解除し、コンテナ ノードを削除します。
-connectionList(-cl)
コンテナ ノードに対する外部接続のリストを返します。
-publishConnections(-pc)
コンテナ内のノードからコンテナ外のノードへのすべての接続をパブリッシュします。
-publishAttr(-pa)	string
照会モードでは -publishName(-pn)フラグと同時の場合のみ使用でき、アトリビュートを引数として使用します。戻り値は、アトリビュートのパブリッシュ済みの名前になります(ある場合)。 照会モードでは、このフラグに値が必要になります。
-publishName(-pn)	string
名前をコンテナのインタフェースに対してパブリッシュし、インタフェースに対してパブリッシュされた実際の名前を返します。照会モードでは、コンテナのパブリッシュ済みの名前を返します。-bindAttr フラグが指定されている場合、バインドされた名前のみを返します。-unbindAttr フラグが指定されている場合、バインドされていない名前のみを返します。-publishAsParent/-publishAsChild フラグが指定されている場合、パブリッシュ済みの親/子の名前のみを返します。-publishAttr が、「node.attr」フォーマットのアトリビュート引数と同時に指定されている場合、そのアトリビュートにパブリッシュ済みの名前があるときにそれを返します。
-unpublishName(-un)	string
バインドされていない名前のパブリッシュを、コンテナのインタフェースから取り消します。
-bindAttr(-ba)	string string
内蔵されたアトリビュートを、コンテナのインタフェース上にある、バインドされていないパブリッシュ済みの名前にバインドします。戻り値は、バインドされたパブリッシュ済みの名前です。1 番目の文字列は、ノード名とアトリビュート名をバインドするように「node.attr」フォーマットで指定します。2 番目の文字列は、バインドされていないパブリッシュ済みの名前を指定します。照会モードでは、パブリッシュ済みの名前の文字配列とそれに対応するアトリビュートを返します。また、このフラグは、-publishName、-publishAsParent、-publishAsChild フラグと同時に照会モードで使用することもできます。
-unbindAttr(-ua)	string string
パブリッシュ済みアトリビュートのバインドを、コンテナのインタフェースのパブリッシュ済みの名前から解除し、バインドされていないパブリッシュ済みの名前をコンテナのインタフェース上に残します。戻り値は、バインドされていないパブリッシュ済みの名前です。1 番目の文字列は、ノード名とアトリビュート名をバインド解除するように「node.attr」フォーマットで指定します。2 番目の文字列は、バインドされたパブリッシュ済みの名前を指定します。照会モードでは、-publishName、-publishAsParent、-publishAsChild フラグと一緒にのみ使用可能です。
-publishAndBind(-pb)	string string
指定した名前をパブリッシュし、指定した名前にアトリビュートをバインドします。1 番目の文字列は、ノード名とアトリビュート名を「node.attr」フォーマットで指定します。2 番目の文字列は、同時にパブリッシュする名前を指定します。
-unbindAndUnpublish(-ubp)	string
指定したアトリビュートを(「node.attr」フォーマットで)バインド解除し、接続された名前のパブリッシュを解除します。複合(Compound)をバインド解除すると、その複合の親/子の複合解除がトリガされることがあります。従って、この 1 つのフラグを使用する利点は、自動バインド解除に接続された名前を自動パブリッシュ解除することです。
-publishAsParent(-pap)	string string
内蔵されたノードをコンテナのインタフェースに対してパブリッシュすることで、このノードが外部ノードの親となれることを示します。2 番目の文字列は、パブリッシュ済みのノード名です。照会モードでは、パブリッシュ済みの名前とそれに対応するノードの文字配列を返します。-publishName フラグを照会モードで使用すると、パブリッシュ済みの名前のみを返します。-bindAttr フラグを照会モードで使用すると、パブリッシュ済みのノード名のみを返します。
-publishAsChild(-pac)	string string
内蔵されたノードをコンテナのインタフェースに対してパブリッシュすることで、このノードが外部ノードの子となれることを示します。2 番目の文字列は、パブリッシュ済みのノード名です。照会モードでは、パブリッシュ済みの名前とそれに対応するノードの文字列を返します。-publishName フラグを照会モードで使用すると、パブリッシュ済みの名前のみを返します。-bindAttr フラグを照会モードで使用すると、パブリッシュ済みのノード名のみを返します。
-publishAsRoot(-pro)	string boolean
ノードをルートとしてパブリッシュまたはパブリッシュ解除します。ルート トランスフォーム ノードは二重の意味で重要です。コンテナ中心の選択が有効な場合、ルート トランスフォームの下位階層にあるコンテナ ノードがメイン シーン ビューで選択されると、そのルート トランスフォームが選択されます。また、コンテナ プロキシの書き出し時、移動、回転、スケールなど、すべてのパブリッシュ済みルート変換アトリビュートは、スタンドイン ノード上のアトリビュートと接続されます。照会モードでは、ルートとしてパブリッシュされたノードを返します。
-unpublishParent(-upp)	string
親としてパブリッシュされたノードのパブリッシュを、コンテナのインタフェースから取り消します。
-unpublishChild(-upc)	string
子としてパブリッシュされたノードのパブリッシュを、コンテナのインタフェースから取り消します。
-unbindParent(-unp)	string
親としてパブリッシュされたノードのバインドを解除しますが、コンテナのインタフェースからパブリッシュされた名前は除去しません。
-unbindChild(-unc)	string
子としてパブリッシュされたノードのバインドを解除しますが、コンテナのインタフェースからパブリッシュされた名前は除去しません。
-nodeNamePrefix(-nnp)
パブリッシュ済みアトリビュートの名前を形式「node_attr」にすることを指定します。-publishConnections/-pc フラグとともに使用します。
-includeNetwork(-inc)
提供済みノード リストに接続されたノード ネットワークもコンテナに含まれることを指定します。ネットワーク走査は、既定のノードと、他のコンテナのメンバーになっているノードで停止します。
-includeNetworkDetails(-ind)	string
このフラグを使用して、含めるネットワークの特定部分を指定します。。このフラグで有効な引数は次の通りです。「channels」、「sdk」、「constraints」、「history」、「expressions」、「inputs」、「outputs」。このフラグと includeNetwork フラグの違いは、タイプに関係なく接続されたすべてのノードが含まれることです。DAG コンテナにはその子が含まれるため、コンストレイントが入力として指定されていない場合でも、常に選択したオブジェクトにペアレント化されたコンストレイント ノードが含まれます。
-includeHierarchyAbove(-iha)
このフラグを使用して、提供されたノード リストの親階層もコンテナに含むこと、あるいはコンテナから削除することを指定します。階層の算入は、他のコンテナのメンバーになっているノードで停止します。
-includeHierarchyBelow(-ihb)
このフラグを使用して、提供されたノード リストの下階層もコンテナに含むこと、あるいはコンテナから削除することを指定します。階層の算入は、他のコンテナのメンバーになっているノードで停止します。
-includeTransform(-it)
このフラグを使用して、選択した任意のシェイプの親トランスフォームもコンテナに含むこと、あるいはコンテナから削除することを指定します。このフラグは includeHierarchyAbove が使用されている場合は必要ありません。この場合、親トランスフォームとそのすべての親が自動的に含まれるからです。
-includeShapes(-ish)
このフラグを使用して、選択した任意のトランスフォームの直下にある子シェイプもコンテナに含むこと、あるいはコンテナから削除することを指定します。このフラグは includeHierarchyBelow が使用されている場合は必要ありません。この場合、子シェイプとそのすべての子が自動的に含まれるからです。
-includeShaders(-isd)
含まれている任意のシェイプに対して、そのシェーダもコンテナに含まれることを指定します。
-fileName(-fn)	string[]
指定したファイル名と関連付けられているアセットの照会に使用されます。 照会モードでは、このフラグに値が必要になります。
-current(-c)	boolean
作成モードでは、新たに作成されたアセットは常に現在になるように指定します。編集モードでは、選択したアセットを現在に設定します。照会では、現在のアセットを返します。
-parentContainer(-par)
指定したコンテナの親コンテナを照会するためのフラグです。
-assetMember(-am)	string
照会時に bindAttr フラグと同時に使用することで、指定したコンテナ内ノードに関連するパブリッシュ済みアトリビュートのみを照会できます。 照会モードでは、このフラグに値が必要になります。
-asset(-a)	string[]
照会すると、nodeList のすべてのノードが同じコンテナに属する場合は、コンテナの名前を返します。それ以外の場合、空の文字列を返します。このフラグは機能的には findContainer フラグと同等です。
-preview(-p)
このフラグは作成モードでのみ有効です。これはコンテナを作成せず、内容をプレビューすることを示します。このフラグを使用すると、コンテナを作成した場合にコンテナに配置されるノードが選択されます。たとえば、-includeNetwork でコンテナに含まれる内容を確認し、選択内容を希望どおりに修正してから、選択したオブジェクトに対してのみ create container を実行できます。
-type(-typ)	string
既定では、コンテナ ノードが作成されます。または、type フラグを使用して、異なるタイプのコンテナを作成する必要があることを示すこともできます。現在のところ、コンテナ ノードの有効な別のタイプは「dagContainer」のみです。
-isContainer(-isc)
選択または指定されたノードがコンテナ ノードであれば、true を返します。複数のコンテナが照会されれば、1 番目の状態のみが返されます。

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

MEL 例

// Create a container holding a locator transform only (not its shape)
//
string $loc[] = `spaceLocator`;
string $con1 = `container -addNode { $loc[0] }`;

// Select the nodes that would be in the container, but don't create it
//
container -preview -addNode { $cone[0] } -includeNetwork -includeHierarchyBelow;

// Create a container holding a polygon shape, its transform and its
// history node. Publish its tx attr.
//
string $cone[] = `polyCone`;
string $con2 = `container -addNode { $cone[0] } -includeNetwork -includeHierarchyBelow`;

// Publish the cone's tx and the locator's tx with the same name
//
container -edit -publishName "main_tx" $con1;
container -edit -bindAttr ($loc[0]+".tx") "main_tx" $con1;
container -edit -publishName "main_tx" $con2;
container -edit -bindAttr ($cone[0]+".tx") "main_tx" $con2;

// Publish the name "sam", but don't bind it to anything
//
container -edit -publishName "sam" $con1;

// Query the bound publications
//
container -query -bindAttr $con1;
// Result: locator1.translateX main_tx //

// Query all the published names:
//
container -query -publishName $con1;
// Result: main_tx sam //

// Query just the bound published names:
//
container -query -publishName -bindAttr $con1;
// Result: main_tx //

// Query just the unbound published names:
container -query -publishName -unbindAttr $con1;
// Result: sam //

// Query just the published name for the published attribute locator1.translateX
//
container -query -publishName -publishAttr locator1.translateX $con1;
// Result: main_tx //

// keyframe the cone's tx
//
currentTime 0;
setKeyframe ($cone[0]+".tx");
currentTime 4;
setAttr ($cone[0]+".tx") 10.0;
setKeyframe ($cone[0]+".tx");

// Query the nodes in the container
//
string $nodes[] = `container -query -nodeList $con2`;

// Remove a node from the container
//
container -edit -removeNode $nodes[2] $con2;

// Remove the container without deleting the nodes within it
//
container -edit -removeContainer $con2;

// query a referenced scenes for its assets
//
container -fileName "C:/My Documents/maya/projects/default/scenes/refFile.mb" -q;