NavGenLauncher
NavGenLauncher 工具是一个单机版的命令行工具,用于在游戏中生成表示地形的 NavData。每当您使用 Navigation Lab 生成 NavData
时,就会透明地调用该工具。如果需要一个可编写脚本的命令行工具在生产管线中生成 NavData,您还可以直接使用 NavGenLauncher 工具。
输入文件
NavGenLauncher 工具接受将 .navgenproj 文件作为输入。此文件包含一个或多个 .obj 文件的列表,这些文件中包含地形几何体、NavData 生成过程的一组配置参数和其他信息,例如种子点、NavTag 体积等。
您可以按以下方式生成 .navgenproj 文件:
- 当使用单机版 Navigation Lab 工具生成地形的 NavData 时,有关生成的信息将保存在 .navgenproj 文件中。
- 以编程方式使用 NavGenProj 库中提供的工具类生成。有关详细信息,请参见 NavGenProj 库及其主 NavGenProj 类。
- 以编程方式从自己的应用程序生成,或手动生成。尽管 .navgenproj 文件的预期格式没有正式记录,但它是一个简单的人类可读 XML。
例如,您可以作为模板来创建自己的配置文件的 .navgenproj 文件便是 Navigation Lab 生成的 .navgenproj 文件之一。也可以通过调用带有 -t 命令行选项的 NavGenLauncher 来生成一个包含默认参数值的空白模板。
有了模板之后,即可在 XML 结构中的元素与 NavData 生成系统及 Navigation Lab 提供的配置选项之间直接进行映射。如果您在了解结构或元素时需要帮助,请联系
Autodesk® 支持。
输出目录
您可以向 NavGenLauncher 工具提供绝对基输出目录和该目录中的相对路径作为命令行参数。
- 如果您同时提供这两个参数,则输出目录为绝对基路径后跟相对路径。
- 如果您仅提供绝对路径这一个参数,则相对路径将视为空,并在基输出目录中生成输出数据。
- 如果您仅提供相对路径这一个参数,则输出目录为输入 .navGenProj 文件的位置后跟相对路径。
- 如果未提供任何输出目录,将根据输入 .navGenProj 文件中包含的值生成来输出数据。
启动 NavGenLauncher 工具
NavGenLauncher 工具的预编译可执行文件 NavGenLauncher.exe 可以在 NavData 生成系统支持的所有平台上的 bin 目录中找到。
注意:NavGenLauncher.exe 需要有效的 Gameware 许可证密钥。有关详细信息,请参见
许可。
在 Mac OS X 上访问 TBB
NavGenLauncher 工具需要访问 Intel 的 TBB(线程构建块)DLL 以进行并行处理。
- 在 Mac OS X 平台上,将目录 3rd\tbb<version>_<date>oss\lib\mac 添加到环境变量 DYLD_LIBRARY_PATH。
语法
navgenlauncher.exe input.navgenproj [absoluteBaseOutputDirectory] [relativeOutputDirectory]
选项
有关输出目录参数解释的详细信息,请参见上文。
示例
NavGenLauncher.exe "C:\levels\projects\level1.navgenproj"
NavGenLauncher.exe "C:\levels\projects\level1.navgenproj" "C:\MyGameData" "level1"
有关其他示例,请参见 tools\NavGenLauncher\examples 中提供的 .bat 文件。