整理工作区

自定义函数库

首先来看函数，当我们要在程序中调用函数时，必须在主函数之前声明或直接定义，为了程序方便，我们通常都直接定义。

在上一节，我们在 final 函数定义了四个纹理边界处理函数和两个边界判定函数。这几个函数算是比较常用的类型，如果今后我们需要在其他着色器中使用，最笨的办法就是把函数拷贝过去，不仅麻烦还容易出差错。再者，假如你拷贝完才发现，某个函数的实现出现了问题，这下好了，天塌了。再者，随着程序的编写，函数肯定会越来越多，到时候我们想检查主函数逻辑会非常麻烦。

聪明的你肯定已经想了很久了：我们直接把这些函数塞进一个文件里，然后在着色器中使用 #include 包含就行。

这种文件就称为库文件 ，有了它可以极大提升代码可读性和易维护性。对于这类通用函数，我们都将它们存进一个名为 Utilities.glsl 的文件（意为实用函数），并将其后缀设置为关联到了语法插件的 .glsl。

如果你更细心一点，可能会觉察到一个问题：如果我们重复包含一个文件会怎样？

这是可能的，因为有些库文件可能还包含了其他库文件，如果重复包含，编译器就会报告重复声明而出错。这个问题也很好解决：还是我们的宏命令， #ifndef 。回想一下 #ifndef 的用处，如果没有声明某个宏则包含代码。于是我们只需要在库文件的开头和结尾加上

就可以完美避免重复包含的问题了：如果已经包含过这个文件，势必定义过 FILE_UTILITIES ，而如果已经定义了它，则整个库文件内容都不会被包含。

OptiFine 数据库

在上一节，我们使用了几个统一变量。如果你去看过附录一就会知道，我们的统一变量和顶点属性之后肯定也会占个满屏。于是我们的第二个文件也准备好了： Uniforms.glsl ，它专门用来存统一变量。

有些统一变量（主要是纹理）并不是所有程序中都可用的，比如我们已经用过的 colortex0 就是一个仅延迟渲染可用的采样器。对于这类变量，我们可用主动在包含每个库之前进行声明来判断当前所处的着色器程序和阶段：

然后在库文件中添加：

如果你仔细阅读了 第一章第二节 就会知道 composite 和 deferred 是什么。

然后预留好几何缓冲专用的缓冲区判定宏：

由于只有顶点着色器才能访问顶点属性，我们将它们单独放入文件 Attributes.glsl ，然后只在顶点着色器中包含即可。

同样的，别忘记在两个库文件加上防止重复包含的宏：

宏定义库

还记得我们之前因为懒得手改数据而定义的宏 BLUR_SAMPLES 吗？这些宏定义可以当作游戏内光影设置页面的选项。为了之后提供更加友好的用户选项界面，以及防止一些选项需要跨文件导致改动不及时，把它们存起来也是必要的。我们把它们都保存在 Settings.glsl 中以供调用，同时也不要忘记：

存放和调用

如果把它们就这样散乱在 shaders 文件夹下，如果今后库文件增多会变得麻烦，我们可以在下面新建一个文件夹 libs ，然后把它们拖进去。

现在，我们把所有占地方的内容全部整理好了，现在我们只需要用 #include 包含它们就好。要记住 #include 的路径总是从 shaders 开始：

自定义统一变量

不知道你还记不记得，在之前的程序中我们定义了两个变量：

它们本质上都是用统一变量运算而来的，统一变量在每个着色器的每个像素之间不会被更改（纹理也不是只能采样像素位置，所以也是统一变量）。自然而然地，我们就会思考：能不能只计算一次这些统一变量呢？

这里需要光影包很重要的配置文件了，希望你还记得之前第一章的内容，在这里我们要用到配置文件就是 shaders.properties 。它可以进行很多配置、调整光影选项页面、以及我们所需要的：添加自定义统一变量。

定义自定义统一变量的语法非常简单：

注意不能像 GLSL 那样混用浮点和向量，也不能进行向量四则运算。

然后，我们可以像声明其他统一变量那样声明：

记得把它们放进 Uniforms.glsl 中。

宏定义文件

还记得我们孤零零躺在 Settings.glsl 里的宏吗？事实上，如果对它改造一番，我们就可以不需要每次都在代码里修改它的值了。试着在这一行后面加上注释，然后把几个值用方括号括起来，同时以空格隔开每个值：

然后在配置文件中添加一行

最后保存并回到游戏重载光影，按下 F3O 打开光影设置页面，如果不出意外，你应该已经可以看到它了：

试着点几下这个选项，你会发现它在我们之前设定的几个值中来回循环，这就是我们的光影选项了。假如你再在配置文件中添加一行

然后保存并重载，你会发现选项变成了滑块：

这对目前的我们来说已经够用了。在之后的章节中，我们将更具体地讲解光影选项。

至此，我们的库文件整理便告一段落，从下一节开始，我们就将正式迎接几何缓冲，并解开上一节中留下的疑问。