DirectXファイルテンプレート

Microsoft® Direct3D®保持モードによって使用されるテンプレートの一覧を次に示す。Direct3D保持モードのデータ型に精通していることが前提である。

テンプレート名:Header

UUID

<3D82AB43-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
major WORD なし
minor WORD
flags DWORD

説明

このテンプレートは、DirectXファイルフォーマットのDirect3D保持モードの使用に対してアプリケーション固有のヘッダを定義する。保持モードは、majorおよびminorフラグを使用して、保持モードファイルフォーマットの現在の主バージョンと副バージョンを指定する。

テンプレート名:Vector

UUID

<3D82AB5E-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
x FLOAT なし
y FLOAT
z FLOAT

説明

このテンプレートは、ベクトルを定義する。

テンプレート名:Coords2d

UUID

<F6F23F44-7686-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
u FLOAT なし
v FLOAT

説明

メッシュのテクスチャ座標を定義するのに使用する2次元ベクトル。

テンプレート名:Quaternion

UUID

<10DD46A3-775B-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
s FLOAT なし
v Vector

説明

現在未使用。

テンプレート名:Matrix4x4

UUID

<F6F23F45-7686-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
matrix array FLOAT 16 なし

説明

このテンプレートは、4×4行列を定義する。フレーム変換行列に使用される。

テンプレート名:ColorRGBA

UUID

<35FF44E0-6C7C-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
red FLOAT なし
green FLOAT
blue FLOAT
alpha FLOAT

説明

このテンプレートは、アルファ成分を持つカラーオブジェクトを定義する。マテリアルテンプレート定義中の面の色に使用される。

テンプレート名:ColorRGB

UUID

<D3E16E81-7835-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
red FLOAT なし
green FLOAT
blue FLOAT

説明

このテンプレートは、基本的なRGBカラーオブジェクトを定義する。

テンプレート名:Indexed Color

UUID

<1630B820-7842-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ
index DWORD
indexColor ColorRGBA

説明

このテンプレートは、インデックスパラメータとRGBAカラーで構成され、メッシュの頂点の色を定義するのに使用する。インデックスは、色を適用する対象の頂点を定義する。

テンプレート名:Boolean

UUID

<4885AE61-78E8-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
DWORD truefalse なし

説明

単純なブール型を定義する。このテンプレートは、0または1をセットする。

テンプレート名:Boolean2d

UUID

<4885AE63-78E8-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
u Boolean なし
v Boolean

説明

このテンプレートは、MeshFaceWrapsテンプレートで使用される2つのブール値のセットを定義し、個別の面のテクスチャトポロジを定義する。

テンプレート名:Material

UUID

<3D82AB4D-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
faceColor ColorRGBA Any
power FLOAT
specularColor ColorRGB
emissiveColor ColorRGB

説明

このテンプレートは、メッシュ全体またはメッシュの個別の面のどちらかに適用できる基本的なマテリアルの色を定義する。powerは、マテリアルの反射指数である。アンビエント照明の色がアルファ成分を必要とすることに注意する。

TextureFilenameは、Direct3D保持モードが使用するオプションのデータオブジェクトである。このオブジェクトが存在しない場合、面はテクスチャ化されない。

テンプレート名:TextureFilename

UUID

<A42790E1-7810-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
filename STRING なし

説明

このテンプレートは、メッシュまたは面に適用されるテクスチャのファイル名を指定することを可能にする。このテンプレートがマテリアルオブジェクト内部に現れる必要がある。

テンプレート名:MeshFace

UUID

<3D82AB5F-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nFaceVertexIndices DWORD なし
faceVertexIndices array DWORD nFaceVertexIndicies

説明

このテンプレートは、メッシュの面を定義するために、Meshテンプレートが使用する。nFaceVertexIndices配列の各要素は、面を作るのに使用されるメッシュ頂点を参照する。

テンプレート名:MeshFaceWraps

UUID

<4885AE62-78E8-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nFaceWrapValues DWORD なし
faceWrapValues Boolean2d

説明

このテンプレートは、ラップ中の各面のテクスチャトポロジを定義するのに使用する。nFaceWrapValuesメンバの値は、メッシュ内の面の数に等しくする必要がある。

テンプレート名:MeshTextureCoords

UUID

<F6F23F40-7686-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nTextureCoords DWORD なし
textureCoords array Coords2d nTextureCoords

説明

このテンプレートは、メッシュのテクスチャ座標を定義する。

テンプレート名:MeshNormals

UUID

<F6F23F43-7686-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nNormals DWORD なし
normals array Vector nNormals
nFaceNormals DWORD
faceNormals array MeshFace nFaceNormals

説明

このテンプレートは、メッシュの法線を定義する。ベクトルの先頭の配列は、それ自体が法線ベクトルであり、2番目の配列は、指定の面にどの法線を適用するかを指定するインデックスの配列である。nFaceNormalsメンバの値は、メッシュ内の面の数に等しくする必要がある。

テンプレート名:MeshVertexColors

UUID

<1630B821-7842-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nVertexColors DWORD なし
vertexColors array IndexedColor nVertexColors

説明

このテンプレートは、面ごとにまたはメッシュごとにマテリアルを適用する代わりに、メッシュの頂点の色を指定する。

テンプレート名:MeshMaterialList

UUID

<F6F23F42-7686-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nMaterials DWORD Material
nFaceIndexes DWORD
FaceIndexes array DWORD nFaceIndexes

説明

このテンプレートは、メッシュオブジェクトで使用され、どのマテリアルをどの面に適用するかを指定する。nMaterialsメンバは、存在するマテリアルの数および適用するマテリアルの数を指定する。

テンプレート名:Mesh

UUID

<3D82AB44-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nVertices DWORD Any
vertices array Vector nVertices
nFaces DWORD
faces array MeshFace nFaces

説明

このテンプレートは、単純なメッシュを定義する。1番目の配列は、頂点のリストであり、2番目の配列は、頂点配列に対するインデックスとしてメッシュの面を定義する。

オプションのデータ要素

以下のオプションのデータ要素がDirect3D保持モードによって使用される。

MeshFaceWraps 指定しない場合、デフォルトでuとvの両方がfalseに設定される。
MeshTextureCoords 指定しない場合、テクスチャ座標が存在しない。
MeshNormals 指定しない場合、法線はAPIのGenerateNormalsメソッドを使用して生成される。
MeshVertexColors 指定しない場合、デフォルトで色は白に設定される。
MeshMaterialList 指定しない場合、デフォルトでマテリアルは白に設定される。

テンプレート名:FrameTransformMatrix

UUID

<F6F23F41-7686-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
frameMatrix Matrix4x4 なし

説明

このテンプレートは、フレーム (およびその子オブジェクトすべて) に対するローカル変換を定義する。

テンプレート名:Frame

UUID

<3D82AB46-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
なし 任意

説明

このテンプレートは、フレームを定義する。現在、フレームはMesh型のオブジェクトとFrameTransformMatrixを含むことができる。

オプションのデータ要素

以下のオプションのデータ要素がDirect3D保持モードによって使用される。

FrameTransformMatrix この要素を指定しない場合、ローカル変換がフレームに適用されない。
Mesh 任意の数のメッシュオブジェクトがフレームの子になる。それらのオブジェクトは、インラインまたは参照で指定することができる。

テンプレート名:FloatKeys

UUID

<10DD46A9-775B-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
nValues DWORD なし
values array FLOAT nValues

説明

このテンプレートは、浮動小数点数の配列とその配列中の浮動小数点数の数を定義する。アニメーションキーのセットを定義するために使用する。

テンプレート名:TimedFloatKeys

UUID

<F406B180-7B3B-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
time DWORD なし
tfkeys FloatKeys

説明

このテンプレートは、浮動小数点数のセットとアニメーションで使用される正の時間を定義する。

テンプレート名:AnimationKey

UUID

<10DD46A8-775B-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
keyType DWORD なし
nKeys DWORD
keys array TimedFloatKeys nKeys

説明

このテンプレートは、アニメーションキーのセットを定義する。keyTypeメンバは、キーが回転、スケールまたは位置キー (それぞれ整数の0、1、2を使用して) のいずれかを指定する。

テンプレート名:AnimationOptions

UUID

<E2BF56C0-840F-11cf-8F52-0040333594A3>
メンバ名 オプション配列サイズ オプションデータオブジェクト
openclosed DWORD なし
positionquality DWORD

説明

このテンプレートは、Direct3D保持モードのアニメーションオプションの設定を可能にする。openclosedメンバは、クローズドアニメーションに対しては0、オープンアニメーションに対しては1にすることができる。positionqualityメンバは、指定されている任意の位置キーに対して位置の性質を設定するために使用し、スプライン位置に対しては0、線形位置に対しては1にすることができる。デフォルトでは、アニメーションはクローズである。

テンプレート名:Animation

UUID

<3D82AB4F-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
なし 任意

説明

このテンプレートは、以前のフレームを参照するアニメーションを含む。フレームに対する1つの参照と少なくてもAnimationKeysの1セットを含む必要がある。また、AnimationOptionsデータオブジェクトを含むこともできる。

オプションのデータ要素

以下のオプションのデータ要素がDirect3D保持モードによって使用される。
AnimationKey アニメーションは、AnimationKeyがないと無意味になる。
AnimationOptions この要素を指定しない場合、アニメーションはクローズである。

テンプレート名:AnimationSet

UUID

<3D82AB50-62DA-11cf-AB39-0020AF71E433>
メンバ名 オプション配列サイズ オプションデータオブジェクト
なし Animation

説明

AnimationSetテンプレートは、複数のAnimationオブジェクトを含み、Direct3D保持モードのアニメーションセットと同等である。これは、アニメーションセット内の各アニメーションの時間が任意の点で同じであることを意味する。アニメーションセットの時間を大きくすると、それが含むすべてのアニメーションに対する時間を大きくすることになる。


トップに戻る トップに戻る
© 1999 Microsoft and/or its suppliers. All rights reserved. Terms of Use.