1、X 文件的使用（完整） 有很多朋友也许想更加了解 X 文件，正好，本文将全面的介绍 X 文件的使用。我想这是一篇纯技术性的文档，我就不加以诗篇歌颂润色了。相信读我的文章，就像啃牙签；）好了，我们板起面孔。首先给你一个完整的印象-传说中的 X 文件：xof 0302txt 0032 template Header DWORD major;DWORD minor;DWORD flags;template Frame FrameTransformMatrixMeshHeader 1;0;1;Frame Scene_Root FrameTransformMatrix 1.000000, 0.00000
2、0, 0.000000, 0.000000,0.000000, 1.000000, 0.000000, 0.000000,0.000000, 0.000000, 1.000000, 0.000000,0.000000, 0.000000, 0.000000, 1.000000;Frame Pyramid_Frame FrameTransformMatrix 1.000000, 0.000000, 0.000000, 0.000000,0.000000, 1.000000, 0.000000, 0.000000,0.000000, 0.000000, 1.000000, 0.000000,0.0
3、00000, 0.000000, 0.000000, 1.000000;Mesh PyramidMesh 5;0.00000;10.00000;0.00000;,-10.00000;0.00000;10.00000;,10.00000;0.00000;10.00000;,-10.00000;0.00000;-10.00000;,10.00000;0.00000;-10.00000;6;3;0,1,2;,3;0,2,3;,3;0,3,4;,3;0,4,1;,3;2,1,4;,3;2,4,3;MeshMaterialList 1;6;0,0,0,0,0,0;Material Material0 1
4、.000000; 1.000000; 1.000000; 1.000000;0.000000; 0.050000; 0.050000; 0.050000;0.000000; 0.000000; 0.000000;xof 0302txt 0032xof 表示这是一个真正的 X 文件。0302txt 表示通知程序使用 Directx 的 X 文件，版本为 3.2 的模版，其中 txt 表示此文件为文本文件，可读，并非是一个 2 进制文件。0032 表示一个浮点数的位数为 32，如果想要用 64 位的浮点数，可以写成 0064。下面将分别介绍各个主题。声明一个模版：假设声明 template Con
5、tactEntry 首先需要用 guidgen.exe 产生一个 GUID。产生的 GUID 如下：/ 4C9D055B-C64D-4bfe-A7D9-981F507E45FFDEFINE_GUID(,0x4c9d055b, 0xc64d, 0x4bfe, 0xa7, 0xd9, 0x98, 0x1f, 0x50, 0x7e, 0x45, 0xff);之后需要在程序代码中加入：#include “initguid.h“/ At beginning of source code file - add DEFINE_GUIDsDEFINE_GUID(ContactEntry, 0x4c9d055b
6、, 0xc64d, 0x4bfe, 0xa7, 0xd9, 0x98, 0x1f, 0x50, 0x7e, 0x45, 0xff);还要在 X 文件中加入：template ContactEntry 声明模版用到的数据类型：关键字 描述WORD 16-bit value (short)DWORD 32-bit value (32-bit int or long)FLOAT IEEE float value (float)DOUBLE 64-bit floating-point value (double)CHAR 8-bit signed value (signed char)UCHAR 8-
7、bit unsigned value (unsigned char)BYTE 8-bit unsigned value (unsigned char)STRING A NULL-terminated string (char)array Signifies an array of following data type to follow ()举例：DWORD value; array STRING Text20;/定义一个名为 Text 的数组，类型为 STRING，大小为 20。DWORD ArraySize; array STRING NamesArraySize; /可以将大小设置为变
8、量。声明一个 ContactEntry 模版：template ContactEntry STRING Name; / The contacts nameSTRING PhoneNumber; / The contacts phone numberDWORD Age; / The contacts age实例化一个模版对象：ContactEntry JimsEntry “Jim Adams“;“(800) 555-1212“;30;JimsEntry 可以用这样的形式引用一个数据对象。例如，在一个 animation sequence template 中引用一个 Frame data obj
9、ect 做为其内嵌数据对象。也可以利用引用表示一个数据对象的副本，没有必要重复书写这个数据对象。内嵌数据对象和模版约束：template ClosedTemplate DWORD ClosedData;template OpenTemplate DWORD OpenData;.template RestrictedTemplate DWORD RestrictedData;ClosedTemplateOpenTemplateClosedTemplate 是标准的模版声明。OpenTemplate 中包含一个.，表示这是一个开放模版。开放模版允许在中内嵌任何数据对象。例如，你可以实例化 Open
10、Template，在里面定义一个 OpenData 变量和内嵌一个ClosedTemplate 的实例。RestrictedTemplate 为约束模版。约束模版实例化时只允许包含它列出的数据对象，如，不能在RestrictedTemplate 包含ClosedTemplate，OpenTemplate以外的数据对象。用 DirectX .X Standard Templates 工作：X 文件广泛用于包含一个 mesh 信息。一个 Standard Templates 包含了过多的信息。Table 3.2: DirectX .X Standard TemplatesTemplate Name
11、 DescriptionAnimation: Defines animation data for a single frame.AnimationKey: Defines a single key frame for the parent animation template.AnimationOptions: Contains animation playback information.AnimationSet: Contains a collection of animation templates.Boolean: Holds a Boolean value.Boolean2d: H
12、olds two Boolean values.ColorRGB: Contains red, green, and blue color values.ColorRGBA: Contains red, green, blue, and alpha color values.Coords2d: Defines two coordinate values.FloatKeys: Contains an array of floating-point values.FrameTransformMatrix: Holds the transformation matrix for a parent F
13、rame template.Frame: A frame-of-reference template that defines a hierarchy.Header: The .X file header that contains version numbers.IndexedColor: Contains an indexed color value.Material: Contains material color values.Matrix4x4: Holds a 4x4 homogenous matrix container.Mesh: Contains a single meshs
14、 data.MeshFace: Holds a meshs face data.MeshFaceWraps: Contains the texture wrapping for mesh faces.MeshMaterialList: Contains the material for face-mapping values.MeshNormals: Holds normals used for mesh data.MeshTextureCoords: Holds texture coordinates used for mesh data.MeshVertexColors: Holds ve
15、rtex color information used for mesh vertices.Patch: Defines a control patch.PatchMesh: Contains a patch mesh (much like the Mesh template).Quaternion: Holds a quaternion value.SkinWeights: Contains an array of weight values mapped to a meshs vertices. Used in skinned meshes.TextureFilename: Contain
16、s the texture file name to use for a material.TimedFloatKeys: Contains an array of FloatKeys templates.Vector: Holds a 3D coordinate value.VertexDuplicationIndices: Informs you which vertices are duplicates of other vertices.XSkinMeshHeader: Used by skinned meshes to define the number of bones conta
17、ined in a mesh.在 rmxfguid.h 中定义了各个模版的宏,例如:/* 3D82AB44-62DA-11cf-AB39-0020AF71E433 */DEFINE_GUID(TID_D3DRMMesh,0x3d82ab44, 0x62da, 0x11cf, 0xab, 0x39, 0x0, 0x20, 0xaf, 0x71, 0xe4, 0x33);每个模版名加上前缀 TID_D3DRM 就是宏定义名。访问.X 文件：访问任何 X 文件首先要调用DirectXFileCreate 函数创建一个 IDirectXFile 接口。IDirectXFile *pDXFile = N
18、ULL;HRESULT Result = DirectXFileCreate(/用 / pvData 缓存的字节数。可以如下定义一个模版数据的缓存：char *Templates = “xof 0303txt 0032 /标准 X 文件头。template CustomTemplate DWORD Length; array DWORD valuesLength; “;之后在用 RegisterTemplates 将其注册：pFile-RegisterTemplates(Templates, strlen(Templates);注册标准模版：首先需要在代码中包含 rmxfguid.h 和 rm
19、xftmpl.h。rmxfguid.h 定义了各个标准模版的 GUDI，rmxftmpl.h 以2 进制数据形式定义了标准模版数据的缓存和其字节数。然后调用RegisterTemplates 将其注册：pFile-RegisterTemplates(D3DRM_XTEMPLATES, D3DRM_XTEMPLATE_BYTES);打开 X 文件：创建完 IDirectXFile 接口，注册模版之后需要打开 X 文件，枚举其数据对象。调用IDirectXfile:CreateEnumObject 函数。HRESULT IDirectXfile:CreateEnumObject(LPVOID pv
20、Source, / .X filenameDXFILELOADOPTIONS dwLoadOptions, / Load optionsLPDIRECTXFILEENUMOBJECT* ppEnumObj); / Enum interface当调用 CreateEnumObject 函数，用 pvSource 指定一个文件的名字，用ppEnumObj 返回一个枚举对象接口指针。用 dwLoadOptions 指定 load 操作方式。当指定 DXFILELOAD_FROMFILE 值，告诉 DirectX 从磁盘载入一个文件。还有 DXFILELOAD_FROMRESOURCE，DXFILEL
21、OAD_FROMMEMORY 和DXFILELOAD_FROMURL 分别表示从一个资源，内存缓冲和 Internet 上加载 X 文件。当从 Internet 加载文件时，需要为其指定完整的网址。下面代码从磁盘加载 X 文件：/ Filename = filename to load (“test.x“ for example)IDirectXFileEnumObject *pEnum;pFile-CreateEnumObject(LPVOID)Filename, DXFILELOAD_FROMFILE, Filename 指向一个有效的文件名，pEnum 返回一个枚举对象接口指针。枚举数据
22、对象：注册完模版，打开 X 文件并且得到一个枚举对象接口，下面需要从 X 文件读出数据。枚举对象接口指针指向文件的第一个数据对象，因为每一个数据对象可能包含内嵌数据对象或者引用的数据对象，所以与第一个数据对象同在一层级的其它数据对象为同层级数据对象。至于包含的子数据对象的类型，需要对其分别的行进询问。可以用 HRESULT IDirectXFileEnumObject:GetNextDataObject(LPDIRECTXFILEDATA*ppDataObj)得到一个 IDirectXFileData 接口。它只有一个参数，如下：IDirectXFileData *pData;HRESULT
23、hr = pEnum-GetNextDataObject(利用此函数，可以不断地访问同一层级的数据对象接口，具体代码如下：while(SUCCEEDED(pEnum-GetNextDataObject(/释放接口。当返回值为 FAILED，表示已经访问完所有的接口。当访问值为 SUCCEEDED，你需要继续判断这个数据对象是否包含子对象。利用接口 IDirectXFileObject，和 HRESULT IDirectXFileData:GetNextObject( LPDIRECTXFILEOBJECT* ppChildObj)函数，代码如下：IDirectXFileObject *pObj
24、ect;while(SUCCEEDED(pData-GetNextObject(/ 释放接口。接下来询问接口，看其是否为内嵌数据对象：IDirectXFileData *pSubData;if(SUCCEEDED(pObject-QueryInterface( IID_IDirectXFileData, (void*)/释放接口。看其是否为引用数据对象：IDirectXFileDataReference *pRef;IDirectXFileData *pSubData;if(SUCCEEDED(pSubObj-QueryInterface( IID_IDirectXFileDataRefere
25、nce, (void*)/这里可以对 pData 数据对象进行操作。pRef-Release();pSubData-Release();/释放接口。现在整理下思路：大体的思路其实很简单，首先枚举最顶层的数据对象，然后判断其是否有子对象，这个子对象可能是内嵌对象或者引用对象二者之一，分别询问其接口，就可以判断出具体的类型。下面是完整的 Parse 模版的函数：BOOL Parse(char *Filename)IDirectXFile *pFile = NULL;IDirectXFileEnumObject *pEnum = NULL;IDirectXFileData *pData = NULL
26、;if(FAILED(DirectXFileCreate(/注册标准模版。if(FAILED(pFile-RegisterTemplates( (LPVOID)D3DRM_XTEMPLATES, D3DRM_XTEMPLATE_BYTES)return FALSE;/创建一个枚举对象接口。if(FAILED(pDXFile-CreateEnumObject(LPVOID)Filename, DXFILELOAD_FROMFILE, return FALSE;/ 遍历所有的顶层数据对象。while(SUCCEEDED(pEnum-GetNextDataObject(pData-Release()
27、;pEnum-Release();pFile-Release();return TRUE;这个函数的主要部分在 ParseObject(pData)，它负责解析子数据对象：void ParseObject(IDirectXFileData *pData)IDirectXFileObject *pObject = NULL;IDirectXFileData *pSubData = NULL;IDirectXFileDataReference *pRef = NULL;while(SUCCEEDED(pData-GetNextObject(ParseObject(pSubData);pSubDat
28、a-Release();pRef-Release();if(SUCCEEDED(pObject-QueryInterface( IID_IDirectXFileData, (void*)pSubData-Release();pObject-Release(); 这是个第归函数，调用函数自身。判断子对象的类别，对其继续解析，直到返回值为 FAILED，表示已没有子对象。从上面可以看出，这个函数除了枚举所有的对象，并没有做任何事情，下面就要从这些数据对象检索数据。从数据对象检索数据：/当你用 IDirectXFileData 接口指针指向一个有效的数据对象，可以调用IDirectXFileData
29、:GetName 函数得到该数据对象的名字。函数原型为：HRESULT IDirectXFileData:GetName(LPSTR pstrNameBuf, / 名字缓冲LPDWORD pdwBufLen); / 名字缓冲的大小可以这样使用这个函数：DWORD Size;pData-GetName(NULL, char *Name = new charSize;pData-GetName(Name, 首先声明一个 DWORD Size 变量，调用 GetName 函数时将第一个参数设为NULL，在 Size 返回名字缓冲的大小。之后利用这个 Size 值创建存放名字的缓冲，再调用 GetNa
30、me 在 Name 中返回数据对象的名字。得到了数据对象的名字，你需要得到这个数据对象的模版 GUID，去判断这个数据对象是否为你想使用的那个模版的数据对象。利用IDirectXFileData:GetType 函数，其原型为：HRESULT IDirectXFileData:GetType(const GUID * ppguid);可以这样使用这个函数：const GUID *TemplateGUID = NULL;pData-GetType(/在 TemplateGUID 中返回该数据对象对应模版的 GUID。现在去匹配这个 GUID，看它是否为你想使用的模版的数据对象。if(*TemplateGUID = TID_D3DRMMeshNormals) / 如果匹配成功，这里可以继续处理这个模版的数据对象。
