9.1.1.4. .mats 形式

.mats ファイル形式用の XML スキーマは、Src/Samples/Libraries/GeoEn2Support/common_mats.xsd で入手できます。

2 つのタイプのマテリアルがあります。Blinn-Phong と PBR です。一部の要素と属性は両方のタイプで共通しています。

Blinn-Phong マテリアル

<materials>

マテリアルは、以下の属性を持つ単一の <materials> 要素に格納する必要があります。<Materials> 要素には、個別のマテリアルの ID/GUID および動作を記述するいくつかの <material> 要素を含むことができます。

属性	使用	説明	値
`version`	必須	.mats ファイル形式のバージョンです。	Integer

<material>

<material> 要素は、マテリアル ID/GUID を割り当て、個別のマテリアルの動作を記述するために使用されます。<Materials> 要素に <material> 要素がいくつか存在する場合があります。

<diffuse>

<diffuse> 要素は、拡散チャネルを単一のカラーまたはテクスチャとして指定するために使用されます。

属性	使用	説明	値
`colour`	オプション	拡散チャネルのカラーを指定します。	string (RGBA) としての 4 要素ベクトル
`scale`	オプション	拡散チャネルに適用するスケールです。	Float
`uvScale`	オプション	拡散テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	拡散テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<diffuse> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含めることができます。

<opacity>

<opacity> 要素は、不透明度チャネルを単一のカラーまたはテクスチャとして指定するために使用されます。

属性	使用	説明	値
`colour`	オプション	不透明度チャネルのカラーを指定します。	string (RGBA) としての 4 要素ベクトル
`scale`	オプション	不透明度チャネルに適用するスケールです。	Float
`uvScale`	オプション	不透明度テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	不透明度テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<specular>

<specular> 要素は、スペキュラーチャネルを単一のカラーまたはテクスチャとして、強度とともに指定するために使用されます。

属性	使用	説明	値
`colour`	オプション	不透明度チャネルのカラーを指定します。	string (RGBA) としての 4 要素ベクトル
`scale`	オプション	不透明度チャネルに適用するスケールです。	Float
`power`	必須	スペキュラーチャネルに適用する強さです。	Float
`uvScale`	オプション	スペキュラーテクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	スペキュラーテクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<specular> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含むことができます。

PBR マテリアル

<pbrMaterials>

マテリアルは、以下の属性を持つ単一の <pbrMaterials> 要素に格納する必要があります。<pbrMaterials> 要素には、個別のマテリアルの ID/GUID および動作を記述するいくつかの <pbrMaterial> 要素を含むことができます。

属性	使用	説明	値
`version`	必須	`.mats` ファイル形式のバージョンです。	Integer

<pbrMaterial>

<pbrMaterial> 要素は、マテリアル ID/GUID を割り当て、個別のマテリアルの動作を記述するために使用されます。<pbrMaterial> 要素に <pbrMaterials> 要素がいくつか存在する場合があります。

<baseColour>

<baseColour> 要素は、baseColour チャネルを単一のカラーまたはテクスチャとして指定するために使用されます。

属性	使用	説明	値
`colour`	オプション	baseColour チャネルのカラーを指定します。	string (RGBA) としての 4 要素ベクトル
`scale`	オプション	baseColour チャネルに適用するスケールです。	Float
`uvScale`	オプション	baseColour テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	baseColour テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<baseColour> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含むことができます。

<metallic>

<metallic> 要素は、metallic チャネルを単一のカラーまたはテクスチャとして指定するために使用されます。

属性	使用	説明	値
`scale`	オプション	metallic チャネルに適用するスケールです。	Float
`uvScale`	オプション	metallic テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	metallic テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<metallic> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含む必要があります。

<roughness>

<roughness> 要素は、roughness チャネルを単一のチャネルテクスチャとして指定するために使用されます。

属性	使用	説明	値
`scale`	オプション	roughness チャネルに適用するスケールです。	Float
`uvScale`	オプション	roughness テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	roughness テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<roughness> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含む必要があります。

<ao>

<ao> 要素は、ao チャネルを単一のチャネルテクスチャとして指定するために使用されます。

属性	使用	説明	値
`diffuseScale`	オプション	間接拡散ライティングに適用されるとき ao チャネルに適用するスケールです。	Float
`specularScale`	オプション	間接スペキュラーライティングに適用されるときに ao チャネルに適用するスケールです。	Float
`uvScale`	オプション	ao テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	ao テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<ao> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含む必要があります。

<cavity>

<cavity> 要素は、cavity チャネルを単一のチャネルテクスチャとして指定するために使用されます。

属性	使用	説明	値
`scale`	オプション	cavity チャネルに適用するスケールです。	Float
`uvScale`	オプション	cavity テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	cavity テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の `uvScale` の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<cavity> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含む必要があります。

共通

以下に記載された属性と子要素は、<material> および <pbrMaterial> 要素で共通しています。

属性	使用	説明	値
`id`	必須	このマテリアルの識別子です。	String
`guid`	オプション	このマテリアルの GUID です。	GUID string
`backfaceBehaviourType`	オプション	このマテリアルのバックフェースに光線があたったときの動作のタイプです。	String: invalid black transparent doubleSided
`shadowfaceBehaviourType`	オプション	直接ライティングの影を落とす三角のフェースを定義します。プリコンピュートされたディレクショナル可視性およびベイクで使用されます。プリコンピュートは `bothWithInvalidBack` を back として扱うことに注意してください。	String: front back both bothWithInvalidBack
`indirectTransparency`	オプション	マテリアルを通過する入射光線の割合です。	正の float (デフォルト `0.0`)
`indirectReflectivity`	オプション	マテリアルに反射される入射光線の割合です。	正の float (デフォルト `1.0`)
`isEmissive`	オプション	`true` に設定すると、エミッシブマテリアルに適した特別な処理を有効にします。	Boolean (デフォルト `false`)

<normal>

<normal> 要素は、normal チャネルを単一のカラーまたはテクスチャとして指定するために使用されます。

属性	使用	説明	値
`scale`	オプション	normal チャネルに適用するスケールです。	Float
`useForBaking`	オプション	ベイクの際に normal チャネルを使用するかどうかです。	Boolean
`uvScale`	オプション	normal テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	normal テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の uvScale の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<notmal> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含む必要があります。

<emissive>

<emissive> 要素は、emissive チャネルを単一のカラーまたはテクスチャとして指定するために使用されます。

属性	使用	説明	値
`colour`	オプション	emissive チャネルのカラーを指定します。	string (RGBA) としての 4 要素ベクトル
`scale`	オプション	emissive チャネルに適用するスケールです。	Float
`uvScale`	オプション	emissive テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	emissive テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の uvScale の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<emissive> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含むことができます。

<transparency>

<transparency> 要素は、transparency チャネルを単一のカラーまたはテクスチャとして指定するために使用されます。

属性	使用	説明	値
`colour`	オプション	transparency チャネルのカラーを指定します。	string (RGBA) としての 4 要素ベクトル
`scale`	オプション	transparency チャネルに適用するスケールです。	Float
`uvScale`	オプション	transparency テクスチャでの検索前にメッシュの UV に適用するスケールです。	string (XY スケール) としての 2 要素ベクトル
`uvOffset`	オプション	transparency テクスチャでの検索前にメッシュの UV に適用するオフセットです (上記の uvScale の後に適用されます)。	string (XY スケール) としての 2 要素ベクトル

<transparency> 要素には、使用するテクスチャのファイル名を含む <texture> 子要素を含むことができます。