From 65660bf52f0421b36e653d233c3cc0f685709150 Mon Sep 17 00:00:00 2001
From: Geequlim <geequlim@gmail.com>
Date: Thu, 16 Jul 2015 13:33:13 +0800
Subject: [PATCH] Convert 04/02,04/03

---
 04 Advanced OpenGL/02 Stencil testing.md | 192 ++++++++++++++++
 04 Advanced OpenGL/03 Blending.md        | 277 +++++++++++++++++++++++
 img/blending_C_result.png                | Bin 0 -> 29005 bytes
 3 files changed, 469 insertions(+)
 create mode 100644 04 Advanced OpenGL/02 Stencil testing.md
 create mode 100644 04 Advanced OpenGL/03 Blending.md
 create mode 100644 img/blending_C_result.png

diff --git a/04 Advanced OpenGL/02 Stencil testing.md b/04 Advanced OpenGL/02 Stencil testing.md
new file mode 100644
index 0000000..676b2da
--- /dev/null
+++ b/04 Advanced OpenGL/02 Stencil testing.md	
@@ -0,0 +1,192 @@
+##模板测试（Stencil testing）
+
+本文作者JoeyDeVries，由Django翻译自http://learnopengl.com
+
+当像素着色器处理完fragment以后，模板测试（stencil test）就开始执行了，和深度测试一样，它有能力丢弃fragment。仍然保留下来的fragment进入深度测试阶段，深度测试可能丢弃更多的fragment。模板测试基于另一个缓冲，这个缓冲叫做模板缓冲（stencil buffer），我们被允许在渲染时更新它来获取有意思的效果。
+
+模板缓冲中一个模板值（stencil value）通常含有8位大小，因此每个像素/fragment总共有256个不同的模板值（译注：8位就是1字节大小，因此和char的容量一样是256个不同值）。这样我们就能将这些模板值设置为我们链接的，然后当一个特定fragment有一个特定的模板值，我们就可以丢弃或保留fragment了。
+
+!!! Important
+
+        每个窗口库都需要为你设置模板缓冲。GLFW自动做了这件事，所以你不必告诉GLFW去创建它，但是其他库可能没默认创建模板库，所以一定要查看你使用的库的文档。
+        
+下面是一个模板缓冲的简单例子：
+
+![image description](http://learnopengl.com/img/advanced/stencil_buffer.png)
+
+模板缓冲先清空模板缓冲中设置的零，然后开启矩形一。场景中的fragment值渲染模板值包含1的那些fragment（其他的都被丢弃）。
+
+无论我们在渲染哪里的fragment，模板缓冲操作都允许我们把模板缓冲设置为一个特定值。改变模板缓冲的内容实际上就是对模板缓冲进行写入。在同一次（或接下来的）渲染迭代我们可以读取这些值来决定丢弃还是保留这些fragment。当使用模板缓冲的时候，你可以随心所欲，但是需要遵守下面的原则：
+
+* 开启模板缓冲写入。
+* 渲染物体，更新模板缓冲。
+* 关闭模板缓冲写入。
+* 渲染（其他）物体，这次基于模板缓冲内容丢弃特定fragment。
+
+使用模板缓冲我们可以基于场景中已经绘制的fragment，来决定是否丢弃特定的fragment。
+
+你可以开启GL_STENCIL_TEST来开启模板测试。接着所有渲染函数调用都会以这样或那样的方式影响到模板缓冲。
+
+```c
+glEnable(GL_STENCIL_TEST);
+```
+要注意的是，像颜色和深度缓冲一样，在每次循环，你也得清空模板缓冲。
+
+```c
+glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT);
+```
+
+同时，和深度测试的glDepthMask函数一样，模板缓冲也有一个相似函数。glStencilMask允许我们给模板值设置一个位遮罩（bitmask），它与模板值进行与（and）运算决定缓冲是否可写。默认设置的位遮罩都是1，这样就不会影响输出，但是如果我们设置为0x00，所有写入深度缓冲最后都是0。这和深度缓冲的glDepthMask(GL_FALSE)一样：
+
+```c++
+glStencilMask(0xFF); // Each bit is written to the stencil buffer as is
+glStencilMask(0x00); // Each bit ends up as 0 in the stencil buffer (disabling writes)
+```
+
+大多数情况你的模板遮罩（stencil mask）写为0x00或0xFF就行，但是最好知道有一个选项可以自定义位遮罩。
+
+###模板方程（stencil functions）
+
+和深度测试一样，我们也有几个不同控制权，决定何时模板测试通过或失败以及它怎样影响模板缓冲。一共有两种方程可供我们使用去配置模板测试：glStencilFunc和glStencilOp。
+
+glStencilFunc(GLenum func, GLint ref, GLuint mask)有三个参数：
+
+* func：设置模板测试方程。这个测试方程应用到已经储存的模板值和glStencilFunc的ref值上，可用的选项是：GL_NEVER、GL_LEQUAL、GL_GREATER、GL_GEQUAL、GL_EQUAL、GL_NOTEQUAL、GL_ALWAYS。它们的语义和深度缓冲的方程相似。
+* ref：指定模板测试的引用值。模板缓冲的内容会与这个值对比。
+* mask：指定一个遮罩，在模板测试对比引用值和储存的模板值前，对它们进行与（and）操作。初始设置为1。
+
+在上面简单模板的例子里，方程应该设置为：
+
+```c
+glStencilFunc(GL_EQUAL, 1, 0xFF)
+```
+
+它会告诉OpenGL，无论何时，一个fragment模板值等于（GL_EQUAL）引用值1，fragment就能通过测试被绘制了，否则就会被丢弃。
+
+但是glStencilFunc只描述了OpenGL对模板缓冲做什么，而不是我们如何更新缓冲。这就需要glStencilOp登场了。
+
+glStencilOp(GLenum sfail, GLenum dpfail, GLenum dppass)包含三个选项，我们可以指定每个选项的动作：
+
+* sfail：如果模板测试失败将采取的动作。
+* dpfail：如果模板测试通过，但是深度测试失败时采取的动作。
+* dppass：如果深度测试和模板测试都通过，将采取的动作。
+
+每个选项都可以使用下列任何一个动作。
+
+操作 | 描述
+---|---
+GL_KEEP   |The currently stored stencil value is kept.
+GL_ZERO	  |The stencil value is set to 0.
+GL_REPLACE|	The stencil value is replaced with the reference value set with glStencilFunc.
+GL_INCR	|The stencil value is increased by 1 if it is lower than the maximum value.
+GL_INCR_WRAP|	Same as GL_INCR, but wraps it back to 0 as soon as the maximum value is exceeded.
+GL_DECR	    |The stencil value is decreased by 1 if it is higher than the minimum value.
+GL_DECR_WRAP|	Same as GL_DECR, but wraps it to the maximum value if it ends up lower than 0.
+GL_INVERT   |	Bitwise inverts the current stencil buffer value.
+
+glStencilOp函数默认设置为 (GL_KEEP, GL_KEEP, GL_KEEP) ，所以任何测试的任何结果，模板缓冲都会保留它的值。默认行为不会更新模板缓冲，所以如果你想写入模板缓冲的话，你必须像任意选项指定至少一个不同的动作。
+
+使用glStencilFunc和glStencilOp，我们就可以指定在什么时候以及我们打算怎么样去更新模板缓冲了，我们也可以指定何时让测试通过或不通过。什么时候fragment会被抛弃。
+
+###物体轮廓
+
+看了前面的部分你未必能理解模板测试是如何工作的，所以我们会展示一个模板测试可以实现的一个特别的和有用的功能，叫做物体轮廓（object outlining）。
+
+![](http://learnopengl.com/img/advanced/stencil_object_outlining.png)
+
+物体轮廓就像它的名字所描述的那样，它能够给每个（或一个）物体创建一个有颜色的边。在策略游戏中当你打算选择一个单位的时候它特别有用。给物体加上轮廓的步骤如下：
+
+1. 在绘制（有轮廓的）物体前，把模板方程设置为GL_ALWAYS，用1更新物体的将被渲染的fragment。
+2. 渲染物体。
+3. 关闭模板写入和深度测试。
+4. 每个物体放大一点点。
+5. 使用一个不同的像素着色器输出一个纯颜色。
+6. 再次绘制物体，但只是当它们的fragment的模板值不为1时才进行。
+7. 开启模板写入和深度测试。
+
+这个过程将每个物体的fragment模板缓冲设置为1，当我们绘制边框的时候，我们基本上绘制的是放大版本的物体和通过测试的地方，放大的版本绘制后物体就会有一个边。我们基本会使用模板缓冲丢弃所有的不是原来物体的fragment的放大的版本内容。
+
+我们先来创建一个非常基本的像素着色器，它输出一个边框颜色。我们简单地设置一个固定的颜色值，把这个着色器命名为shaderSingleColor：
+
+```c++
+void main()
+{
+    outColor = vec4(0.04, 0.28, 0.26, 1.0);
+}
+```
+
+我们只打算给两个箱子加上边框，所以我们不会对地面做什么。这样我们要先绘制地面，然后再绘制两个箱子（同时写入模板缓冲），接着我们绘制放大的箱子（同时丢弃前面已经绘制的箱子的那部分fragment）。
+
+我们先开启模板测试，把将设置为无论何时、任何测试、通过或失败时才采取动作：
+
+```c++
+glEnable(GL_DEPTH_TEST);
+glStencilOp(GL_KEEP, GL_KEEP, GL_REPLACE);
+```
+
+如果任何测试失败我们都什么也不做，我们简单地保持深度缓冲中当前所储存着的值。如果模板测试和深度测试都成功了，我们就将储存着的模板值替换为1，我们要用glStencilFunc来做这件事。
+
+我们清空模板缓冲为0，为箱子的所有绘制的fragment的模板缓冲更新为1：
+
+```c++
+glStencilFunc(GL_ALWAYS, 1, 0xFF); // All fragments should update the stencil buffer
+glStencilMask(0xFF); // Enable writing to the stencil buffer
+normalShader.Use();
+DrawTwoContainers();
+```
+
+使用GL_ALWAYS模板测试方程，我们确保箱子的每个fragment用模板值1更新模板缓冲。因为fragment总会通过模板测试，在我们绘制它们的地方，模板缓冲用引用值更新。
+
+现在箱子绘制之处，模板缓冲更新为1了，我们将要绘制放大的箱子，但是这次关闭模板缓冲的写入：
+
+```c++
+glStencilFunc(GL_NOTEQUAL, 1, 0xFF);
+glStencilMask(0x00); // Disable writing to the stencil buffer
+glDisable(GL_DEPTH_TEST);
+shaderSingleColor.Use(); 
+DrawTwoScaledUpContainers();
+```
+
+我们把模板方程设置为GL_NOTEQUAL，它保证我们只箱子上不等于1的部分，这样只绘制前面绘制的箱子外围的那部分。注意，我们也要关闭深度测试，这样放大的的箱子也就是边框才不会被地面覆盖。
+
+做完之后还要保证再次开启深度缓冲。
+
+场景中的物体边框的绘制方法最后看起来像这样：
+
+```c++
+glEnable(GL_DEPTH_TEST);
+glStencilOp(GL_KEEP, GL_KEEP, GL_REPLACE);  
+  
+glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT); 
+ 
+glStencilMask(0x00); // Make sure we don't update the stencil buffer while drawing the floor
+normalShader.Use();
+DrawFloor()  
+  
+glStencilFunc(GL_ALWAYS, 1, 0xFF); 
+glStencilMask(0xFF); 
+DrawTwoContainers();
+  
+glStencilFunc(GL_NOTEQUAL, 1, 0xFF);
+glStencilMask(0x00); 
+glDisable(GL_DEPTH_TEST);
+shaderSingleColor.Use(); 
+DrawTwoScaledUpContainers();
+glStencilMask(0xFF);
+glEnable(GL_DEPTH_TEST);
+```
+
+理解这段代码后面的模板测试的思路并不难以理解。如果还不明白尝试再仔细阅读上面的部分，尝试理解每个函数的作用，现在你已经看到了它的使用方法的例子。
+
+这个边框的算法的结果在深度测试教程的那个场景中，看起来像这样：
+![](http://bullteacher.com/wp-content/uploads/2015/06/stencil_scene_outlined.png)
+
+在这里查看源码和着色器，看看完整的物体边框算法是怎样的。
+
+!!! Important
+
+        你可以看到两个箱子边框重合通常正是我们希望得到的（想想策略游戏中，我们打算选择10个单位；我们通常会希望把边界合并）。如果你想要让每个物体都有自己的边界那么你需要为每个物体清空模板缓冲，创造性地使用深度缓冲。
+
+你目前看到的物体边框算法在一些游戏中显示备选物体（想象策略游戏）非常常用，这样的算法可以在一个模型类中轻易实现。你可以简单地在模型类设置一个布尔类型的标识来决定是否绘制边框。如果你想要更多的创造性，你可以使用后处理（post-processing）过滤比如高斯模糊来使边框看起来更自然。
+
+除了物体边框以外，模板测试还有很多其他的应用目的，比如在后视镜中绘制纹理，这样它会很好的适合镜子的形状，比如使用一种叫做shadow volumes的模板缓冲技术渲染实时阴影。模板缓冲在我们的已扩展的OpenGL工具箱中给我们提供了另一种好用工具。
\ No newline at end of file
diff --git a/04 Advanced OpenGL/03 Blending.md b/04 Advanced OpenGL/03 Blending.md
new file mode 100644
index 0000000..26f2fe5
--- /dev/null
+++ b/04 Advanced OpenGL/03 Blending.md	
@@ -0,0 +1,277 @@
+##混合（Blending）
+
+本文作者JoeyDeVries，由Django翻译自http://learnopengl.com
+
+混合（blending）在OpenGL中通常也叫作物体透明技术。透明的是物体（或物体的一部分）非纯色而是混合色，这种颜色来自于不同浓度的自身颜色和它后面的物体的颜色。一个有色玻璃窗就是一种透明物体；玻璃有自身的颜色，但是最终的颜色包含了所有玻璃后面的颜色。这也正是混合这名称的出处，因为我们将多种（来自于不同物体）颜色混合为一个单一颜色。透明使得我们可以看穿物体。
+
+![](http://learnopengl.com/img/advanced/blending_transparency.png)
+
+透明物体可以是完全透明的（它使颜色完全穿透）或者半透明的（它使颜色穿透的同时也显示自身颜色）。一个物体透明度，被定义为它的颜色的alpha值。alpha颜色值是一个颜色向量的第四个元素，这你可能已经看到很多了。直到这个教程前，我们一直把这个第四个元素设置为1.0，这样物体的透明度就是0.0，同样的，alpha值是0.0物体就是完全透明的了。alpha值为0.5告诉我们物体的颜色由50%的自身的颜色，和50%的后面的颜色组成。
+
+我们目前所使用的纹理都是由3个颜色元素组成的：红、绿、蓝，但是有些纹理同样有一个内嵌的aloha通道，它为每个纹理像素（texel）包含着一个alpha值。这个alpha值告诉我们纹理的哪个部分有透明度，以及这个透明度有多少。例如，下面的窗子纹理的玻璃部分的alpha值为0.25（它正常是完全红色的，但是由于它有75的透明度，它会很大程度上反映出网站的背景色，看起来就不那么红了），在它的角落部分alpha只是0.0。
+
+![](http://bullteacher.com/wp-content/uploads/2015/06/blending_transparent_window.png)
+
+我们很快就会把这个窗子纹理加到场景中，但是首先，我们将讨论一点简单的技术来实现纹理的半透明，也就是完全透明和完全不透明。
+
+####丢弃fragment
+
+有些图像并不关心半透明，但也想基于纹理的颜色值显示或不显示物体。考虑一下草；创建像草这种东西你不需要花费很大力气，你通常把一个草的纹理贴到2D四边形上，然后把这个四边形放置到你的场景中。可是，草并不是像2D正方形这样的形状，所以你只需要显示草纹理的一部分而忽略其他部分。
+
+下面的纹理正是这样的纹理，它既有完全不透明的部分（alpha值为1.0）也有完全透明的部分（alpha值为0.0），而没有半透明的部分。你可以看到没有草的部分，图片显示了网站的背景色，而不是它自身的那部分颜色。
+
+![image description](http://learnopengl.com/img/textures/grass.png)
+
+所以，当向场景中添加像草这样的植物的时候，我们不会希望看到一个草的方块图像，而是只显示草实际那部分，图像剩下的部分都可以看穿。我们要丢弃纹理透明部分的像素，不去把这些fragment储存到颜色缓冲中。在这之前，我们首先要学一下如何加载一个透明纹理。
+
+加载带有alpha值的纹理我们需要告诉SOIL，去加载RGBA元素图像，而不再是RGB元素的。要注意的是，SOIL仍然能很好的加载大多数无alpha的纹理，它只是储存了一个1.0，而它被省略了。
+
+```c
+unsigned char * image = SOIL_load_image(path, &width, &height, 0, SOIL_LOAD_RGBA);
+```
+
+不要忘记还要改变纹理生成步骤：
+
+```c++
+glTexImage2D(GL_TEXTURE_2D, 0, GL_RGBA, width, height, 0, GL_RGBA, GL_UNSIGNED_BYTE, image);
+```
+
+保证你在像素着色器中获取了纹理的所有4个颜色元素，而不仅仅是RGB元素：
+
+```c++
+void main()
+{
+    // color = vec4(vec3(texture(texture1, TexCoords)), 1.0);
+    color = texture(texture1, TexCoords);
+}
+```
+
+现在我们知道了如何加载透明纹理，是时候试试在深度测试教程里那个场景中添加几根草了。
+
+我们创建一个vector，向里面添加几个glm::vec3变量，来表示草的位置：
+
+```c++
+vector<glm::vec3> vegetation;
+vegetation.push_back(glm::vec3(-1.5f,  0.0f, -0.48f));
+vegetation.push_back(glm::vec3( 1.5f,  0.0f,  0.51f));
+vegetation.push_back(glm::vec3( 0.0f,  0.0f,  0.7f));
+vegetation.push_back(glm::vec3(-0.3f,  0.0f, -2.3f));
+vegetation.push_back(glm::vec3( 0.5f,  0.0f, -0.6f));
+```
+
+每个草被渲染为一个单独的四边形，它们被贴上草的纹理。它并不能完美的表现3D草，但是比起加载复杂的模型还是要高效很多。利用一些小技巧，比如在同一个地方添加多个不同朝向的草，还是能获得比较好的效果。
+
+由于草纹理被添加到四边形物体上，我们需要再次创建另一个VAO，向里面填充VBO，以及设置合理的顶点属性指针。接着在我们绘制玩地面和两个立方体后，我们就来绘制草叶：
+
+```c++
+glBindVertexArray(vegetationVAO);
+glBindTexture(GL_TEXTURE_2D, grassTexture);  
+for(GLuint i = 0; i < vegetation.size(); i++) 
+{
+    model = glm::mat4();
+    model = glm::translate(model, vegetation[i]); 
+    glUniformMatrix4fv(modelLoc, 1, GL_FALSE, glm::value_ptr(model));
+    glDrawArrays(GL_TRIANGLES, 0, 6);
+}  
+glBindVertexArray(0);
+```
+
+运行程序你将看到：
+![image description](http://learnopengl.com/img/advanced/blending_no_discard.png)
+
+出现这种情况是因为OpenGL默认是不知道如何处理alpha值的，不知道何时丢弃它们。我们不得不手动做这件事。幸运的是这很简单，感谢着色器吧。GLSL为我们提供了discard命令，它保证了fragment不会被进一步处理，这样就不会进入颜色缓冲。有了这个命令我们就可以在像素着色器中检查一个fragment是否有在一定的阈限下的alpha值，如果有，那么丢弃这个fragment，就好像它从来都没被处理过一样：
+
+```c++
+#version 330 core
+in vec2 TexCoords;
+ 
+out vec4 color;
+ 
+uniform sampler2D texture1;
+ 
+void main()
+{             
+    vec4 texColor = texture(texture1, TexCoords);
+    if(texColor.a < 0.1)
+        discard;
+    color = texColor;
+}
+```
+
+在这儿我们检查被采样纹理颜色包含着一个低于0.1这个阈限的alpha值，如果有，就丢弃fragment。这个像素着色器能够保证我们只渲染哪些不是完全透明的fragment。现在我们来看看效果：
+
+![image description](http://learnopengl.com/img/advanced/blending_discard.png)
+
+!!! Important
+
+        需要注意的是，当采样纹理边缘的时候，OpenGL在边界值和下一个重复的纹理的值之间进行插值（因为我们把它的放置方式设置成了GL_REPEAT）。这样就行了，但是由于我们使用的是透明值，纹理图片的上部获得了它的透明值是与底边的纯色值进行插值的。结果就是一个有点半透明的边了，你可以从我们的纹理四边形的四周看到。为了防止它的出现，当你使用alpha纹理的时候要把纹理放置方式设置为GL_CLAMP_TO_EDGE：
+
+        glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_WRAP_S, GL_CLAMP_TO_EDGE);
+
+        glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_WRAP_T, GL_CLAMP_TO_EDGE);
+        
+你可以[在这里得到源码](http://learnopengl.com/code_viewer.php?code=advanced/blending_discard)。
+
+###混合
+
+在丢弃所有fragment的方式，不能使我们获得渲染半透明图像的灵活性；我们要么渲染出像素，要么完全地丢弃它。为了渲染出不同的透明度级别，我们需要开启混合（blending）。像大多数OpenGL的功能一样，我们可以开启GL_BLEND来启用混合功能：
+
+```
+glEnable(GL_BLEND);
+```
+
+现在我们开启了混合，我们需要告诉OpenGL它该如何混合。
+
+OpenGL以下面的方程进行混合：
+
+C¯result = C¯source ∗ Fsource + C¯destination ∗ Fdestination
+
+* C¯source：源颜色向量。这是来自纹理的本来的颜色向量。
+* C¯destination：目标颜色向量。这是储存在颜色缓冲中当前的颜色向量。
+* Fsource：源因子。设置了对源颜色的alpha值影响。
+* Fdestination：目标因子。设置了对目标颜色的alpha影响。
+
+像素着色器运行和所有的测试就通过了以后，混合方程才能自由执行fragment的颜色输出，当前它在颜色缓冲中（前面的fragment的颜色在当前fragment之前储存）。源和目标颜色会自动被OpenGL设置，但是源和目标因子可以让我们自由设置。我们来看一个简单的例子：
+
+![](http://learnopengl.com/img/advanced/blending_equation.png)
+
+我们有两个方块，我们希望在红色方块上绘制绿色方块。红色方块会成为源颜色（它会先进入颜色缓冲），我们将在红色方块上绘制绿色方块。
+
+那么问题来了：我们怎样来设置因子呢？我们起码要把绿色方块乘以它的alpha值，所以我们打算把F_{src}设置为源颜色向量的alpha值：0.6。接着，让目标方块的浓度等于剩下的alpha值。如果最终的颜色中绿色方块的溶度为60%，我们就把红色的浓度设为40%（1.0 – 0.6）。所以我们把F_{destination}设置为等于一减去源颜色向量的alpha值。方程将变成：
+
+![](https://github.com/LearnOpenGL-CN/LearnOpenGL-CN/tree/master/img/blending_C_result.png)
+
+最终方块结合部分包含了60%的绿色和40%的红色，得到一种脏兮兮的颜色：
+
+![](http://bullteacher.com/wp-content/uploads/2015/06/blending_equation_mixed.png)
+
+最后的颜色之后被储存到颜色缓冲中，取代先前的颜色。
+
+所以已经不错了，但是我们怎样告诉OpenGL来使用这样的因子呢？恰好有一个叫做glBlendFunc的函数。
+
+glBlendFunc(GLenum sfactor, GLenum dfactor)接收两个参数，来设置源（source）和目标（destination）因子。OpenGL为我们定义了很多选项，我们把最常用的列在下面。注意，颜色常数向量C¯constant可以用glBlendColor函数分开来设置。
+
+
+Option |	Value
+---|---
+GL_ZERO  |	Factor is equal to 0.
+GL_ONE	 |Factor is equal to 1.
+GL_SRC_COLOR |	Factor is equal to the source color vector C¯source.
+GL_ONE_MINUS_SRC_COLOR |	Factor is equal to 1 minus the source color vector: 1−C¯source.
+GL_DST_COLOR |	Factor is equal to the destination color vector C¯destination
+GL_ONE_MINUS_DST_COLOR |	Factor is equal to 1 minus the destination color vector: 1−C¯destination.
+GL_SRC_ALPHA |	Factor is equal to the alpha component of the source color vector C¯source.
+GL_ONE_MINUS_SRC_ALPHA |	Factor is equal to 1−alpha of the source color vector C¯source.
+GL_DST_ALPHA |	Factor is equal to the alpha component of the destination color vector C¯destination.
+GL_ONE_MINUS_DST_ALPHA |	Factor is equal to 1−alpha of the destination color vector C¯destination.
+GL_CONSTANT_COLOR	   |Factor is equal to the constant color vector C¯constant.
+GL_ONE_MINUS_CONSTANT_COLOR |	Factor is equal to 1 - the constant color vector C¯constant.
+GL_CONSTANT_ALPHA	    | Factor is equal to the alpha component of the constant color vector C¯constant.
+GL_ONE_MINUS_CONSTANT_ALPHA |	Factor is equal to 1−alpha of the constant color vector C¯constant.
+
+为从两个方块获得混合结果，我们打算把源颜色的alpha给源因子，1-alpha给目标因子。调整到glBlendFunc之后就像这样：
+
+```c
+glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
+```
+
+也可以为RGB和alpha通道各自设置不同的选项，使用glBlendFuncSeperate：
+
+```c
+glBlendFuncSeperate(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA,GL_ONE, GL_ZERO);
+```
+
+这个方程就像我们之前设置的那样，设置了RGB元素，但是只让最终的alpha元素被源alpha值影响到。
+
+OpenGL给了我们更多的自由，我们可以改变方程源和目标部分的操作符。现在，源和目标元素已经相加了，但是我们还可以把它们相减，如果我们愿意的话。
+
+glBlendEquation(GLenum mode)允许我们设置这个操作，有3种可行的选项：
+
+* GL_FUNC_ADD：默认的，彼此元素相加：C¯result = Src + Dst.
+* GL_FUNC_SUBTRACT：彼此元素相减： C¯result = Src – Dst.
+* GL_FUNC_REVERSE_SUBTRACT：彼此元素相减，但顺序相反：C¯result = Dst – Src.
+
+通常我们可以简单地省略glBlendEquation因为GL_FUNC_ADD在大多数时候就是我们想要的，但是如果你如果你真想尝试努力打破主流常规，其他的方程或许符合你的要求。
+
+###渲染半透明纹理
+
+现在我们知道OpenGL如何处理混合，是时候把我们的知识运用起来了，我们来添加几个半透明窗子。我们会使用本教程开始时用的那个场景，但是不再渲染草纹理，取而代之的是来自教程开始处半透明窗子纹理。
+
+首先，初始化时我们开始混合，设置合适和混合方程：
+
+```c++
+glEnable(GL_BLEND);
+glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
+```
+
+由于我们开启了混合，就不需要丢弃fragment了，所以我们把像素着色器设置为原来的那个版本：
+
+```c++
+#version 330 core
+in vec2 TexCoords;
+ 
+out vec4 color;
+ 
+uniform sampler2D texture1;
+ 
+void main()
+{             
+    color = texture(texture1, TexCoords);
+}
+```
+
+这一次（无论OpenGL什么时候去渲染一个fragment），它都根据alpha值，把当前fragment的颜色和颜色缓冲中的颜色进行结合。因为窗子的玻璃部分的纹理是半透明的，我们应该可以透过玻璃看到整个场景。
+
+![](http://learnopengl.com/img/advanced/blending_incorrect_order.png)
+
+如果你仔细看看，就会注意到有些不对劲。前面的窗子透明部分阻塞了后面的。为什么会这样？
+
+原因是深度测试在与混合的一同工作时出现了点状况。当写入深度缓冲的时候，深度测试不关心fragment是否有透明度，所以透明部分被写入深度缓冲，就和其他值没什么区别。结果是整个四边形的窗子被检查时都忽视了透明度。即便透明部分应该显示出后面的窗子，深度缓冲还是丢弃了它们。
+
+所以我们不能简简单单地去渲染窗子，我们期待着深度缓冲为我们解决这所有问题；这也正是混合之处代码不怎么好看的原因。为保证前面窗子显示了它后面的窗子，我们必须首先绘制后面的窗子。这意味着我们必须手工调整窗子的顺序，从远到近地逐个渲染。
+
+!!! Important
+
+        对于全透明物体，比如草叶，我们选择简单的丢弃透明像素而不是混合，这样就减少了我们的头疼问题（没有深度测试问题）。
+        
+####别打乱顺序
+
+要让混合在多物体上有效，我们必须先绘制最远的物体，最后绘制最近的物体。普通的无混合物体仍然可以使用深度缓冲正常绘制，所以不必给它们排序。我们一定要保证它们在透明物体前绘制好。当无透明度物体和透明物体一起绘制的时候，通常要遵循以下原则：
+
+先绘制所有不透明物体。
+为所有透明物体排序。
+按顺序绘制透明物体。
+一种排序透明物体的方式是，获取一个物体到观察者透视图的距离。这可以通过获取摄像机的位置向量和物体的位置向量来得到。接着我们就可以把它和相应的位置向量一起储存到一个map数据结构（STL库）中。map会自动基于它的键排序它的值，所以当我们把它们的距离作为键添加到所有位置中后，它们就自动按照距离值排序了：
+
+```c++
+std::map<float, glm::vec3> sorted;
+for (GLuint i = 0; i < windows.size(); i++) // windows contains all window positions
+{
+    GLfloat distance = glm::length(camera.Position - windows[i]);
+    sorted[distance] = windows[i];
+}
+```
+
+最后产生了一个容器对象，基于它们距离从低到高储存了每个窗子的位置。
+
+随后当渲染的时候，我们逆序获取到每个map的值（从远到近），然后以正确的绘制相应的窗子：
+
+```c++
+for(std::map<float,glm::vec3>::reverse_iterator it = sorted.rbegin(); it != sorted.rend(); ++it) 
+{
+    model = glm::mat4();
+    model = glm::translate(model, it->second); 
+    glUniformMatrix4fv(modelLoc, 1, GL_FALSE, glm::value_ptr(model));
+    glDrawArrays(GL_TRIANGLES, 0, 6);
+}
+```
+
+我们从map得来一个逆序的迭代器，迭代出每个逆序的条目，然后把每个窗子的四边形平移到相应的位置。这个相对简单的方法对透明物体进行了排序，修正了前面的问题，现在场景看起来像这样：
+
+![](http://learnopengl.com/img/advanced/blending_sorted.png)
+
+你可以[从这里得到完整的带有排序的源码](http://learnopengl.com/code_viewer.php?code=advanced/blending_sorted)。
+
+虽然这个按照它们的距离对物体进行排序的方法在这个特定的场景中能够良好工作，但它不能进行旋转、缩放或者进行其他的变换，奇怪形状的物体需要一种不同的方式，而不能简单的使用位置向量。
+
+在场景中排序物体是个有难度的技术，它很大程度上取决于你场景的类型，更不必说会耗费二外的处理能力了。完美地渲染带有透明和不透明的物体的场景并不那么容易。有更高级的技术例如次序无关透明度（order independent transparency），但是这超出了本教程的范围。现在你不得不采用普通的混合你的物体，但是如果你小心谨慎，并知道这个局限，你仍可以得到颇为合适的混合实现。
diff --git a/img/blending_C_result.png b/img/blending_C_result.png
new file mode 100644
index 0000000000000000000000000000000000000000..9bf7876310fc601436a28ebc7f6ea205b58c0317
GIT binary patch
literal 29005
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
BSNQ+{

literal 0
HcmV?d00001