fbx-conv 项目使用教程

1. 项目目录结构及介绍

fbx-conv/
├── libs/
│   └── (包含项目依赖的库文件)
├── samples/
│   └── (包含示例文件)
├── src/
│   └── (包含项目的源代码)
├── .gitignore
├── AUTHORS
├── CC-LICENSE
├── CHANGES
├── LICENSE
├── README.md
├── generate_makefile
├── generate_vs2015.bat
├── generate_xcode
└── premake.lua

目录结构介绍

• libs/: 包含项目依赖的库文件。
• samples/: 包含示例文件，用于展示如何使用项目。
• src/: 包含项目的源代码，是项目的主要开发目录。
• .gitignore: Git 忽略文件，指定哪些文件或目录不需要被 Git 管理。
• AUTHORS: 项目作者列表。
• CC-LICENSE: 项目使用的 Creative Commons 许可证。
• CHANGES: 项目变更记录。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文件，通常包含项目的简介、安装和使用说明。
• generate_makefile: 用于生成 Makefile 的脚本。
• generate_vs2015.bat: 用于生成 Visual Studio 2015 项目的脚本。
• generate_xcode: 用于生成 Xcode 项目的脚本。
• premake.lua: Premake 配置文件，用于生成不同平台的项目文件。

2. 项目启动文件介绍

启动文件

• fbx-conv-win32.exe: Windows 平台的启动文件。
• fbx-conv-lin64: Linux 平台的启动文件。
• fbx-conv-mac: macOS 平台的启动文件。

启动命令

# Windows
fbx-conv-win32.exe [options] <input> [<output>]

# Linux
fbx-conv-lin64 [options] <input> [<output>]

# macOS
fbx-conv-mac [options] <input> [<output>]

选项/标志

• -h: 显示帮助信息。
• -o <type>: 设置输出文件类型，可选值为 FBX, G3DJ (json) 或 G3DB (binary)。
• -f: 翻转 V 纹理坐标。
• -p: 将顶点颜色打包为一个浮点数。
• -m <size>: 设置单个网格中顶点或索引的最大数量（默认值为 32k）。
• -b <size>: 设置单个节点部分中骨骼的最大数量（默认值为 12）。
• -w <size>: 设置每个顶点的骨骼权重最大数量（默认值为 4）。
• -v: 详细模式，打印额外的进度信息。

示例

fbx-conv-win32.exe -f -v myModel.fbx convertedModel.g3db

3. 项目配置文件介绍

配置文件

• premake.lua: 用于生成不同平台的项目文件，如 Visual Studio、Xcode 和 Makefile。

配置步骤

1. 安装 Premake: 确保系统中已安装 Premake。
2. 设置 FBX SDK: 下载并安装 FBX SDK 2019.0，并设置 FBX_SDK_ROOT 环境变量指向安装目录。
3. 生成项目文件: 运行 generate_vs2015.bat 或 generate_xcode 脚本生成对应的项目文件。

示例

# 设置 FBX SDK 根目录
export FBX_SDK_ROOT=/path/to/fbx/sdk

# 生成 Visual Studio 2015 项目文件
./generate_vs2015.bat

# 生成 Xcode 项目文件
./generate_xcode

通过以上步骤，您可以成功配置并启动 fbx-conv 项目，进行 FBX/Collada/Obj 文件的转换。