@@ -3,73 +3,69 @@
原文 | [Assimp ](http://learnopengl.com/#!Model-Loading/Assimp )
---|---
作者 | JoeyDeVries
翻译 | Cocoonshu
校对 | [Geequlim ](http://geequlim.com )
翻译 | Cocoonshu, Meow J, [Geequlim ](http://geequlim.com )
校对 | 暂未校对
到目前为止的所有场景中，我们一直都在滥用我们的箱子朋友，但时间久了甚至是我们最好的朋友也会感到无聊。在日常的图形程序中，通常都会使用非常复杂且好玩的模型，它们比静态的箱子要好看多了。然而，和箱子对象不同，我们不太能够对像是房子、汽车或者人形角色这样的复杂形状手工定义所有的顶点、法线和纹理坐标。我们想要的是将这些模型(Model)**导入**(Import)到程序当中。模型通常都由3D艺术家在[Blender ](http://www.blender.org/ )、[3DS Max ](http://www.autodesk.nl/products/3ds-max/overview )或者[Maya ](http://www.autodesk.com/products/autodesk-maya/overview )这样的工具中精心制作。
到目前为止， ， ， ， ， ， ， Blender ](http://www.blender.org/ )、[S Max ](http://www.autodesk.nl/products/3ds-max/overview )或者[Maya ](http://www.autodesk.com/products/autodesk-maya/overview )这样的工具软件 。
这些所谓的< def > 3D建模工具</ def > ( 3D Modeling Tool)可以让艺术家创建复杂的形状，并使用一种叫做< def > UV映射</ def > (uv-mapping)的手段来应用贴图。这些工具将会在导出到模型文件的时候自动生成所有的顶点坐标、顶点法线以及纹理坐标。这样子艺术家们即使不了解图形技术细节的情况下，也能拥有一套强大的工具来构建高品质的模型了。所有的技术细节都隐藏在了导出的模型文件中。但是，作为图形开发者，我们就**必须**要了解这些技术细节了 。
那些3D建模工具， ， ， ， 模型文件时，建模工具会自己生成所有的顶点坐标、顶点法线和纹理坐标。这样，美工们可以不用了解大量的图像技术细节，就能有大量的工具集去随心地构建高品质的模型。所有的技术细节内容都隐藏在里导出的模型文件里。而我们，这些图形开发者，就必须得去关注这些技术细节了 。
所以， ， ， 模型的 文件格式有很多种，每一种都会以它们自己的方式来导出模型数据。像是[Wavefront的.obj ](http://en.wikipedia.org/wiki/Wavefront_.obj_file )这样的模型格式，只包含了模型数据以及材质信息，像是模型颜色和漫反射/镜面光贴图。而以XML为基础的[Collada文件格式 ](http://en.wikipedia.org/wiki/COLLADA )则非常的丰富， 。
因此， ， ， ， ， ， ， 。
总而言之，不同种类的文件格式有很多，它们之间通常并没有一个通用的结构。所以如果我们想从这些文件格式中导入模型的话，我们必须要去自己对每一种需要导入的文件格式写一个导入器。很幸运的是，正好有一个库专门处理这个问题 。
## 模型加载库
现在市面上有一个很流行的模型加载库， ， Open Asset Import Library。Assimp可以导入几十 种不同格式 的模型文件（同样也可以 导出部分模型 格式）。只要 Assimp加载完了 模型文件 ，我们就可以 从Assimp上获取所有我们需要的模型数据。Assimp把不同的模型文件都转换为一个统一的数据结构， ， 用同一个 方式去 访问我们需要的模型 数据。
当导入一个模型文件时， ， ， ：
一个非常流行的模型导入库是[Assimp ](http://assimp.org/ )，它是** Open Asset Import Library**（开放的资产导入库）的缩写 。Assimp能够导入很多 种不同的模型文件格式（并也能够 导出部分的 格式）， 之后 ，我们就能够 从Assimp的数据结构中提取我们所需的所有数据了。由于Assimp的数据结构保持不变， ， ， 用同一种 方式访问我们需要的数据。
当使用Assimp导入一个模型的时候， ， ， （ ） ：
- 和材质和网格(Mesh)一样，所有的场景/模型数据都包含在< u > Scene</ u > 对象中。< u > Scene</ u > 对象也包含了场景根节点的引用。
- 场景的< u > Root node</ u > （根节点）可能包含子节点（和其它的节点一样），它会有一系列指向场景对象中< var > mMeshes</ var > 数组中储存的网格数据的索引。< u > Scene</ u > 下的< var > mMeshes</ var > 数组储存了真正的< u > Mesh</ u > 对象，节点中的< var > mMeshes</ var > 数组保存的只是场景中网格数组的索引。
- 一个< u > Mesh</ u > 对象本身包含了渲染所需要的所有相关数据，像是顶点位置、法向量、纹理坐标、面(Face)和物体的材质。
- 一个网格包含了多个面。< u > Face</ u > 代表的是物体的渲染图元(Primitive)（三角形、方形、点）。一个面包含了组成图元的顶点的索引。由于顶点和索引是分开的，使用一个索引缓冲来渲染是非常简单的（见[你好，三角形 ](../01 Getting started/04 Hello Triangle.md )）。
- 最后，一个网格也包含了一个< u > Material</ u > 对象，它包含了一些函数能让我们获取物体的材质属性，比如说颜色和纹理贴图（比如漫反射和镜面光贴图）。
- 所有的模型、场景数据都包含在scene对象中， ， 对象中
- 场景的根节点可能也会包含很多子节点和一个指向保存模型点云数据mMeshes[]的索引集合。根节点上的mMeshes[]里保存了实际了Mesh对象， ： ， #称为引用 )
- 一个Mesh对象本身包含渲染所需的所有相关数据，
- 一个Mesh会包含多个面片。一个Face（ ） ， （ ） ， ， ， （ ） （ Hello Triangle ](http://www.learnopengl.com/#!Getting-started/Hello-Triangle )）
- 一个Mesh还会包含一个Material（ ） （ ）
所以我们要做的第一件事， ， （ ） ，
所以，我们需要做的第一件事是将一个物体加载到< u > Scene</ u > 对象中，遍历节点，获取对应的< u > Mesh</ u > 对象（我们需要递归搜索每个节点的子节点），并处理每个< u > Mesh</ u > 对象来获取顶点数据、索引以及它的材质属性。最终的结果是一系列的网格数据，我们会将它们包含在一个`Model` 对象中。
!!! Important
**网格(Mesh) **
用建模工具构建物体时，美工通常不会直接使用单个形状来构建一个完整的模型。一般来说，一个模型会由几个子模型/形状组合拼接而成。而模型中的那些子模型/形状就是我们所说的一个网格。例如一个人形模型， ， ， （ ）
**网格**
下一节教程中， ， ， ， ， ， 。
当使用建模工具对物体建模的时候，艺术家通常不会用单个形状创建出整个模型。通常每个模型都由几个子模型/形状组合而成。组合模型的每个单独的形状就叫做一个< def > 网格</ def > (Mesh)。比如说有一个人形的角色： ， （ ） （ ） 。
在[下一节 ](02 Mesh.md )中，我们将创建我们自己的< fun > Model</ fun > 和< fun > Mesh</ fun > 类来加载并使用刚刚介绍的结构储存导入后的模型。如果我们想要绘制一个模型， ， ， ，
## 构建Assimp
你可以在[ ](http://assimp.sourceforge.net /main_downloads.html )选择一个想要的版本去下载Assimp库。到目前为止， Assimp可用的最新 版本是 3.1.1。我们建议你自己编译Assimp库， Assimp官方的已编译库不能很好地覆盖在所有平台上 运行。如果你忘记怎样 使用CMake编译一个库，请详见[Creating a window(创建一个 窗口) ](http://www.learnopengl.com/#! Getting- started/Creating-a- window
你可以在Assimp的[ ](http://assimp.org /main_downloads.html )中 选择相应的版本。在写作时使用的 Assimp最高 版本为 3.1.1。我们建议你自己编译Assimp库， 它们的预编译库在大部分系统上都是不能 运行的 。如果你忘记如何 使用CMake自己 编译一个库的话，可以复习[创建 窗口 ](../01 Getting started/02 Creating a window.md )小节
这里我们列出一些编译Assimp时可能遇到的问题，
构建Assimp时可能会出现一些问题， ， ：
- CMake在读取配置列表时， 与 DirectX库丢失相关的一些 错误。报错如下：
- CMake在读取配置列表时， 不断 报出DirectX库丢失的 错误。报错如下：
```
t X
CMake Error at cmake-modules/FindPkgMacros.cmake:110 (message):
Required library DirectX not found! Install the library (including dev packages) and try again. If the library is already installed, set the missing variables manually in cmake.
Required library DirectX not found! Install the library (including dev packages)
and try again. If the library is already installed, set the missing variables
manually in cmake.
```
这个问题的解决方案：如果你之前没有 安装过 DirectX SDK， 那么请安装。下载地址：[DirectX SDK ](http://www.microsoft.com/en-us/download/details.aspx?id=6812 )。
这个问题的解决方案是 安装DirectX SDK， 如果你之前没安装过的话。你可以从[这里 ](http://www.microsoft.com/en-us/download/details.aspx?id=6812 )下载SDK 。
- 安装DirectX SDK时， < b > S1023</ b > 的错误。遇到这个问题， ，
问题解释：[已知问题： ](https://blogs.msdn.microsoft.com/chuckw/2011/12/09/known-issue-directx-sdk-june-2010-setup-and-the-s1023-error/ ) 。
- 一旦配置完成， ， （ ， ） 。
- 使用默认配置构建的Assimp是一个动态库，
- 编译出来的Assimp的LIB文件和DLL文件可以在code/Debug或者code/Release里找到。
- 把编译好的LIB文件和DLL文件拷贝到工程的相应目录下， （ ）
- 安装DirectX SDK时， `s1023` 的错误。这种情况下， 这个 ](http://blogs.msdn.com/b/chuckw/archive/2011/12/09/known-issue-directx-sdk-june-2010-setup-and-the-s1023-error.aspx )先卸载
- 一旦配置完成， ， （ ， ）
- 使用默认配置构建的Assimp是一个动态库(Dynamic Library)，所以我们需要包含所生成的**assimp.dll**文件以及程序的二进制文件。你可以简单地将DLL复制到我们程序可执行文件的同一目录中。
- Assimp编译之后， 。
- 接着把编译好的LIB文件和DLL文件拷贝到工程的相应目录下， （
如果你还 遇到了其他问题，可以在下面给出的链接里获取 帮助。
如果你仍 遇到了未报告的错误，欢迎在评论区中寻求 帮助。
!!! Important
如果你想要 让Assimp使用多线程支持来提高 性能，你可以使用< b > Boost</ b > Assimp。在[Boost 安装页面 ](http://assimp.sourceforge.net /lib_html/install.html )，
如果你想让Assimp使用多线程来获得更高的 性能，你可以使用Boost 库来编译Assimp。你可以在它们的[ ](http://assimp.org /lib_html/install.html )找到 完整的 安装介绍。
现在，你应该已经能够 编译Assimp库， 导入完美的3D物件！ ](02 Mesh.md )
现在，你应该已经编译完 Assimp库并将它链接到你的程序中 了。下一步：[导入 ](02 Mesh.md )漂亮的3D物体！
Meow J