ジャンプ先: 概要. 戻り値. キーワード. 関連項目. フラグ. MEL 例.

概要

containerTemplate [-addBindingSet string] [-addNames] [-addView string] [-attributeList string] [-baseName string] [-bindingSetList string] [-childAnchor] [-delete] [-exists] [-expandCompounds boolean] [-fileName string] [-force] [-fromContainer string] [-layoutMode int] [-load] [-matchFile string] [-matchName string] [-parentAnchor] [-publishedNodeList string] [-removeBindingSet string] [-removeView string] [-rootTransform] [-save] [-searchPath string] [-silent] [-templateList string] [-unload] [-updateBindingSet string] [-viewList string] [string]

containerTemplate は 「元に戻す」が不可能、「照会」が可能、「編集」が可能 です。

コンテナ テンプレートは、コンテナのパブリッシュされたインタフェースの説明です。 このコマンドは、コンテナのテンプレート ファイルを作成して保存したり、既存のテンプレート ファイルをロードしたりする機能を提供します。テンプレートが存在する限り、ユーザはそのテンプレート情報を照会できます。

戻り値

なし

戻り値の型は照会モードでは照会フラグが基になります。

キーワード

container, template

関連項目

container, containerView

フラグ

addBindingSet, addNames, addView, attributeList, baseName, bindingSetList, childAnchor, delete, exists, expandCompounds, fileName, force, fromContainer, layoutMode, load, matchFile, matchName, parentAnchor, publishedNodeList, removeBindingSet, removeView, rootTransform, save, searchPath, silent, templateList, unload, updateBindingSet, viewList
ロング ネーム(ショート ネーム) 引数型 プロパティ
-exists(-ex) query
指定したテンプレートが存在するかどうかによって、true または false を返します。matchFile 引数と一緒に使用する際、テンプレートが存在し、ロード元のファイル名が指定のファイル名と一致する場合、照会は true を返します。
-load(-l)
ファイルから既存のテンプレートをロードします。テンプレートに対するファイル名を指定すると、ファイル全体(つまりファイル内のすべてのテンプレート)がロードされます。ファイル名を指定しないと、テンプレート名に基づいて、デフォルトのファイル名が使用されます。
-save(-s) create
ファイルに指定したテンプレートを保存します。テンプレートに対するファイル名を指定すると、ファイル全体(つまりファイルに関連付けられたすべてのテンプレート)が保存されます。ファイル名を指定しないと、テンプレート名に基づいて、デフォルトのファイル名が使用されます。
-delete(-d) create
指定したテンプレートとそのファイルを削除します。このテンプレートにコネクトされたすべてのオブジェクト、または同じテンプレート ファイルに含まれるすべてのオブジェクトが削除されます。ファイルを完全に削除しないで単にテンプレートをアンロードするだけの場合は、このコマンドではなくアンロードを使用してください。
-unload(-u) create
指定したテンプレートをアンロードします。このアクションは、関連するテンプレート ファイルを削除するのではなく、単にテンプレート定義をカレント セッションから削除するだけです。完全に削除する必要がある場合は、削除アクションを使用してください。
-fromContainer(-fc) string create
この引数は作成または編集モードで使用し、テンプレート内容の作成に使用されるコンテナ ノードを指定します。テンプレートの作成モードでは、指定したコンテナ内のパブリッシュされたアトリビュートのリストに基づいて、テンプレート定義が作成されます。編集モードで、addNames フラグと一緒に使用するか、他のフラグを使用しない場合、コンテナ上にあるパブリッシュされた名前のうち、テンプレートのアトリビュートとして存在しないものはテンプレートに追加されます。 このフラグは addView などのフラグとも一緒に使用します。
-addNames(-an) edit
編集モードで、fromContainer フラグと一緒に使用する場合、コンテナ上にあるパブリッシュされた名前のうち、テンプレートのアトリビュートとして存在しないものはテンプレートに追加されます。
-addView(-av) string createedit
この引数は、新しいビューを指定した名前でテンプレートに追加するのに使用します。デフォルトでは、すべてのテンプレート アトリビュートのフラットなリストを含むビューが作成されます。layoutMode フラグでは、より詳細なレイアウト オプションを指定できます。新規ビューをテンプレート ファイルと格納する前に、テンプレートを保存する必要があります。
-removeView(-rv) string createedit
この引数を使用して、指定したビューをテンプレートから削除します。 ビューをテンプレート ファイルから永久に削除する前に、テンプレートを保存する必要があります。
-layoutMode(-lm) int create
この引数は、ビューの作成時にレイアウト モードを指定するのに使用します。値は次のとおりです。0: フラット リストでレイアウト(ビューをコンテナから作成しない場合のデフォルト) 1: ノードでグループ化したレイアウト(ビューをコンテナから作成する場合のデフォルト) ノード情報を必要とするレイアウト モードには、リファレンス コンテナを提供するために fromContainer 引数が必要です。ビューは定義済みのテンプレート アトリビュートしか参照できないことに注意してください。つまり、fromContainer フラグを使用してビューを既存のテンプレートに追加する場合、テンプレートとコンテナの両方で定義されたアトリビュートのみがビューに追加されます(つまり、テンプレートで定義されていないコンテナにパブリッシュされたアトリビュートは無視されます)。
-expandCompounds(-ec) boolean createedit
この引数は、複合の親アトリビュートとその子を両方ともコンテナにパブリッシュする場合に、生成されたビューにどのように追加するかを定義するのに使用します。 true の場合、コンテナにパブリッシュされた複合の親アトリビュートとすべての複合の子アトリビュートがビューに追加されます。false の場合は、親アトリビュートのみがビューに追加されます。注: 子アトリビュートのみがパブリッシュされて親はパブリッシュされない場合は、子がビューに追加されます。このフラグは親と子の両方のアトリビュートがコンテナにパブリッシュされる状況でのみ使用します。デフォルト値は false です。
-addBindingSet(-abs) string createedit
この引数を使用して、指定した名前の新しいバインド セットをテンプレートに追加します。デフォルトのバインド セットが作成されます。バインド セットがすでに存在する場合、既存のバインド セットを置き換えるには force フラグを使用する必要があります。 fromContainer オプションと一緒に使用すると、指定したコンテナの既存のバインドをもとにデフォルトのバインドが開始されます。 リファレンス コンテナなしで使用すると、バインド セットはプレースホルダ エントリが含まれた状態で作成されます。 新規バインド セットをテンプレート ファイルに永久保存するには、テンプレートを保存する必要があります。
-updateBindingSet(-ubs) string createedit
この引数を使用して、既存のバインド セットを新規のバインドに更新します。 fromContainer 引数と一緒に使用すると、指定コンテナのバインドをもとに、バインド セット エントリはバインド セット内で置き換えまたはマージされます。 force フラグを使用すると、バインド セットの既存エントリの値が置き換えられます。 使用しないと、新規エントリのみがバインド セットにマージされ、既存エントリは変更されません。 リファレンス コンテナなしで使用すると、バインド セットはプレースホルダ エントリが含まれた状態で更新されます。 新規バインド セットをテンプレート ファイルに永久保存するには、テンプレートを保存する必要があります。
-removeBindingSet(-rbs) string createedit
この引数を使用して、指定したバインド セットをテンプレートから削除します。 バインド セットをテンプレート ファイルから永久に削除するには、テンプレートを保存する必要があります。
-fileName(-fn) string createquery
テンプレートに関連付けるファイル名を指定します。この引数は、ロード、保存、または照会モードと一緒に使用できます。テンプレートに関連付けられた名前がない場合は、テンプレート名に基づいたデフォルトのファイル名が使用されます。ファイル名とテンプレート名を対応させることをお勧めしますが、必須ではありません。
-matchFile(-mf) string query
このフラグは、他のフラグと一緒に使用して照会モードで使用し、照会操作の一部として一致させるオプションのファイル名を指定します。

このフラグは照会モードでは値が必要になります。

-matchName(-mn) string query
このフラグは、他のフラグと一緒に使用して照会モードで使用し、照会操作の一部として一致させるオプションのテンプレート名を指定します。ベース テンプレート名はマッチングに使用され、同じベース名を持つすべてのテンプレートは異なるパッケージを渡ってマッチされます。

このフラグは照会モードでは値が必要になります。

-force(-f) create
このフラグは他のアクションとともに使用して、上書きや破壊的な操作を実行できるようにします。ロードで使用すると、ファイルから既存のテンプレートを再ロードできるようになります。作成モードで使用すると、既存のテンプレートを再作成することができるようになります(fromContainer 引数を使用してテンプレートを再生成する場合など)。
-attributeList(-al) string createqueryedit
照会モードで使用して、テンプレート定義に含まれるアトリビュートのリストを返します。
-viewList(-vl) string createquery
照会モードで使用するこのフラグは、テンプレートに定義されたすべてのビューのリストを返します。
-publishedNodeList(-pnl) string createqueryedit
照会モードで使用するこのフラグは、テンプレート定義に含まれるパブリッシュ済みノードのリストを返します。 デフォルトでは、テンプレートにあるすべてのパブリッシュされたノードを返します。 パブリッシュされたノードのリストは、childAnchor、parentAnchor、rootTransform フラグを使って特定のタイプのパブリッシュされたノードに限定することができます。 オプションのフラグを指定すると、指定したタイプのノードのみが返されます。
-childAnchor(-can) createquery
このフラグは publishedNodeList を照会する場合に、オプションとして指定できます。 結果のリストには、childAnchor タイプのパブリッシュされたノードのみが表示されます。
-parentAnchor(-pan) createquery
このフラグは publishedNodeList を照会する場合に、オプションとして指定できます。 結果のリストには、parentAnchor タイプのパブリッシュされたノードのみが表示されます。
-rootTransform(-rtn) createquery
このフラグは publishedNodeList を照会する場合に、オプションとして指定できます。 結果のリストには、rootTransform タイプのパブリッシュされたノードのみが表示されます。
-bindingSetList(-bsl) string createquery
照会モードで使用するこのフラグは、テンプレートに定義されたすべてのバインド セットのリストを返します。
-baseName(-bn) string createquery
照会モードで使用して、テンプレートのベース名を返します。ベース名はすべての修飾語句を除いたテンプレート名です。
-templateList(-tl) string query
照会モードで使用して、ロードされたすべてのテンプレートのリストを返します。この照会はオプションの matchFile フラグおよび matchName フラグと一緒に使用できます。matchFile フラグと一緒に使用すると、テンプレートのリストは、指定したファイルにコネクトされたものに限定されます。matchName フラグと一緒に使用すると、テンプレートのリストは、指定したテンプレート名にマッチするものに限定されます。
-searchPath(-sp) string queryedit
テンプレートの検索パスは、テンプレート ファイルが検索されるすべての場所を、最初に検索される場所から最後に検索される場所までの順番に列挙するリストです。 テンプレートの検索パス設定はカレントのワークスペースに格納され、「テンプレート」のファイル規則のエントリとして設定、照会することができます(詳細については、workspace コマンドを参照してください)。 編集モードでは、このフラグで検索パス設定をカスタマイズすることができます。 検索パスの値を設定する場合、リストはカレント プラットフォームが要求するパス リストのフォーマットに準拠している必要があります。つまり Windows の場合はパスをセミコロン「;」で分け、Linux と Mac OSX の場合はコロン「:」で分けます。環境変数を使用することもできます。 Maya がカスタマイズした設定にビルトイン パスを自動的に追加することがあります。 照会モードでは、このフラグは検索パスのカレントのコンテンツを返します。 カスタマイズ、ビルトイン双方のすべてのパスが、照会の戻り値に含まれます。
-silent(-si) createqueryedit
サイレント モードは、通常はコマンドの実行でレポートされるすべてのエラーや警告メッセージを出力しないようにします。戻り値には影響しません。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : 1 つのコマンドで複数回使用可能なフラグ

MEL 例

// Create a container template using the published attribute information from
// container1.
//
containerTemplate -fromContainer container1 characterRig;
//
// Save the template to a template file in the default template location.
containerTemplate -save characterRig;
//
// Load a template (the template is located along the template search path)
containerTemplate -load characterRig;
//
// Re-load a template that has already been loaded
// This is useful if you have made edits to the template outside of maya
containerTemplate -force -load characterRig;
//
// Determine the file that a template was loaded from
containerTemplate -query -fileName characterRig;
// Result: C:/myTemplates/characterRig.template //
//
// Add a view to a container template. This view will be generated from the
// given container, and will use a group-by-node hierarchical layout.
// The view can be subesequently customized if desired.
//
containerTemplate -edit -addView "newView" -fromContainer container1 -layoutMode 1 characterRig;
containerTemplate -save characterRig;
//
// Add another view to a container template.
// This view will be generated with a default layout and can be
// subsequently customized.
//
containerTemplate -edit -addView "newView2" characterRig;
containerTemplate -save characterRig;
//
// Get the list of attributes in the template.  This will return
// a flat list of attribute names in the order in which they appear
// in the template definition.
//
containerTemplate -query -attributeList characterRig;
// Result:  attribute1 attribute2 attribute3 ...
//
// List all loaded templates
string $list[] = `containerTemplate -query -templateList`;
// List all templates matching a a given template name
// Note that all templates with matching base name (in any package) will
// be returned.
string $matches[] = `containerTemplate -query -templateList -matchName "characterRig"`;
// Result: characterRig
//