[CG从零开始] 3. 安装 pyassimp 库加载模型文件

assimp 是一个开源的模型加载库，支持非常多的格式，还有许多语言的 binding，这里我们选用 assimp 的 python 的 binding 来加载模型文件。不过社区主要是在维护 assimp 的 C++ 代码，对于这些 binding 可能更新的不够及时，比如 python 版本的就存在一些问题。

assimp 的源码

1. 安装 pyassimp

官方的编译的指南，有些坑还是需要踩一下。

pyassimp 只是 assimp 的一个 wrapper，所以计算上还必须有 assimp 的库才行，还是免不了要去编译 assimp。

这里推荐采用 vcpkg 的进行管理，windows 上需要装一下 visual studio，mac 需要装一下 xcode，这些软件也是标配了。我的电脑是 macOS，这里有个坑需要注意一下，vcpkg 这个默认编译是静态库 .a，我们需要编译动态库，所以需要改一下 vcpkg 的编译选项。如下 vcpkg/triplets/x64-osx.cmake 中将如下选项改为 dynamic

set(VCPKG_LIBRARY_LINKAGE dynamic)

依次执行以下命令即可。

git clone https://github.com/Microsoft/vcpkg.git
cd vcpkg
./bootstrap-vcpkg.sh
./vcpkg integrate install
./vcpkg install assimp

等待编译完成，即可在 vcpkg/packages/assimp_x64-osx/lib 中找到动态库 .dylib 文件，windows 应该也是差不多的路径。

然后可以用 pip 来安装 pyassimp

注意！ 这里有个坑，pyassimp 的 4.1.4 版本，现在默认最新版本，存在 bug，加载模型可能会随机 crash，github 上有个 issue 在讨论这个事情，大家目前的解决方案就是回退到 4.1.3 所以在安装的时候，我们指定一下版本。

pip install pyassimp==4.1.3

2. 调用 pyassimp API 加载模型

这个时候如果直接调用加载 API 加载模型，会报找不到库的错误:

raise AssimpError("assimp library not found")
pyassimp.errors.AssimpError: assimp library not found

因为 vcpkg 安装的 assimp 的库不在 pyassimp 的搜索路径下，看了一下 pyassimp 搜索库的路径，基本上常用的库的路径他都搜索来，我们有两种方法，1. 创建一个软链接到搜索路径中, 2. 将 assimp 库的路径加入环境变量 LD_LIBRARY_PATH 中。

为了方便我创建一个软链接到系统库中

ln -s {你的 assimp 库的路径} /usr/local/lib

然后我们执行下面的代码，主要 path 换成你的模型文件，这下就可以找到库文件了。

import pyassimp
path = "box.fbx"
scene = pyassimp.load(path)
print(scene.meshes[0].vertices.shape)

3. 总结

1. 用 vcpkg 编译得到 assimp 的库，注意修改编译选项；
2. 安装 pyassimp 的 4.1.3 版本！！；
3. 将 assimp 库放到 pyassimp 可以找到的地方