这个工具包包含了一些对Ogre资源文件进行操作的预处理命令行工具。

这个工具包包含了一些对Ogre资源文件进行操作的预处理命令行工具。

它包括OgreXMLConveter, OgreMeshUpgrade, OgreMaterialUpgrade和MeshMagick。

您可以在这里获得其WindowsV 1.4.7 版本的下载,或者在这里获取其MacOSXV1.4.0版本的下载。以上两个版本均是 2008 年 3 月 6 日 的版本，即译者进行翻译的版本，若需要更多信息和更新的版本，可以访问Ogre官方。

.[OgreXMLConveter]

OgreXML转换器能够将 .mesh 模型网格文件 和 .skeleton 骨骼文件 由XML格式转换为二进制格式，同时可以将其二进制格式转换回XML格式。它同时也允许你在将XML格式转换为二进制格式时设置LOD层级信息。

如果你的Ogre脚本资源中原本使用的就是XML格式文件的话，那么本工具则是Ogre运行时必须的。所以你能够在OgreSource包的Tools/XMLConverter中找到它。

使用方法： OgreXMLConverter 操作选项 源文件路径 目标文件路径

有用的操作选项包括：

-i = 控制与命令行。 -l nLODNum = 指定总LOD层级 ( 该项仅在XML格式转换为Mesh格式时有效 ) -d nLODDis = 指定LOD层级间的距离增幅 ( 该项仅在XML格式转换为Mesh格式时有效 ) -p nLODPer = 指定每两级LOD层之间三角面减少百分比 ( 该项仅在XML格式转换为Mesh格式时有效 ) -f nLODNum = 指定两级LOD层之间的固定顶点减少量 ( 该项仅在XML格式转换为Mesh格式时有效 ) -e = 关闭模版阴影的edge表 ( 当使用模版阴影时该项才有效 ) -r = 关闭Ogre推荐的顶点缓冲区格式。 -t = 为法线贴图生成切线信息 ( 当使用法线贴图时该项才有效 ) -o = 关闭冗余关键桢和运动轨迹的剔除 -d3d = 优先使用D3D进行颜色格式的填充 ( 在Windows平台中默认该项开启 ) -gl = 优先使用GL进行颜色格式的填充 ( 在非Windows平台中默认该项开启 ) -E endian = 设置endian模式，可以选择big, little 或 native ( 默认为native ) -q = 轻量模式，减少输出。 -log filename = Log文件名称。（默认为OgreXMLConverter.log）

.[OgreMeshUpgrade]

这个工具能够将你的任何老版本的 .mesh 文件更新到当前版本的 .mesh 文件。

你可以在Ogre.log文件中得到.mesh文件的版本信息。一般来说，Ogre可以运行老版本的.mesh文件，但是性能上会有一些差别。如果你更新了Ogre的其他部分，你尽量应当将.mesh文件更新为同样的版本。

使用方法： OgreMeshUpgrate 操作选项 源文件路径 目标文件路径

有用的操作选项包括：

-i = 控制与命令行。 -l nLODNum = 指定总LOD层级 ( 该项仅在XML格式转换为Mesh格式时有效 ) -d nLODDis = 指定LOD层级间的距离增幅 ( 该项仅在XML格式转换为Mesh格式时有效 ) -p nLODPer = 指定每两级LOD层之间三角面减少百分比 ( 该项仅在XML格式转换为Mesh格式时有效 ) -f nLODNum = 指定两级LOD层之间的固定顶点减少量 ( 该项仅在XML格式转换为Mesh格式时有效 ) -e = 关闭模版阴影的edge表 -r = 关闭Ogre推荐的顶点缓冲区格式。 -t = 为法线贴图生成切线信息 -d3d = 转换为D3D颜色格式 -gl = 转换为GL颜色格式 -srcd3d = 老版本的mesh文件为D3D颜色格式 -srcgl = 老版本的mesh文件为GL颜色格式 -E endian = 设置endian模式，可以选择big, little 或 native ( 默认为native )

注意：

这个工具现在允许你自定义重组你的mesh网格文件的顶点格式。

如果你想更新 0.15.0 之前的任意一个版本的mesh，那么在该程序运行时会问你是否希望进行顶点格式的重组，你输入’y’就可以了。在0.15.0版本之后的mesh在更新时会允许你对该mesh做更多的操作：例如，你可以对每个独立模型节点的顶点指定不同的顶点结构，你既可以自定义顶点结构，也可以使用’automatic’自动模式。

[OgreMaterialUpgrade]

这个工具能够将你的任何老版本的 .material 材质文件更新到当前版本的 .material 材质文件。

值得注意的是这个自动更新是不会加入一些新的脚本语法功能的，这么说你可能不好理解。（例子： “scene_blend add”这句可能会被更新为”scene_blend one one”，因为”add”的底层实际上就是”scene_blend one one”，自动更新会将一些高级语法更新为比较直接底层的语法）

另外，这个工具仅对 0.13.0 版本以下的材质脚本更新有效，对0.13.0版本以后的材质脚本是没有必要进行更新的。

使用方法： OgreMaterialUpgrade 源文件路径 目标文件路径

[MeshMagick]

这个工具是对mesh文件和skeleton文件进行一些处理的工具。

大致包括以下功能： Info = 输出mesh的信息。 Meshmerge = 将多个mesh合并为一个mesh文件 rename = 重命名mesh和skeleton的不同元件 transform = 旋转，缩放一个mesh

使用方式： MeshMagick –help=工具名 可以获得更多相关信息。

. [译者笃志补充说明]

1：除MeshMagick该工具外，其他三种工具，使用方式都可以是：将源资源文件拖拽到工具的exe图标上。因为更新程序会将源文件覆盖，所以推荐做下备份后再更新。

2：您可以写批处理文件对其进行使用。格式即为上面的使用方式。

举例：新建一个文本文件test.txt

编辑内容为 OgreMeshUpgrate –d3d –l 4 –d 500 –p 30 E:/Ogre/Media/TestSrc.xml F:/Temp/TestDest.mesh

修改文本后缀名为test.bat

将该批处理文件与OgreMeshUpgrate.exe放置同一目录下，运行

则会自动将E:/Ogre/Media/TestSrc.xml文件转换为F:/Temp/TestDest.mesh文件，同时开启了4层Lod，Lod间距为500象素，每一级间面数差距为30%

3：OgreMeshUpgrate工具推荐使用automatic自动模式顶点格式，效率会比较高，并且省去不少麻烦。

4：MeshMagick工具不推荐使用。本身功能有限，而且长期无人维护，对新的mesh支持不好。