OpenGL学习预备篇——使用premake配置SOIL2库

前言

   在这篇博客中，我们来了解一下SOIL2的安装，以及在安装过程中我觉得需要注意的点。

SOIL2介绍

   SOIL是简易OpenGL图像库(Simple OpenGL Image Library)的缩写，它支持大多数流行的图像格式，使用起来也很简单。当前的最新版本是SOIL2。

SOIL下载

   https://github.com/SpartanJ/SOIL2/releases
   上面已经给出了SOIL2的github地址，我们可以点进去，此时我们会发现没有发布版本了
   但是不用慌，我们再点一下tag，就可以看到并下载啦，博主这里选择的release 1.2.0

premake下载

   首先什么是premake，相信大家都听说过cmake，cmake就是会将我们下载的源码生成工程环境，premake也是通过读取项目脚本，来生成各种开发环境的项目文件。如果更喜欢用cmake也可以使用cmake。

   可以去premake的网站： https://premake.github.io/download下载premake，根据自己的系统选择对应的版本。博主自己是windows系统，于是选择下载windows版本的。现在默认下载的是premake-5.0.0

premake SOIL

   将下载下来的SOIL和premake进行解压，并将premake5.exe放进SOIL文件夹中，文件夹结构如下所示：

   之后我们在此路径下进入控制台，即在文件夹的路径栏输入“cmd”。当然也可以直接在命令行中通过cd指定进入该目录。

   在命令行中输入premake5.exe vs2019，因为博主这里用的vs2019，如果你是vs2017，那么可以输入premake5.exe vs2017，依次类推。我们看到最后一行是Done就表明我们make完了。

   此时文件夹中会多出一个make的文件夹

   进入make文件夹，再进入windows文件夹，可以找到SOIL.sln文件，我们双击打开这个VS项目文件。

   进入解决方案资源管理器，对soil2-static-lib右键，点击生成，这里有个要注意的地方就是我们的环境最好和我们的工程一致，否则后面会报错LINK2019错误，找不到lib文件。比如博主这里就改成了和工程一样的×64。修改的位置在我最上面的红圈处。

   编译完我们可以获取两个文件夹：lib和obj

SOIL2文件整理

   然后我们新建一个文件夹，这里博主命名为SOIL2tool，里面新建两个文件夹，一个是lib，一个叫include。如下所示：

   我们之后进入SOIL2-release-1.20文件夹中，即我们刚刚premake的那个文件夹，找到lib文件夹进去，继续进入windows文件夹，找到soil2-debug.lib文件，将其复制进我们刚创建的新文件夹SOIL2tool下的lib文件夹下。

   返回SOIL2-release-1.20文件夹中，找到src文件夹进去，将整个SOIL2文件夹复制进我们刚创建的新文件夹SOIL2tool下的include文件夹下。

VS2019中的配置

   打开项目属性，打开方式是项目 -> 属性

   点击VC++目录 -> 包含目录，在其中添加我们刚刚新建文件夹SOIL2tool下的include文件夹

   点击VC++目录 -> 库目录，在其中添加我们刚刚新建文件夹SOIL2tool下的lib文件夹

   点击C/C++ -> 常规，在其中添加我们刚刚新建文件夹SOIL2tool下的include文件夹

   点击链接器 -> 常规 -> 附加库目录，在其中添加我们刚刚新建文件夹SOIL2tool下的lib文件夹

   点击链接器 -> 输入 -> 附加依赖项，在其中添加我们soil2-debug.lib文件

   现在完成了所有配置啦，可以开始使用SOIL库了。使用以下代码即可包含进SOIL库

#include <SOIL2/SOIL2.h>