テンプレートの命名規則

Maya では、テンプレートは一意の名前で定義されます。テンプレートに関連付けられるすべての動作では、テンプレートの特定と検索の主要な手段としてテンプレート名が使用されます。テンプレート名はオブジェクト識別子であり、スペース、特殊記号、マルチバイト文字などは使用できません。

テンプレート ファイルには、次の命名規則が使用されます。

• 各テンプレートは個別の XML ファイルに格納されます。
• テンプレート名は、関連付けられるテンプレート ファイルのベース名として使用されます。
• テンプレート ファイルのファイル拡張子は .template です。たとえば、characterRig という名前のテンプレートは、characterRig.template という名前の XML ファイルに格納されます。

テンプレート検索パス

テンプレート ファイルの検索には検索パスを使用します。テンプレート検索パスには、組み込みおよびユーザ指定の両方の場所が設定されており、テンプレートのロード時に順番に検索されます。

テンプレートは主に名前でロードされます。検索パスに従って、テンプレート名に一致するテンプレート ファイルが検索されます。検索パス上に存在しないテンプレート ファイルは、絶対ファイル パスを使用してロードすることもできますが、この方法は将来的にテンプレート検索で問題が発生する可能性があるため、お勧めしません。

カレントのテンプレート検索パスを照会するには、次のコマンドを使用します。

containerTemplate -query -searchPath;

デフォルトでは、このファイル規則はカレントのワークスペースの assets サブディレクトを示します。また、このファイルの最初の場所は、他にパス指定がない場合にテンプレート ファイルが保存されるデフォルトの場所です。

任意の場所を使用して検索パスをカスタマイズするには、 テンプレート検索パスを変更するを参照してください。

関連アトリビュート

次のアトリビュートは、コンテナ ノードに格納され、関連付けられるテンプレートを定義します。

templateName

テンプレートの名前を指定します。これはテンプレートの主要な識別子です。

templatePath

（オプション）XML テンプレート ファイルの物理的な格納場所を指定します。このパスには、カレント プロジェクトの相対パスまたは絶対パスを指定できます。

注:テンプレート パスは、テンプレート検索時の補助的な情報としてのみ使用されます。テンプレート検索パスに従って検索された同じ名前のテンプレートは、他の場所で見つかった同じ名前のテンプレートよりも常に優先されます。検索パスでテンプレートが見つからなかった場合、templatePath が使用され、ファイルが検索されます。

次のコンテナ ノード アトリビュートはカレントのコンテナ ビューを定義します。

viewName

viewMode にテンプレートの使用（Use Template）が設定されている場合、コンテナのテンプレート定義は、コンテナのパブリッシュ済みインタフェースのレイアウトに使用されます。テンプレートにビューが定義されている場合は、viewName アトリビュートは使用するビューの名前に設定されます。viewName アトリビュートが空の場合は、テンプレート定義はデフォルトのビューとして機能します。

関連コマンド

すべてのテンプレートの共通操作が、アセット エディタ（Asset Editor）とアトリビュート エディタ（Attribute Editor）で使用できるため、多くの場合、コマンドライン インタフェースを使用する必要はありません。

次のコマンドは、コンテナ テンプレートとコンテナ ビューの基盤となるサポートを提供し、スクリプトによるこれらの操作へのアクセスに使用できます。

• containerTemplate: テンプレートとそのファイルに関する動作を実行します（作成、ロード、アンロード、保存、照会）。一般に、このコマンドはテンプレートとそのファイルで独立して実行されるため、特定のコンテナとの関連付けは不要です。ただし、少数の動作の場合、コンテナ ノードが指定されます（コンテナからのテンプレートの作成時やビューの追加時など）。
• containerView: コンテナ ノードのビュー関連情報にアクセスするためのインタフェースを提供します。containerView コマンドは、特定のコンテナ ノードで動作し、コンテナのビュー設定に基づいてビュー情報を返します（viewMode、templateName、viewName）。コンテナがテンプレートまたはテンプレート ビューに関連付けられていない場合は、情報はコンテナ ノードから直接取得されます。コンテナにテンプレート ビューが関連付けられている場合、レイアウトと表示の情報はテンプレートおよびビューの定義から取得されます。

これらのコマンドの詳細については、コマンド リファレンスのマニュアルを参照してください。