Ogre命令行工具包使用说明

Ogre命令行工具包使用说明

这个工具包包含了一些对Ogre资源文件进行操作的预处理命令行工具。
它包括OgreXMLConveter, OgreMeshUpgrade, OgreMaterialUpgrade和MeshMagick。
 

.[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]
Copyright 2007 by Daniel Wickert
这个工具是对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支持不好。