アセット テンプレートのパーツ

関連項目

• アセット テンプレート
• アセット テンプレートを作成する

主要要素

テンプレートの本文は、単一の <template> 要素によって定義されています。テンプレート定義内の一連の <attribute> プロパティは、アセットのパブリッシュ済みアトリビュート インタフェースを表します。

次の表は、テンプレート ファイルの主要要素を説明したものです。

.../templatePackages/pkg1/template1.template
.../templatePackages/pkg1/template2.template
.../templatePackages/pkg2/template3.template
.../templatePackages/pkg2/template4.template

<templates package=pkg1></templates>

<templates><using package='pkg1'>....</templates>

テンプレート要素

次の表は、テンプレート ファイルのテンプレート定義内で使用できる要素を説明しています。

アトリビュート要素

各パブリッシュ済みアトリビュートは、アトリビュート要素によって記述します。次の表は、アトリビュート定義内で使用できる要素を説明しています。

サンプル コード

<attribute name='attribute1' type='maya.float3'>
<label>Display Name</label>
<description>Your description here.</description>
</attribute>

ビュー要素

テンプレートには、複数のビューを関連付けることができます。ビューはアセットの特定の表示レイアウトを表し、インタフェースを用途に応じて調整することができます(各ユーザまたはワークフロー用のインタフェース調整など)。

ビューは、<view> 要素を使用して定義します。ビューのアトリビュートは、<property> 要素を使用して、テンプレートから参照されます。アトリビュートは、<group> 要素を使用してグループ化できます。ビュー固有のオーバーライドを特定のテンプレート情報に供給することもできます。特に、インタフェースに表示されるアトリビュートのラベルと説明のテキストを必要に応じてビュー単位でカスタマイズできます。

ビュー要素は、テンプレートの内容に合わせてカスタマイズしたユーザ インタフェース レイアウトを定義します。ビューがアクティブの場合は、ビュー定義に含まれるアトリビュート プロパティのみがユーザ インタフェースに表示され、その他のテンプレート アトリビュートは表示されません。ビューのプロパティはグループに編成することができます。

一部の情報(ラベル、説明)は、テンプレートとビューの両方で使用することができます。ビュー固有の定義を使用した場合、テンプレートレベルの情報よりも優先されます。

サンプル コード

<view name='ShadingArtist' template='fountain'>
	<label>Shading Artist</label>
	<description>This view is for the shading team. 	</description>
	<group name='Water_Shader'>
		<property name='water_diffuse'/>
		<property name='water_color'/>
	</group>
</view>

グループ要素

ビューには、グループ要素を含めることができます。Maya の各ウィンドウとエディタのアトリビュートはグループに編成されています。たとえば、アトリビュート エディタ(Attribute Editor)とアセット エディタ(Asset Editor)では、グループは折り畳み可能なレイアウトの作成に便利です。グループの使用はサポートされていない場合もあり(チャネル ボックス(Channel Box)内など)、その場合は、ビューのプロパティが一覧表示されます。

次の表は、グループ定義内で使用できるすべての要素を説明しています。

サンプル コード

<group name='Brick_Shader'>
	<label>Brick Shading Properties</label>
	<description>Control main brick shader.<description>
	<property name='brick_diffuse'/>
	<property name='brick_color'/>
	<property name='brick_transparency'>
</group>

プロパティ要素

次の表は、プロパティ定義内で使用できる要素を説明しています。

サンプル コード

<property name=’brick_glowIntensity’>
	<label>Brick Glow Intensity<label>
	<description>Controls glow intensity of brick shader.<description>
</property>

要素のローカライズ: インタフェースのラベルと説明

テンプレート ファイルの大部分のテキスト値は、オブジェクト識別子または類似の値であり、スペースや他の特殊文字は使用できません。この例外として、<label> と <description> タグがあります。これらのタグはさまざまな要素で使用して、ユーザ インタフェースの表示専用のラベルと注釈テキストを設定できます。これらのフィールドのデータ値は、ローカライズされたデータ(UTF-8)、スペース、特殊文字、句読点をサポートします。

インタフェース情報のフィールド(<label> と <description>)は、テンプレートとビューの両方で使用できます。ビュー固有の定義を使用した場合、テンプレートの定義よりも優先されます。たとえば、テンプレートでアトリビュートにラベルを定義し、ビューでは別のラベルを定義すると、ビューのラベルが優先されます。

<label> と <description> 要素は、ユーザ インタフェースの表示専用の文字列を定義し、XML フォーマットの多くの要素で使用されます。これらの値は表示専用なので、オブジェクト名のフィールドでは使用できないスペースやその他の特殊文字を使用できます。テンプレート インタフェースを他の言語にローカライズすることもできます。XML ファイルで定義されるすべてのテキスト値は、UTF-8 に変換されます。

アセット ユーザ インタフェースのローカライズも参照してください。

バインド セット要素

テンプレートには、1 つまたは複数のバインド セットを関連付けることができます。バインド セットは、ノード アトリビュート(条件)にマッピングされた、パブリッシュ済みの名前(バインド プロパティ)のマッピングです。このマッピングは、自動バインド(Autobind)機能で使用され、テンプレートを利用するアセットでアトリビュートをすばやくパブリッシュ、バインドします。

関連項目

• テンプレート バインド セット
• バインド セットを作成する
• テンプレート バインド セットをカスタマイズする