Assimp 开放资产导入库

Assimp 是什么

Assimp（Open Asset Import Library）是一个用 C++ 编写的开源 3D 资产导入/导出库。它的核心目标只有一个：把各种五花八门的 3D 文件格式，统一转换成一套干净、一致的内存数据结构，让上层应用不必为每种格式单独写解析器。

目前它支持 40 多种导入格式，并持续增加导出格式，涵盖 FBX、glTF/glTF2、Collada(DAE)、OBJ、STL、3MF、IFC、PLY、X 等常见格式。

核心能力

1. 多格式统一加载

无论输入是 FBX 还是 glTF，加载后都得到同一套 aiScene 结构，包含网格、材质、骨骼、动画、相机、灯光等信息。

2. 网格后处理（Post-Processing）

Assimp 提供一系列可组合的后处理步骤：

• 生成法线与切线空间
• 三角化多边形
• 顶点缓存局部性优化
• 移除退化图元与重复顶点
• 按图元类型排序
• 合并冗余材质

3. 多语言与多平台

• 官方提供 C 与 C++ API
• 社区维护 Python、Java、C#、Rust、Pascal、HAXE、Node.js 等绑定
• 支持 Android 与 iOS
• 有 Unity、Unreal 插件以及 Qt5 模型查看器等周边工具

快速上手

Assimp 使用 CMake 构建，典型流程如下：

git clone https://github.com/assimp/assimp
cd assimp
cmake -G Ninja -DASSIMP_BUILD_TESTS=off -DASSIMP_INSTALL=off -S . -B build
cd build
ninja

也可以直接通过 vcpkg 等包管理器安装，或从官方渠道下载预编译二进制。

仓库结构速览

code/            核心源码（AssetLib、CApi、PostProcessing 等）
contrib/         第三方依赖
include/         公开的 C/C++ 头文件
port/            各语言移植与绑定
test/            单元测试与模型测试集
tools/           命令行工具与旧版查看器
samples/         示例代码

适用人群

• 正在开发游戏引擎、编辑器或资源管线的工程师
• 需要做模型格式转换、批量处理的工具开发者
• 在 AR/VR、数字孪生、BIM 等场景中加载 3D 资产的团队

注意事项

• 项目采用 3 条款 BSD 许可，可静态链接并用于商业产品，但需保留许可文本。
• 部分格式（如 FBX）并非基于官方 SDK 实现，遇到复杂模型时可能需自行排查兼容性。
• 移动端集成时建议按需裁剪支持的格式，以控制库体积。