AssetImporter
加载开放资源导入库支持的各种三维格式(http://assimp.sourceforge.net/)并保存Urho3D模型、动画、材质和场景文件。有关支持的格式列表,请参阅http://assimp.sourceforge.net/main_features_formats.html.
Blender的另一种导出路径是使用Urho3D插件(https://github.com/reattiva/Urho3D-Blender).
用法:
AssetImporter <command> <input file> <output file> [options]
Commands:
model Output a model
anim Output animation(s)
scene Output a scene
node Output a node and its children (prefab)
dump Dump scene node structure. No output file is generated
lod Combine several Urho3D models as LOD levels of the output model
Syntax: lod <dist0> <mdl0> <dist1 <mdl1> ... <output file>
Options:
-b Save scene in binary format, default format is XML
-j Save scene in JSON format, default format is XML
-h Generate hard instead of smooth normals if input has no normals
-i Use local ID's for scene nodes
-l Output a material list file for models
-na Do not output animations
-nm Do not output materials
-nt Do not output material textures
-nc Do not use material diffuse color value, instead output white
-nh Do not save full node hierarchy (scene mode only)
-ns Do not create subdirectories for resources
-nz Do not create a zone and a directional light (scene mode only)
-nf Do not fix infacing normals
-ne Do not save empty nodes (scene mode only)
-mb <x> Maximum number of bones per submesh. Default 64
-p <path> Set path for scene resources. Default is output file path
-r <name> Use the named scene node as root node
-f <freq> Animation tick frequency to use if unspecified. Default 4800
-o Optimize redundant submeshes. Loses scene hierarchy and animations
-s <filter> Include non-skinning bones in the model's skeleton. Can be given a
case-insensitive semicolon separated filter list. Bone is included
if its name contains any of the filters. Prefix filter with minus
sign to use as an exclude. For example -s "Bip01;-Dummy;-Helper"
-t Generate tangents
-v Enable verbose Assimp library logging
-eao Interpret material emissive texture as ambient occlusion
-cm Check and do not overwrite if material exists
-ct Check and do not overwrite if texture exists
-ctn Check and do not overwrite if texture has newer timestamp
-am Export all meshes even if identical (scene mode only)
-bp Move bones to bind pose before saving model
-split <start> <end> (animation model only)
Split animation, will only import from start frame to end frame
-np Do not suppress $fbx pivot nodes (FBX files only)
材质列表是一个文本文件,每行一个材质,保存在Urho3D模型旁边。场景编辑器使用它在为StaticModel、StaticModelGroup、AnimatedModel或Skybox组件设置新模型时自动应用导入的默认材质,也可以通过调用ApplyMaterialList()手动调用。如果不需要,可以安全地删除列表文件。
在模型或场景模式下,AssetImport实用程序还将自动将非骨架节点动画保存到输出文件目录中。
OgreImporter
加载OGRE.mesh.xml和.skeleton.xml文件,并将它们保存为Urho3D.mdl(模型)和.ani(动画)文件。有关其他3D格式和整个场景导入,请参见AssetImport。然而,该工具不能像这样完整地处理OGRE格式。
用法:
OgreImporter <input file> <output file> [options]
Options:
-l Output a material list file
-na Do not output animations
-nm Do not output morphs
-r Output only rotations from animations
-s Split each submesh into own vertex buffer
-t Generate tangents
-mb <x> Maximum number of bones per submesh, default 64
注意:在不同的模型中使用动画时,仅输出骨骼旋转可能会有所帮助,但如果已使用骨骼位置更改来实现效果,则动画可能会变得不那么生动。由于Urho3D没有专门尝试重新定位动画,因此在原本不适合的模型中使用动画可能会导致无法预测的残缺。
PackageTool
递归检查目录中的文件和子目录,并创建PackageFile。可以将包文件添加到ResourceCache中,并将其用作文件系统(只读)中的文件。可以选择使用LZ4压缩库压缩文件数据。
在Android上使用程序包文件时要小心,因为.apk本身已经是一个程序包,由于已经使用了压缩,任意查找可能会执行得很差。从实验上看,在Android上,压缩包可能是有利的,因为在这种情况下,.apk包可能会跳过自己的压缩,从而获得更好的搜索和读取性能。
包装:
PackageTool -p<options> <input directory name> <output package name> [base path]
Options:
q - enable quiet mode
c - enable LZ4 compression
Base path is an optional prefix that will be added to the file entries.
当PackageTool运行时,它将进入源目录,然后查找子目录和任何文件。默认情况下,包内的路径将相对于源目录,但如果需要额外的路径前缀,则可以通过可选的基本路径参数指定。
例如,这会将Urho3D Data目录中的所有资源文件转换为名为Data.pak的包(从bin目录执行命令)
PackageTool -pcq Data Data.pak"
-c选项启用文件上的LZ4压缩。q选项允许在不向标准输出流发送输出的情况下执行操作。
开箱:
PackageTool -u<options> <input package name> <output directory name>
Options:
q - enable quiet mode
例如
PackageTool -uq CoreData.pak CoreData
打印信息:
PackageTool -<mode> <package name>
Modes:
i - print package file information
l - print file names (including their paths) contained in the package
L - similar to l but also output compression ratio (compressed package file only)
例如:
PackageTool -i CoreData.pak
RampGenerator
创建用于灯光衰减和聚光灯光斑形状的1D和2D渐变纹理。或者从.ies输入文件烘焙图像。 hōng bèi
用法:
RampGenerator <output file> <width> <power> [dimensions]
RampGenerator <input file> <output png file> <width> [dimensions]
输出以PNG格式保存。功率参数被输入到pow()函数以确定斜坡形状;值越高,边缘处的亮度越高,褪色越突然。
SpritePacker
获取一系列图像并将其打包到单个纹理中,然后创建一个sprite sheet xml文件。
用法:
SpritePacker -options <input file> <input file> <output png file>
Options:
-h Shows this help message.
-px Adds x pixels of padding per image to width.
-py Adds y pixels of padding per image to height.
-ox Adds x pixels to the horizontal position per image.
-oy Adds y pixels to the horizontal position per image.
-frameHeight Sets a fixed height for image and centers within frame.
-frameWidth Sets a fixed width for image and centers within frame.
-trim Trims excess transparent space from individual images offsets by frame size.
-xml 'path' Generates an SpriteSheet xml file at path.
-debug Draws allocation boxes on sprite.
脚本编译器
将AngelScript文件编译为二进制字节码,以加快加载速度。还可以以Doxygen格式转储脚本API。
用法
ScriptCompiler <input file> [resource path for includes]
ScriptCompiler -dumpapi <Doxygen output file> [C header output file]
输出文件以.asc(编译的AngelScript.)扩展名保存。二进制文件不会自动加载,而不是文本格式(.as)脚本文件,而是对象中的资源请求和资源引用需要指向编译的文件。在应用程序的最终构建中,简单地用编译的脚本替换文本格式的脚本文件可能很方便。
脚本API转储模式可用于替换“Docs”目录中的“ScriptAPI.dox”文件。如果未提供输出文件名,则脚本API将被转储到标准输出(控制台)。