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(-rn)	string[]
コンテナから削除するノードのリストを指定します。
-nodeList(-nl)
照会すると、コンテナ内のノードのリストを返します。
-unsortedOrder(-uso)
-nodeList/-nl フラグは、ノードのソート済みリストを返します。このフラグを使用して、コンテナに追加された順序でノードを取得できます。また、reorderContainer コマンドによって行われたすべての順序の変更も表示します。
-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 番目の状態のみが返されます。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 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;