From cf735a322bc1b96131949a6028088881888ecab4 Mon Sep 17 00:00:00 2001
From: JiangMuWen <dueltor@163.com>
Date: Sat, 4 Feb 2017 21:30:02 +0800
Subject: [PATCH 01/19] code tiny error

---
 docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md b/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md
index ec3aff4..52a0974 100644
--- a/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md	
+++ b/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md	
@@ -202,7 +202,7 @@ void main()
     lightDistance = lightDistance / far_plane;
     
     // Write this as modified depth
-    gl_FragDepth = gl_FragCoord.z;
+    gl_FragDepth = lightDistance;
 }
 ``` 
 
@@ -476,4 +476,4 @@ PCF算法的结果如果没有变得更好，也是非常不错的，这是柔
 
 - [Shadow Mapping for point light sources in OpenGL](http://www.sunandblackcat.com/tipFullView.php?l=eng&topicid=36)：sunandblackcat的万向阴影映射教程。
 - [Multipass Shadow Mapping With Point Lights](http://ogldev.atspace.co.uk/www/tutorial43/tutorial43.html)：ogldev的万向阴影映射教程。
-- [Omni-directional Shadows](http://www.cg.tuwien.ac.at/~husky/RTR/OmnidirShadows-whyCaps.pdf)：Peter Houska的关于万向阴影映射的一组很好的ppt。
\ No newline at end of file
+- [Omni-directional Shadows](http://www.cg.tuwien.ac.at/~husky/RTR/OmnidirShadows-whyCaps.pdf)：Peter Houska的关于万向阴影映射的一组很好的ppt。

From 61a92b5224e0ef8eec429df288eba821b1db35fe Mon Sep 17 00:00:00 2001
From: JiangMuWen <dueltor@163.com>
Date: Sat, 4 Feb 2017 21:45:27 +0800
Subject: [PATCH 02/19] Update 02 Point Shadows.md

---
 docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md b/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md
index 52a0974..a12294e 100644
--- a/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md	
+++ b/docs/05 Advanced Lighting/03 Shadows/02 Point Shadows.md	
@@ -108,7 +108,7 @@ RenderScene();
 GLfloat aspect = (GLfloat)SHADOW_WIDTH/(GLfloat)SHADOW_HEIGHT;
 GLfloat near = 1.0f;
 GLfloat far = 25.0f;
-glm::mat4 shadowProj = glm::perspective(90.0f, aspect, near, far);
+glm::mat4 shadowProj = glm::perspective(glm::radians(90.0f), aspect, near, far);
 ```
 
 非常重要的一点是，这里glm::perspective的视野参数，设置为90度。90度我们才能保证视野足够大到可以合适地填满立方体贴图的一个面，立方体贴图的所有面都能与其他面在边缘对齐。

From 87b88bc590de423cb92189d7c456e4ea75c6c45c Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Sun, 19 Feb 2017 00:38:56 +0800
Subject: [PATCH 03/19] 03-03

---
 docs/03 Model Loading/03 Model.md | 14 +++++++-------
 1 file changed, 7 insertions(+), 7 deletions(-)

diff --git a/docs/03 Model Loading/03 Model.md b/docs/03 Model Loading/03 Model.md
index 2a955b7..1e1a8e5 100644
--- a/docs/03 Model Loading/03 Model.md	
+++ b/docs/03 Model Loading/03 Model.md	
@@ -6,30 +6,30 @@
 翻译     | [Django](http://bullteacher.com/)
 校对     | [Geequlim](http://geequlim.com)
 
-现在是时候着手启用Assimp，并开始创建实际的加载和转换代码了。本教程的目标是创建另一个类，这个类可以表达模型(Model)的全部。更确切的说，一个模型包含多个网格(Mesh)，一个网格可能带有多个对象。一个别墅，包含一个木制阳台，一个尖顶或许也有一个游泳池，它仍然被加载为一个单一模型。我们通过Assimp加载模型，把它们转变为多个`Mesh`对象，这些对象是是上一节教程里创建的。
+现在是时候着手启用Assimp，并开始创建实际的加载和转换代码了。本教程的目标是创建另一个能够完整表示模型(Model)的类，更确切的说，是一个包含多个网格(Mesh)，并且可能带有多个对象的模型。也就是说，一个包含木制阳台、塔楼、甚至游泳池的房子，仍然可以被加载为单独的一个模型。我们将通过Assimp加载模型，把它们转变为多个在[上一节](02 Mesh.md)中创建的<fun>Mesh</fun>对象。
 
-闲话少说，我把Model类的结构呈现给你：
+闲话少说，我会先把<fun>Model</fun>类的结构给你：
 
 ```c++
 class Model 
 {
     public:
-        /*  成员函数   */
+        /*  函数   */
         Model(GLchar* path)
         {
             this->loadModel(path);
         }
-        void Draw(Shader shader); 
+        void Draw(Shader shader);	
     private:
         /*  模型数据  */
         vector<Mesh> meshes;
         string directory;
-        
-        /*  私有成员函数   */
+        /*  函数   */
         void loadModel(string path);
         void processNode(aiNode* node, const aiScene* scene);
         Mesh processMesh(aiMesh* mesh, const aiScene* scene);
-        vector<Texture> loadMaterialTextures(aiMaterial* mat, aiTextureType type, string typeName);
+        vector<Texture> loadMaterialTextures(aiMaterial* mat, aiTextureType type, 
+                                             string typeName);
 };
 ```
 

From 75e877f2c1d2a606de2be672379511f1f30fff8b Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Sat, 25 Feb 2017 04:40:29 +0800
Subject: [PATCH 04/19] 04-01

---
 docs/04 Advanced OpenGL/01 Depth testing.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/04 Advanced OpenGL/01 Depth testing.md b/docs/04 Advanced OpenGL/01 Depth testing.md
index 2f11437..062121f 100644
--- a/docs/04 Advanced OpenGL/01 Depth testing.md	
+++ b/docs/04 Advanced OpenGL/01 Depth testing.md	
@@ -165,7 +165,7 @@ float LinearizeDepth(float depth)
 
 void main()
 {
-    float depth = LinearizeDepth(gl_FragCoord.z);
+    float depth = LinearizeDepth(gl_FragCoord.z) / far; // 为了演示除以far
     color = vec4(vec3(depth), 1.0f);
 }
 ```

From dea94299f9f87d6e2b26f52f305f0176bcd01c37 Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Sat, 25 Feb 2017 19:22:42 +0800
Subject: [PATCH 05/19] New tutorial is out. Being busy recently, so
 translation later.

---
 docs/07 PBR/03 IBL/01 Diffuse irradiance.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/07 PBR/03 IBL/01 Diffuse irradiance.md b/docs/07 PBR/03 IBL/01 Diffuse irradiance.md
index dd3c032..83e46af 100644
--- a/docs/07 PBR/03 IBL/01 Diffuse irradiance.md	
+++ b/docs/07 PBR/03 IBL/01 Diffuse irradiance.md	
@@ -1,7 +1,7 @@
 # 漫反射辐照
 
-**未完成**
+**暂无翻译**
 
-这篇教程暂时还没有完成，您可以经常来刷新看看是否有更新的进展。
+这篇教程暂时还没有进行翻译，您可以先阅读[原文](https://learnopengl.com/#!PBR/IBL/Diffuse-irradiance)，或经常来刷新看看是否有更新的进展。当然，我们更欢迎您在[GitHub上](https://github.com/LearnOpenGL-CN/LearnOpenGL-CN)认领翻译这篇文章，帮助我们完善这个教程系列。
 
 <img src="../../../img/development.png" class="clean">
\ No newline at end of file

From 67b9c400e58f75c7dfa6baf2a865fdacdaee83bc Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Thu, 2 Mar 2017 00:21:20 +0800
Subject: [PATCH 06/19] Fix #59

---
 docs/04 Advanced OpenGL/02 Stencil testing.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/04 Advanced OpenGL/02 Stencil testing.md b/docs/04 Advanced OpenGL/02 Stencil testing.md
index 7cde8b6..afae8d0 100644
--- a/docs/04 Advanced OpenGL/02 Stencil testing.md	
+++ b/docs/04 Advanced OpenGL/02 Stencil testing.md	
@@ -40,7 +40,7 @@ glEnable(GL_STENCIL_TEST);
 glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT | GL_STENCIL_BUFFER_BIT);
 ```
 
-同时，和深度测试的`glDepthMask`函数一样，模板缓冲也有一个相似函数。`glStencilMask`允许我们给模板值设置一个**位遮罩(Bitmask)**，它与模板值进行按位与(AND)运算决定缓冲是否可写。默认设置的位遮罩都是1，这样就不会影响输出，但是如果我们设置为0x00，所有写入深度缓冲最后都是0。这和深度缓冲的`glDepthMask(GL_FALSE)`很类似：
+同时，和深度测试的`glDepthMask`函数一样，模板缓冲也有一个相似函数。`glStencilMask`允许我们给模板值设置一个**位掩码(Bitmask)**，它与模板值进行按位与(AND)运算决定缓冲是否可写。默认设置的位掩码都是1，这样就不会影响输出，但是如果我们设置为0x00，所有写入深度缓冲最后都是0。这和深度缓冲的`glDepthMask(GL_FALSE)`很类似：
 
 ```c++
 
@@ -53,7 +53,7 @@ glStencilMask(0xFF);
 glStencilMask(0x00); 
 ```
 
-大多数情况你的模板遮罩（stencil mask）写为0x00或0xFF就行，但是最好知道有一个选项可以自定义位遮罩。
+大多数情况你的模板掩码（stencil mask）写为0x00或0xFF就行，但是最好知道有一个选项可以自定义位掩码。
 
 ## 模板函数
 
@@ -62,8 +62,8 @@ glStencilMask(0x00);
 `void 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。
+* **ref**：指定模板测试的参考值。模板缓冲的内容会与这个值对比。
+* **mask**：指定一个掩码值。在模板测试比较参考值和储存的模板值前，会用掩码值对它们分别进行按位与(AND)操作。初始情况下所有位都为1。
 
 在上面简单模板的例子里，方程应该设置为：
 
@@ -71,7 +71,7 @@ glStencilMask(0x00);
 glStencilFunc(GL_EQUAL, 1, 0xFF)
 ```
 
-它会告诉OpenGL，无论何时，一个片段模板值等于(`GL_EQUAL`)引用值`1`，片段就能通过测试被绘制了，否则就会被丢弃。
+它会告诉OpenGL，无论何时，一个片段模板值等于(`GL_EQUAL`)参考值`1`，片段就能通过测试被绘制了，否则就会被丢弃。
 
 但是`glStencilFunc`只描述了OpenGL对模板缓冲做什么，而不是描述我们如何更新缓冲。这就需要`glStencilOp`登场了。
 
@@ -145,7 +145,7 @@ normalShader.Use();
 DrawTwoContainers();
 ```
 
-使用`GL_ALWAYS`模板测试函数，我们确保箱子的每个片段用模板值1更新模板缓冲。因为片段总会通过模板测试，在我们绘制它们的地方，模板缓冲用引用值更新。
+使用`GL_ALWAYS`模板测试函数，我们确保箱子的每个片段用模板值1更新模板缓冲。因为片段总会通过模板测试，在我们绘制它们的地方，模板缓冲用参考值更新。
 
 现在箱子绘制之处，模板缓冲更新为1了，我们将要绘制放大的箱子，但是这次关闭模板缓冲的写入：
 

From 8a4d1e0889f4d65016a4676217a31d08007a9536 Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Sun, 26 Mar 2017 21:16:42 +0800
Subject: [PATCH 07/19] Fix #60

---
 docs/02 Lighting/01 Colors.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/02 Lighting/01 Colors.md b/docs/02 Lighting/01 Colors.md
index 24b0404..4b25d6b 100644
--- a/docs/02 Lighting/01 Colors.md	
+++ b/docs/02 Lighting/01 Colors.md	
@@ -45,7 +45,7 @@ glm::vec3 toyColor(1.0f, 0.5f, 0.31f);
 glm::vec3 result = lightColor * toyColor; // = (0.33f, 0.21f, 0.06f);
 ```
 
-如你所见，我们可以通过物体对不同颜色光的反射来的得到意想不到的不到的颜色，从此创作颜色已经变得非常简单。
+如你所见，我们可以通过物体对不同颜色光的反射来得到意想不到的颜色，从此创作颜色已经变得非常简单。
 
 目前有了这些颜色相关的理论已经足够了，接下来我们将创建一个场景用来做更多的实验。
 

From 0b42a6392d79f6577cc76e2818149eb879a5c6a6 Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Sun, 2 Apr 2017 15:18:43 +0800
Subject: [PATCH 08/19] Fix #62

---
 docs/04 Advanced OpenGL/08 Advanced GLSL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/04 Advanced OpenGL/08 Advanced GLSL.md b/docs/04 Advanced OpenGL/08 Advanced GLSL.md
index fc30f9c..9d81152 100644
--- a/docs/04 Advanced OpenGL/08 Advanced GLSL.md	
+++ b/docs/04 Advanced OpenGL/08 Advanced GLSL.md	
@@ -82,7 +82,7 @@ void main()
 
 因为窗口的宽是800，当一个像素的x坐标小于400，那么它一定在窗口的左边，这样我们就让物体有个不同的颜色。
 
-![](../img/04/08/advanced_glsl_frontfacing.png)
+![](../img/04/08/advanced_glsl_fragcoord.png)
 
 我们现在可以计算出两个完全不同的片段着色器结果，每个显示在窗口的一端。这对于测试不同的光照技术很有好处。
 

From 0cc832b4ec3ab0aac278f627dfa6af80d492c0f2 Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Sun, 2 Apr 2017 15:24:14 +0800
Subject: [PATCH 09/19] Update PBR chapter

---
 docs/07 PBR/01 Theory.md                    | 4 ++++
 docs/07 PBR/02 Lighting.md                  | 2 ++
 docs/07 PBR/03 IBL/01 Diffuse irradiance.md | 2 ++
 docs/07 PBR/03 IBL/02 Specular IBL.md       | 6 ++++--
 4 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/docs/07 PBR/01 Theory.md b/docs/07 PBR/01 Theory.md
index 321d156..fdbbc63 100644
--- a/docs/07 PBR/01 Theory.md	
+++ b/docs/07 PBR/01 Theory.md	
@@ -6,6 +6,10 @@
 翻译     | [J.moons](https://github.com/JiangMuWen)
 校对     | Meow J（初校）
 
+!!! warning
+
+	注意，作者正在对PBR章节进行大的调整，原文的内容时时可能有更新，建议仍是阅读原文。
+
 PBR，或者用更通俗一些的称呼是指<def>基于物理的渲染</def>(Physically Based Rendering)，它指的是一些在不同程度上都基于与现实世界的物理原理更相符的基本理论所构成的渲染技术的集合。正因为基于物理的渲染目的便是为了使用一种更符合物理学规律的方式来模拟光线，因此这种渲染方式与我们原来的Phong或者Blinn-Phong光照算法相比总体上看起来要更真实一些。除了看起来更好些以外，由于它与物理性质非常接近，因此我们（尤其是美术师们）可以直接以物理参数为依据来编写表面材质，而不必依靠粗劣的修改与调整来让光照效果看上去正常。使用基于物理参数的方法来编写材质还有一个更大的好处，就是不论光照条件如何，这些材质看上去都会是正确的，而在非PBR的渲染管线当中有些东西就不会那么真实了。
 
 虽然如此，基于物理的渲染仍然只是对基于物理原理的现实世界的一种近似，这也就是为什么它被称为**基于**物理的着色(Physically based Shading) 而非物理着色(Physical Shading)的原因。判断一种PBR光照模型是否是基于物理的，必须满足以下三个条件（不用担心，我们很快就会了解它们的）：
diff --git a/docs/07 PBR/02 Lighting.md b/docs/07 PBR/02 Lighting.md
index 5f4eec8..bd993f8 100644
--- a/docs/07 PBR/02 Lighting.md	
+++ b/docs/07 PBR/02 Lighting.md	
@@ -4,4 +4,6 @@
 
 这篇教程暂时还没有进行翻译，您可以先阅读[原文](https://learnopengl.com/#!PBR/Lighting)，或经常来刷新看看是否有更新的进展。当然，我们更欢迎您在[GitHub上](https://github.com/LearnOpenGL-CN/LearnOpenGL-CN)认领翻译这篇文章，帮助我们完善这个教程系列。
 
+注意，作者正在对PBR章节进行大的调整，原文的内容时时可能有更新，所以建议暂时不要进行认领。
+
 <img src="../../img/development.png" class="clean">
\ No newline at end of file
diff --git a/docs/07 PBR/03 IBL/01 Diffuse irradiance.md b/docs/07 PBR/03 IBL/01 Diffuse irradiance.md
index 83e46af..0c3a0ab 100644
--- a/docs/07 PBR/03 IBL/01 Diffuse irradiance.md	
+++ b/docs/07 PBR/03 IBL/01 Diffuse irradiance.md	
@@ -4,4 +4,6 @@
 
 这篇教程暂时还没有进行翻译，您可以先阅读[原文](https://learnopengl.com/#!PBR/IBL/Diffuse-irradiance)，或经常来刷新看看是否有更新的进展。当然，我们更欢迎您在[GitHub上](https://github.com/LearnOpenGL-CN/LearnOpenGL-CN)认领翻译这篇文章，帮助我们完善这个教程系列。
 
+注意，作者正在对PBR章节进行大的调整，原文的内容时时可能有更新，所以建议目前不要进行认领。
+
 <img src="../../../img/development.png" class="clean">
\ No newline at end of file
diff --git a/docs/07 PBR/03 IBL/02 Specular IBL.md b/docs/07 PBR/03 IBL/02 Specular IBL.md
index 7b10792..cdf337c 100644
--- a/docs/07 PBR/03 IBL/02 Specular IBL.md	
+++ b/docs/07 PBR/03 IBL/02 Specular IBL.md	
@@ -1,7 +1,9 @@
 # 镜面IBL
 
-**未完成**
+**暂无翻译**
 
-这篇教程暂时还没有完成，您可以经常来刷新看看是否有更新的进展。
+这篇教程暂时还没有进行翻译，您可以先阅读[原文](https://learnopengl.com/#!PBR/IBL/Specular-IBL)，或经常来刷新看看是否有更新的进展。当然，我们更欢迎您在[GitHub上](https://github.com/LearnOpenGL-CN/LearnOpenGL-CN)认领翻译这篇文章，帮助我们完善这个教程系列。
+
+注意，作者正在对PBR章节进行大的调整，原文的内容时时可能有更新，所以建议目前不要进行认领。
 
 <img src="../../../img/development.png" class="clean">
\ No newline at end of file

From 5d49045239f14d153444407bfeb9b8abfc429b67 Mon Sep 17 00:00:00 2001
From: kenlee <ken4000kl@gmail.com>
Date: Wed, 5 Apr 2017 20:30:27 +0800
Subject: [PATCH 10/19] fix some translation errors and code displaying errors.

---
 docs/04 Advanced OpenGL/08 Advanced GLSL.md   |  4 ++--
 docs/04 Advanced OpenGL/09 Geometry Shader.md | 22 +++++++++----------
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/docs/04 Advanced OpenGL/08 Advanced GLSL.md b/docs/04 Advanced OpenGL/08 Advanced GLSL.md
index 9d81152..bfee611 100644
--- a/docs/04 Advanced OpenGL/08 Advanced GLSL.md	
+++ b/docs/04 Advanced OpenGL/08 Advanced GLSL.md	
@@ -4,7 +4,7 @@
       ---|---
 作者     | JoeyDeVries
 翻译     | [Django](http://bullteacher.com/)
-校对     | [Geequlim](http://geequlim.com)
+校对     | [Geequlim](http://geequlim.com), [KenLee](https://hellokenlee.github.io/)
 
 
 这章不会向你展示什么新的功能，也不会对你的场景的视觉效果有较大提升。本文多多少少地深入探讨了一些GLSL有趣的知识，它们可能在将来能帮助你。基本来说有些不可不知的内容和功能在你去使用GLSL创建OpenGL应用的时候能让你的生活更轻松。
@@ -306,7 +306,7 @@ layout (std140) uniform ExampleBlock
 
 尝试自己计算出偏移量，把它们和表格对比，你可以把这件事当作一个练习。使用计算出来的偏移量，根据std140布局规则，我们可以用`glBufferSubData`这样的函数，使用变量数据填充缓冲。虽然不是很高效，但std140布局可以保证在每个程序中声明的这个uniform块的布局保持一致。
 
-在定义uniform块前面添加layout (std140)声明，我们就能告诉OpenGL这个uniform块使用了std140布局。另外还有两种其他的布局可以选择，它们需要我们在填充缓冲之前查询每个偏移量。我们已经了解了分享布局（shared layout）和其他的布局都将被封装（packed）。当使用封装（packed）布局的时候，不能保证布局在别的程序中能够保持一致，因为它允许编译器从uniform块中优化出去uniform变量，这在每个着色器中都可能不同。
+在定义uniform 块前面添加`layout (std140)`的声明表示这个uniform块使用 std140 布局。 另外我们还有两种布局可以选择，但是这两种布局都要求我们在填充缓冲之前查询每一个变量的偏移。 我们已经介绍了** 共享布局(shared layout) **，剩下另一种布局则是 ** 封装布局（packed layout） **。当我们使用封装布局(pack layout)的时候， OpenGL不保证所有程序的数据布局方式是一样的（也就是不共享），因为该布局允许编译器去优化uniform变量的数据放置方式，而这种优化的结果因不同的Shader而异。
 
 ## 使用uniform缓冲
 
diff --git a/docs/04 Advanced OpenGL/09 Geometry Shader.md b/docs/04 Advanced OpenGL/09 Geometry Shader.md
index 15b7add..371d040 100644
--- a/docs/04 Advanced OpenGL/09 Geometry Shader.md	
+++ b/docs/04 Advanced OpenGL/09 Geometry Shader.md	
@@ -4,7 +4,7 @@
       ---|---
 作者     | JoeyDeVries
 翻译     | [Django](http://bullteacher.com/)
-校对     | [Geequlim](http://geequlim.com)
+校对     | [Geequlim](http://geequlim.com), [KenLee](https://hellokenlee.github.io/)
 
 在顶点和片段着色器之间有一个可选的着色器，叫做几何着色器(Geometry Shader)。几何着色器以一个或多个表示为一个单独基本图形（primitive）的顶点作为输入，比如可以是一个点或者三角形。几何着色器在将这些顶点发送到下一个着色阶段之前，可以将这些顶点转变为它认为合适的内容。几何着色器有意思的地方在于它可以把（一个或多个）顶点转变为完全不同的基本图形（primitive），从而生成比原来多得多的顶点。
 
@@ -337,15 +337,15 @@ EndPrimitive();
 
 # 爆破物体
 
-绘制房子的确很有趣，但我们不会经常这么用。这就是为什么现在我们将撬起物体缺口，形成爆炸式物体的原因！虽然这个我们也不会经常用到，但是它能向你展示一些几何着色器的强大之处。
+尽管绘制房子的确很有趣，但我们不会经常这么做。因此我们接下来要更上一层楼，去爆破物体啦！虽然这个我们可能也不会经常用到，但是它能向你展示一些几何着色器的强大之处。
 
-当我们说对一个物体进行爆破(Explode)的时候并不是说我们将要把之前的那堆顶点炸掉，但是我们打算把每个三角形沿着它们的法线向量移动一小段距离。效果是整个物体上的三角形看起来就像沿着它们的法线向量爆炸了一样。纳米服上的三角形的爆炸式效果看起来是这样的：
+当我们说对一个物体进行爆破(Explode)的时候并不是说我们将要把之前的那堆顶点炸掉，但是我们打算把每个三角形沿着它们的法线向量移动一小段距离。视觉效果是整个物体上的三角形看起来就像沿着它们的法线向量爆炸了一样。纳米服上的三角形的爆炸式效果看起来是这样的：
 
 ![](../img/04/09/geometry_shader_explosion.png)
 
 这样一个几何着色器效果的一大好处是，它可以用到任何物体上，无论它们多复杂。
 
-因为我们打算沿着三角形的法线向量移动三角形的每个顶点，我们需要先计算它的法线向量。我们要做的是计算出一个向量，它垂直于三角形的表面，使用这三个我们已经的到的顶点就能做到。你可能记得变换教程中，我们可以使用叉乘获取一个垂直于两个其他向量的向量。如果我们有两个向量a和b，它们平行于三角形的表面，我们就可以对这两个向量进行叉乘得到法线向量了。下面的几何着色器函数做的正是这件事，它使用3个输入顶点坐标获取法线向量：
+因为我们打算沿着三角形的法线向量移动三角形的每个顶点，我们需要先计算它的法线向量。我们要做的是计算出一个向量，它垂直于三角形的表面，使用这三个我们已经的到的顶点就能做到。你可能记得在变换教程中，我们可以使用 **叉乘**获取一个垂直于两个其他向量的向量。如果我们有两个向量a和b，它们平行于三角形的表面，我们就可以对这两个向量进行叉乘得到法线向量了。下面的几何着色器函数做的正是这件事，它使用3个输入顶点坐标获取法线向量：
 
 ```c++
 vec3 GetNormal()
@@ -412,15 +412,15 @@ void main() {
 
 ```c++
 glUniform1f(glGetUniformLocation(shader.Program, "time"), glfwGetTime());
- ```
+```
 
 最后的结果是一个随着时间持续不断地爆炸的3D模型（不断爆炸不断回到正常状态）。尽管没什么大用处，它却向你展示出很多几何着色器的高级用法。你可以用[完整的源码](http://learnopengl.com/code_viewer.php?code=advanced/geometry_shader_explode)和[着色器](http://learnopengl.com/code_viewer.php?code=advanced/geometry_shader_explode_shaders)对比一下你自己的。
 
 # 显示法向量
 
-在这部分我们将使用几何着色器写一个例子，非常有用：显示一个法线向量。当编写光照着色器的时候，你最终会遇到奇怪的视频输出问题，你很难决定是什么导致了这个问题。通常导致光照错误的是，不正确的加载顶点数据，以及给它们指定了不合理的顶点属性，又或是在着色器中不合理的管理，导致产生了不正确的法线向量。我们所希望的是有某种方式可以检测出法线向量是否正确。把法线向量显示出来正是这样一种方法，恰好几何着色器能够完美地达成这个目的。
+在这部分我们将使用几何着色器写一个非常有用的例子：绘制出任意一个物体的全部法向量。当编写光照着色器的时候，你可能会得到一些奇怪的渲染输出，但是你却又很难判断是什么导致了这个问题。通常导致光照错误的是，由不正确地加载顶点数据或者错误地定义定点属性又或者在着色器中错误地处理等原因导致的法向量错误。我们希望有某种方式可以检测出我们使用法向量是否正确。一种比较好的方法去检测我们的法向量是否有错误是直接把物体的法向量全部绘制出来，而恰恰好几何着色器能完美地达成这个目标。
 
-思路是这样的：我们先不用几何着色器，正常绘制场景，然后我们再次绘制一遍场景，但这次只显示我们通过几何着色器生成的法线向量。几何着色器把一个三角形基本图形作为输入类型，用它们生成3条和法线向量同向的线段，每个顶点一条。伪代码应该是这样的：
+思路是这样的：我们先不用几何着色器，正常绘制场景。然后我们再次绘制一遍场景，但这次只显示我们通过几何着色器生成的法线向量。几何着色器把一个三角形基本图形作为输入类型，用它们生成3条沿法向量方向的法线——每个顶点一条。伪代码应该类似这个样子：
 
 ```c++
 shader.Use();
@@ -429,7 +429,7 @@ normalDisplayShader.Use();
 DrawScene();
 ```
 
-这次我们会创建一个使用模型提供的顶点法线，而不是自己去生成。为了适应缩放和旋转我们会在把它变换到裁切空间坐标前，使用法线矩阵来法线（几何着色器用他的位置向量做为裁切空间坐标，所以我们还要把法线向量变换到同一个空间）。这些都能在顶点着色器中完成：
+这次我们会在几何着色器中使用模型提供的顶点法线，而不用自己去生成。为了适应(由于 view 和 model 矩阵产生的)缩放和旋转，我们会在把法向量变换到裁切空间坐标系(clip-space)前，先把它变成法向量矩阵（几何着色器接受在裁切空间坐标系下的位置向量，因此我们也需要把法向量转换到同一空间坐标系下）。这些步骤都能在顶点着色器中完成：
 
 ```c++
 #version 330 core
@@ -452,7 +452,7 @@ void main()
 }
 ```
 
-经过变换的裁切空间法线向量接着通过一个接口块被传递到下个着色阶段。几何着色器接收每个顶点（带有位置和法线向量），从每个位置向量绘制出一个法线向量：
+经过变换的裁切坐标系空间法向量通过一个接口块被传递到下个着色阶段。几何着色器接收每个顶点的信息（包括其位置向量和法向量），从每个定点的位置上沿法向量方向画一条法线：
 
 ```c++
 #version 330 core
@@ -496,10 +496,10 @@ void main()
 }
 ```
 
-现在先使用普通着色器来渲染你的模型，然后使用特制的法线可视着色器，你会看到这样的效果：
+现在先使用普通着色器来渲染你的模型，然后使用特制的法线可视化着色器，你会看到类似这样的效果：
 
 ![](../img/04/09/geometry_shader_normals.png)
 
-除了我们的纳米服现在看起来有点像一个带着隔热手套的全身多毛的家伙外，它给了我们一种非常有效的检查一个模型的法线向量是否有错误的方式。你可以想象下这样的几何着色器也经常能被用在给物体添加毛发上。
+除了我们的纳米服现在看起来有点像一个带着隔热手套的全身多毛的家伙外，我们拥有了一种非常有效的检查一个模型的法线向量是否有错误的方式。你可以想象到这样的几何着色器也能被用在给物体添加毛发上。
 
 你可以从这里找到[源码](http://learnopengl.com/code_viewer.php?code=advanced/geometry_shader_normals)和可显示法线的[着色器](http://learnopengl.com/code_viewer.php?code=advanced/geometry_shader_normals_shaders)。

From b87ef76828077950d5960e7e143bb1586218ae5d Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Wed, 5 Apr 2017 21:08:07 +0800
Subject: [PATCH 11/19] Fix #63

---
 docs/04 Advanced OpenGL/08 Advanced GLSL.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/04 Advanced OpenGL/08 Advanced GLSL.md b/docs/04 Advanced OpenGL/08 Advanced GLSL.md
index 9d81152..303e846 100644
--- a/docs/04 Advanced OpenGL/08 Advanced GLSL.md	
+++ b/docs/04 Advanced OpenGL/08 Advanced GLSL.md	
@@ -306,7 +306,7 @@ layout (std140) uniform ExampleBlock
 
 尝试自己计算出偏移量，把它们和表格对比，你可以把这件事当作一个练习。使用计算出来的偏移量，根据std140布局规则，我们可以用`glBufferSubData`这样的函数，使用变量数据填充缓冲。虽然不是很高效，但std140布局可以保证在每个程序中声明的这个uniform块的布局保持一致。
 
-在定义uniform块前面添加layout (std140)声明，我们就能告诉OpenGL这个uniform块使用了std140布局。另外还有两种其他的布局可以选择，它们需要我们在填充缓冲之前查询每个偏移量。我们已经了解了分享布局（shared layout）和其他的布局都将被封装（packed）。当使用封装（packed）布局的时候，不能保证布局在别的程序中能够保持一致，因为它允许编译器从uniform块中优化出去uniform变量，这在每个着色器中都可能不同。
+通过在uniform块的定义前面添加`layout (std140)`声明，我们告诉OpenGL这个uniform块使用了std140布局。我们还有其它的另外两种布局可以选择，但它们都需要我们在填充缓冲之前查询每个的偏移量。前面我们已经见过的**共享**布局(Shared Layout)，还有一种则是**紧凑**布局(Packed Layout)。当我们使用紧凑布局的时候，不能保证这个布局在所有程序间能够保持一致（即并非共享），因为它允许编译器从uniform块中优化出去uniform变量，而具体优化出去的是哪个则根据着色器的不同会有所变化。
 
 ## 使用uniform缓冲
 

From 496f452db00dd69830b12a5878fd37fadc30d065 Mon Sep 17 00:00:00 2001
From: kenlee <ken4000kl@gmail.com>
Date: Fri, 7 Apr 2017 18:54:17 +0800
Subject: [PATCH 12/19] fixed some translation errors and add some annotations

---
 docs/04 Advanced OpenGL/11 Anti Aliasing.md | 44 +++++++++++----------
 1 file changed, 23 insertions(+), 21 deletions(-)

diff --git a/docs/04 Advanced OpenGL/11 Anti Aliasing.md b/docs/04 Advanced OpenGL/11 Anti Aliasing.md
index 77e835c..eac26f7 100644
--- a/docs/04 Advanced OpenGL/11 Anti Aliasing.md	
+++ b/docs/04 Advanced OpenGL/11 Anti Aliasing.md	
@@ -4,67 +4,69 @@
       ---|---
 作者     | JoeyDeVries
 翻译     | [Django](http://bullteacher.com/)
-校对     | [Geequlim](http://geequlim.com)
+校对     | [Geequlim](http://geequlim.com),[KenLee](https://hellokenlee.github.io/)
 
-在你的渲染大冒险中，你可能会遇到模型边缘有锯齿的问题。**锯齿边(Jagged Edge)**出现的原因是由顶点数据像素化之后成为片段的方式所引起的。下面是一个简单的立方体，它体现了锯齿边的效果：
+在你的渲染大冒险中，你可能会遇到模型边缘有锯齿的问题。**锯齿边缘(Jagged Edge)**出现的原因是由顶点数据光栅化成为片元(fragment)的方式所引起的。举个例子，我们随手绘制一个简单的正方体就已经能很清楚地看到锯齿边缘的效果：
 
 ![](../img/04/11/anti_aliasing_aliasing.png)
 
-也许不是立即可见的，如果你更近的看看立方体的边，你就会发现锯齿了。如果我们放大就会看到下面的情境：
+尽管可能不会被立刻察觉到，如果你更近的看看立方体的边，你就会发现锯齿状的图案。如果我们放大就会看到下面的情境：
 
 ![](../img/04/11/anti_aliasing_zoomed.png)
 
-这当然不是我们在最终版本的应用里想要的效果。这个效果，很明显能看到边是由像素所构成的，这种现象叫做**走样(Aliasing)**。有很多技术能够减少走样，产生更平滑的边缘，这些技术叫做**抗锯齿技术**(Anti-aliasing，也被称为反走样技术)。
+这当然不是我们在实际应用中想要的效果。这个效果，我们很明显能看到边缘像素的形态，这种现象被称之为**走样(Aliasing)**。有很多技术能够减少走样现象，产生更平滑的边缘，这些技术叫做**抗锯齿技术**(Anti-aliasing，也被称为反走样技术)。
 
-首先，我们有一个叫做**超级采样抗锯齿技术(Super Sample Anti-aliasing, SSAA)**，它暂时使用一个更高的解析度（以超级采样方式）来渲染场景，当视频输出在帧缓冲中被更新时，解析度便降回原来的普通解析度。这个额外的解析度被用来防止锯齿边。虽然它确实为我们提供了一种解决走样问题的方案，但却由于必须绘制比平时更多的片段而降低了性能。所以这个技术只流行了一段时间。
+最开始我们有一个叫做**超采样抗锯齿技术(Super Sample Anti-aliasing, SSAA)**，它暂时使用一个更高的分辨率（以超采样方式）来渲染场景，当输出图像在帧缓冲中被更新时，图像的分辨率会被下采样(down sample)回原来的分辨率。它使用额外的分辨率来防止锯齿边缘。虽然它确实为我们提供了一种解决走样问题的方案，但却由于必须绘制比平时更多的片段而降低了性能。所以这个技术只流行了一段时间。
 
-这个技术的基础上诞生了更为现代的技术，叫做**多采样抗锯齿(Multisample Anti-aliasing)**或叫MSAA，虽然它借用了SSAA的理念，但却以更加高效的方式实现了它。这节教程我们会展开讨论这个MSAA技术，它是OpenGL内建的。
+这个技术的基础上诞生了更为现代的技术，叫做**多采样抗锯齿(Multisample Anti-aliasing)**或叫**MSAA**，虽然它借用了SSAA的理念，但却以更加高效的方式实现了它。这节教程我们会展开讨论这个OpenGL内建的MSAA技术。
 
 ## 多重采样
 
-为了理解什么是多重采样(Multisampling)，以及它是如何解决锯齿问题的，我们先要更深入了解一个OpenGL光栅化的工作方式。
+为了理解什么是多重采样(Multisampling)，以及它是如何解决锯齿问题的，我们先要更深入了解一下OpenGL光栅化的工作方式。
 
-光栅化是你的最终的经处理的顶点和片段着色器之间的所有算法和处理的集合。光栅化将属于一个基本图形的所有顶点转化为一系列片段。顶点坐标理论上可以含有任何坐标，但片段却不是这样，这是因为它们与你的窗口的解析度有关。几乎永远都不会有顶点坐标和片段的一对一映射，所以光栅化必须以某种方式决定每个特定顶点最终结束于哪个片段/屏幕坐标上。
+光栅化表示在我们输出的顶点(Vertices)和片元着色器(fragment shader)中间的所有算法和处理过程的集合(译者注： 在OpenGL中，光栅化步骤在几何着色器后，片元着色器前)。光栅化将属于一个基本图形的所有顶点转化为一系列片元。顶点坐标理论上可以是任意值，但片元却不是这样，这是因为它们受你的窗口的分辨率限制。几乎永远都不会有顶点坐标和片元的一对一映射，所以光栅化必须以某种方式决定每个顶点最终位于哪个片元/屏幕坐标上。
 
 ![](../img/04/11/anti_aliasing_rasterization.png)
 
-这里我们看到一个屏幕像素网格，每个像素中心包含一个采样点（sample point），它被用来决定一个像素是否被三角形所覆盖。红色的采样点如果被三角形覆盖，那么就会为这个被覆盖像（屏幕）素生成一个片段。即使三角形覆盖了部分屏幕像素，但是采样点没被覆盖，这个像素仍然不会受到任何片段着色器影响到。
+这里我们看到一个屏幕像素网格，每个像素中心包含一个采样点（sample point），它被用来决定一个像素是否被三角形所覆盖。红色的采样点表示该点被三角形所覆盖，片元着色器会给该屏幕像素着色。不过即使三角形覆盖了某一个屏幕像素的一部分，但是中心的采样点没被覆盖到，这个像素仍然不会受到片段着色器的影响。
 
-你可能已经明白走样的原因来自何处了。三角形渲染后的版本最后在你的屏幕上是这样的：
+你可能现在已经明白走样的原因是什么了。上述三角形渲染后在你的屏幕上会是这样的：
 
 ![](../img/04/11/anti_aliasing_rasterization_filled.png)
 
-由于屏幕像素总量的限制，有些边上的像素能被渲染出来，而有些则不会。结果就是我们渲染出的基本图形的非光滑边缘产生了上图的锯齿边。
+由于屏幕像素总量的限制，有些边上的像素能被渲染出来，而有些则不会。结果就是我们渲染出的基本图形的边缘产生了上图的锯齿。
 
-多采样所做的正是不再使用单一采样点来决定三角形的覆盖范围，而是采用多个采样点。我们不再使用每个像素中心的采样点，取而代之的是4个子样本（subsample），用它们来决定像素的覆盖率。这意味着颜色缓冲的大小也由于每个像素的子样本的增加而增加了。
+多采样所做的正是不再使用单一采样点来决定三角形的覆盖范围，而是采用多个采样点(这大概就是它名字的由来)。我们不再使用每个像素中心的采样点，取而代之的是4个子采样（subsample），用它们来决定像素是否被覆盖。这意味着颜色缓冲的大小也由于每个像素的子样本的增加而增加了。
 
 ![](../img/04/11/anti_aliasing_sample_points.png)
 
-左侧的图显示了我们普通决定一个三角形的覆盖范围的方式。这个像素并不会运行一个片段着色器（这就仍保持空白），因为它的采样点没有被三角形所覆盖。右边的图展示了多采样的版本，每个像素包含4个采样点。这里我们可以看到只有2个采样点被三角形覆盖。
+上图的左侧显示了我们普通决定一个三角形是否覆盖屏幕像素的方式(译者注： 中心点，单采样)。这个像素并不会被一个片元着色器着色（因此它保持空白），因为它的采样点没有被三角形所覆盖。右边示了多采样的版本，每个像素包含4个采样点。这里我们可以看到只有2个采样点被三角形覆盖。
 
 !!! Important
 
     采样点的数量是任意的，更多的采样点能带来更精确的覆盖率。
 
-多采样开始变得有趣了。2个子样本被三角覆盖，下一步是决定这个像素的颜色。我们原来猜测，我们会为每个被覆盖的子样本运行片段着色器，然后对每个像素的子样本的颜色进行平均化。例子的那种情况，我们在插值的顶点数据的每个子样本上运行片段着色器，然后将这些采样点的最终颜色储存起来。幸好，它不是这么运作的，因为这等于说我们必须运行更多的片段着色器，会明显降低性能。
+从这儿开始我们的多重采样变得有趣起来了。我们知道了只有2个子采样被三角覆盖，下一步就是决定这个像素的颜色。我们可以猜测一下，我们会为每个被覆盖的子采样运行片元着色器，然后对每个像素的所有子采样的颜色进行平均化。在这种情况下，我们需要为每一个被插值后的顶点数据的每一个子采样运行两次两次片元着色器，然后把采样点的颜色储存起来。幸好，它不是这么运作的，因为这等于说我们必须运行更多的片段着色器，会明显降低性能。
 
-MSAA的真正工作方式是，每个像素只运行一次片段着色器，无论多少子样本被三角形所覆盖。片段着色器运行着插值到像素中心的顶点数据，最后颜色被储存近每个被覆盖的子样本中，每个像素的所有颜色接着将平均化，每个像素最终有了一个唯一颜色。在前面的图片中4个样本中只有2个被覆盖，像素的颜色将以三角形的颜色进行平均化，颜色同时也被储存到其他2个采样点，最后生成的是一种浅蓝色。
+MSAA的真正工作方式是，每个像素只运行一次片元着色器，无论该像素有多少子样本被三角形所覆盖。片元着色器接受的顶点数据是被插值到每一个像素的**中心**坐标，而其着色的颜色会被每个被三角形覆盖的子采样储存。一旦一个我们绘制的基本图形的子采样颜色缓冲被填满了，每个像素对应的所有颜色将会被平均化，这使得每个像素最终有了一个唯一颜色。比如在前面的图片中4个子采样中只有2个被三角形覆盖，像素的颜色事实上是一个均值，该均值由三角形的颜色和其他2个子采样的颜色(aka. 背景色)平均化而成，最后该像素被着色为一种浅蓝色。
 
-结果是，颜色缓冲中所有基本图形的边都生成了更加平滑的样式。让我们看看当再次决定前面的三角形覆盖范围时多样本看起来是这样的：
+结果是，颜色缓冲中所有基本图形的边变得更加平滑了。让我们看看多重采样对前面的一个三角形来说是怎样做的：
 
 ![](../img/04/11/anti_aliasing_rasterization_samples.png)
 
-这里每个像素包含着4个子样本（不相关的已被隐藏）蓝色的子样本是被三角形覆盖了的，灰色的没有被覆盖。三角形内部区域中的所有像素都会运行一次片段着色器，它输出的颜色被储存到所有4个子样本中。三角形的边缘并不是所有的子样本都会被覆盖，所以片段着色器的结果仅储存在部分子样本中。根据被覆盖子样本的数量，最终的像素颜色由三角形颜色和其他子样本所储存的颜色所决定。
+这里每个像素包含着4个子采样（不相关采样点的没有被标注出来）蓝色的子采样是被三角形覆盖了的，灰色的则没有被覆盖。三角形内部区域中的所有像素都会运行一次片元着色器，它输出的颜色由4个子采样决定。三角形的边缘并不是所有的子采样都会被覆盖，所以片段着色器的结果仅由部分的子采样决定。根据被覆盖子采样的数量，最终的像素颜色由三角形颜色和其他子采样所储存的颜色所决定。(译者注： 其实有点类似于Blending的原理。)
 
-大致上来说，如果更多的采样点被覆盖，那么像素的颜色就会更接近于三角形。如果我们用早期使用的三角形的颜色填充像素，我们会获得这样的结果：
+大致上来说，如果更多的采样点被覆盖，那么像素的颜色就会更接近于三角形。如果我们用这种方去给我们前面的三角形的填充像素颜色，我们会获得这样的结果：
 
 ![](../img/04/11/anti_aliasing_rasterization_samples_filled.png)
 
-对于每个像素来说，被三角形覆盖的子样本越少，像素受到三角形的颜色的影响也越少。现在三角形的硬边被比实际颜色浅一些的颜色所包围，因此观察者从远处看上去就比较平滑了。
+对于每个像素来说，被三角形覆盖的子采样越少，像素受到三角形的颜色的影响也越少。现在原本三角形不平滑的边被比实际颜色浅一些的颜色像素所包围，因此观察者从远处看上去就比较平滑了。
 
-不仅颜色值被多采样影响，深度和模板测试也同样使用了多采样点。比如深度测试，顶点的深度值在运行深度测试前被插值到每个子样本中，对于模板测试，我们为每个子样本储存模板值，而不是每个像素。这意味着深度和模板缓冲的大小随着像素子样本的增加也增加了。
+不仅颜色值会被多重采样技术影响，深度测试和模板测试也同样使用了多重采样技术。比如深度测试，顶点的深度值在运行深度测试前被插值到每个子采样中，对于模板测试，我们为每个子采样储存模板值，而不是每个像素。这意味着深度和模板缓冲的大小随着像素子样本的增加也增加了。
+
+到目前为止我们所讨论的不过是多重采样技术的工作原理。光栅化背后实际的逻辑要比我们讨论的复杂，但你现在可以理解MSAA背后的概念和逻辑了。
+(译者注： 如果看到这里还是对原理似懂非懂，可以简单看看知乎上[@文刀秋二](https://www.zhihu.com/people/edliu/answers) 对抗锯齿技术的[精彩介绍](https://www.zhihu.com/question/20236638/answer/14438218))
 
-到目前为止我们所讨论的不过是多采样发走样工作的方式。光栅化背后实际的逻辑要比我们讨论的复杂，但你现在可以理解多采样抗锯齿背后的概念和逻辑了。
 
 ## OpenGL中的MSAA
 

From 5d4b903561e9673e5cba9caa912c4b360591f8c1 Mon Sep 17 00:00:00 2001
From: kenlee <ken4000kl@gmail.com>
Date: Sun, 9 Apr 2017 15:41:19 +0800
Subject: [PATCH 13/19] fiex some nouns translation

---
 docs/04 Advanced OpenGL/11 Anti Aliasing.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/04 Advanced OpenGL/11 Anti Aliasing.md b/docs/04 Advanced OpenGL/11 Anti Aliasing.md
index eac26f7..ace02dc 100644
--- a/docs/04 Advanced OpenGL/11 Anti Aliasing.md	
+++ b/docs/04 Advanced OpenGL/11 Anti Aliasing.md	
@@ -6,7 +6,7 @@
 翻译     | [Django](http://bullteacher.com/)
 校对     | [Geequlim](http://geequlim.com),[KenLee](https://hellokenlee.github.io/)
 
-在你的渲染大冒险中，你可能会遇到模型边缘有锯齿的问题。**锯齿边缘(Jagged Edge)**出现的原因是由顶点数据光栅化成为片元(fragment)的方式所引起的。举个例子，我们随手绘制一个简单的正方体就已经能很清楚地看到锯齿边缘的效果：
+在你的渲染大冒险中，你可能会遇到模型边缘有锯齿的问题。**锯齿边缘(Jagged Edge)**出现的原因是由顶点数据光栅化成为片段(fragment)的方式所引起的。举个例子，我们随手绘制一个简单的正方体就已经能很清楚地看到锯齿边缘的效果：
 
 ![](../img/04/11/anti_aliasing_aliasing.png)
 
@@ -24,37 +24,37 @@
 
 为了理解什么是多重采样(Multisampling)，以及它是如何解决锯齿问题的，我们先要更深入了解一下OpenGL光栅化的工作方式。
 
-光栅化表示在我们输出的顶点(Vertices)和片元着色器(fragment shader)中间的所有算法和处理过程的集合(译者注： 在OpenGL中，光栅化步骤在几何着色器后，片元着色器前)。光栅化将属于一个基本图形的所有顶点转化为一系列片元。顶点坐标理论上可以是任意值，但片元却不是这样，这是因为它们受你的窗口的分辨率限制。几乎永远都不会有顶点坐标和片元的一对一映射，所以光栅化必须以某种方式决定每个顶点最终位于哪个片元/屏幕坐标上。
+光栅化表示在我们输出的顶点(Vertices)和片段着色器(fragment shader)中间的所有算法和处理过程的集合(译者注： 在OpenGL中，光栅化步骤在几何着色器后，片段着色器前)。光栅化将属于一个图元的所有顶点转化为一系列片段。顶点坐标理论上可以是任意值，但片段却不是这样，这是因为它们受你的窗口的分辨率限制。几乎永远都不会有顶点坐标和片段的一对一映射，所以光栅化必须以某种方式决定每个顶点最终位于哪个片段/屏幕坐标上。
 
 ![](../img/04/11/anti_aliasing_rasterization.png)
 
-这里我们看到一个屏幕像素网格，每个像素中心包含一个采样点（sample point），它被用来决定一个像素是否被三角形所覆盖。红色的采样点表示该点被三角形所覆盖，片元着色器会给该屏幕像素着色。不过即使三角形覆盖了某一个屏幕像素的一部分，但是中心的采样点没被覆盖到，这个像素仍然不会受到片段着色器的影响。
+这里我们看到一个屏幕像素网格，每个像素中心包含一个采样点（sample point），它被用来决定一个像素是否被三角形所覆盖。红色的采样点表示该点被三角形所覆盖，片段着色器会给该屏幕像素着色。不过即使三角形覆盖了某一个屏幕像素的一部分，但是中心的采样点没被覆盖到，这个像素仍然不会受到片段着色器的影响。
 
 你可能现在已经明白走样的原因是什么了。上述三角形渲染后在你的屏幕上会是这样的：
 
 ![](../img/04/11/anti_aliasing_rasterization_filled.png)
 
-由于屏幕像素总量的限制，有些边上的像素能被渲染出来，而有些则不会。结果就是我们渲染出的基本图形的边缘产生了上图的锯齿。
+由于屏幕像素总量的限制，有些边上的像素能被渲染出来，而有些则不会。结果就是我们渲染出的图元的边缘产生了上图的锯齿。
 
 多采样所做的正是不再使用单一采样点来决定三角形的覆盖范围，而是采用多个采样点(这大概就是它名字的由来)。我们不再使用每个像素中心的采样点，取而代之的是4个子采样（subsample），用它们来决定像素是否被覆盖。这意味着颜色缓冲的大小也由于每个像素的子样本的增加而增加了。
 
 ![](../img/04/11/anti_aliasing_sample_points.png)
 
-上图的左侧显示了我们普通决定一个三角形是否覆盖屏幕像素的方式(译者注： 中心点，单采样)。这个像素并不会被一个片元着色器着色（因此它保持空白），因为它的采样点没有被三角形所覆盖。右边示了多采样的版本，每个像素包含4个采样点。这里我们可以看到只有2个采样点被三角形覆盖。
+上图的左侧显示了我们普通决定一个三角形是否覆盖屏幕像素的方式(译者注： 中心点，单采样)。这个像素并不会被一个片段着色器着色（因此它保持空白），因为它的采样点没有被三角形所覆盖。右边示了多采样的版本，每个像素包含4个采样点。这里我们可以看到只有2个采样点被三角形覆盖。
 
 !!! Important
 
     采样点的数量是任意的，更多的采样点能带来更精确的覆盖率。
 
-从这儿开始我们的多重采样变得有趣起来了。我们知道了只有2个子采样被三角覆盖，下一步就是决定这个像素的颜色。我们可以猜测一下，我们会为每个被覆盖的子采样运行片元着色器，然后对每个像素的所有子采样的颜色进行平均化。在这种情况下，我们需要为每一个被插值后的顶点数据的每一个子采样运行两次两次片元着色器，然后把采样点的颜色储存起来。幸好，它不是这么运作的，因为这等于说我们必须运行更多的片段着色器，会明显降低性能。
+从这儿开始我们的多重采样变得有趣起来了。我们知道了只有2个子采样被三角覆盖，下一步就是决定这个像素的颜色。我们可以猜测一下，我们会为每个被覆盖的子采样运行片段着色器，然后对每个像素的所有子采样的颜色进行平均化。在这种情况下，我们需要为每一个被插值后的顶点数据的每一个子采样运行两次两次片段着色器，然后把采样点的颜色储存起来。幸好，它不是这么运作的，因为这等于说我们必须运行更多的片段着色器，会明显降低性能。
 
-MSAA的真正工作方式是，每个像素只运行一次片元着色器，无论该像素有多少子样本被三角形所覆盖。片元着色器接受的顶点数据是被插值到每一个像素的**中心**坐标，而其着色的颜色会被每个被三角形覆盖的子采样储存。一旦一个我们绘制的基本图形的子采样颜色缓冲被填满了，每个像素对应的所有颜色将会被平均化，这使得每个像素最终有了一个唯一颜色。比如在前面的图片中4个子采样中只有2个被三角形覆盖，像素的颜色事实上是一个均值，该均值由三角形的颜色和其他2个子采样的颜色(aka. 背景色)平均化而成，最后该像素被着色为一种浅蓝色。
+MSAA的真正工作方式是，每个像素只运行一次片段着色器，无论该像素有多少子样本被三角形所覆盖。片段着色器接受的顶点数据是被插值到每一个像素的**中心**坐标，而其着色的颜色会被每个被三角形覆盖的子采样储存。一旦一个我们绘制的图元的子采样颜色缓冲被填满了，每个像素对应的所有颜色将会被平均化，这使得每个像素最终有了一个唯一颜色。比如在前面的图片中4个子采样中只有2个被三角形覆盖，像素的颜色事实上是一个均值，该均值由三角形的颜色和其他2个子采样的颜色(aka. 背景色)平均化而成，最后该像素被着色为一种浅蓝色。
 
-结果是，颜色缓冲中所有基本图形的边变得更加平滑了。让我们看看多重采样对前面的一个三角形来说是怎样做的：
+结果是，颜色缓冲中所有图元的边变得更加平滑了。让我们看看多重采样对前面的一个三角形来说是怎样做的：
 
 ![](../img/04/11/anti_aliasing_rasterization_samples.png)
 
-这里每个像素包含着4个子采样（不相关采样点的没有被标注出来）蓝色的子采样是被三角形覆盖了的，灰色的则没有被覆盖。三角形内部区域中的所有像素都会运行一次片元着色器，它输出的颜色由4个子采样决定。三角形的边缘并不是所有的子采样都会被覆盖，所以片段着色器的结果仅由部分的子采样决定。根据被覆盖子采样的数量，最终的像素颜色由三角形颜色和其他子采样所储存的颜色所决定。(译者注： 其实有点类似于Blending的原理。)
+这里每个像素包含着4个子采样（不相关采样点的没有被标注出来）蓝色的子采样是被三角形覆盖了的，灰色的则没有被覆盖。三角形内部区域中的所有像素都会运行一次片段着色器，它输出的颜色由4个子采样决定。三角形的边缘并不是所有的子采样都会被覆盖，所以片段着色器的结果仅由部分的子采样决定。根据被覆盖子采样的数量，最终的像素颜色由三角形颜色和其他子采样所储存的颜色所决定。(译者注： 其实有点类似于Blending的原理。)
 
 大致上来说，如果更多的采样点被覆盖，那么像素的颜色就会更接近于三角形。如果我们用这种方去给我们前面的三角形的填充像素颜色，我们会获得这样的结果：
 

From bdbe436d76f464729f39ff98ddcb836d191644bc Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Mon, 24 Apr 2017 18:51:27 +0800
Subject: [PATCH 14/19] Implement #64

---
 docs/css/style.css        |   7 +++++++
 docs/index.md             |   2 ++
 yeti/img/patreon_logo.png | Bin 0 -> 10195 bytes
 yeti/nav.html             |   6 ++++++
 4 files changed, 15 insertions(+)
 create mode 100644 yeti/img/patreon_logo.png

diff --git a/docs/css/style.css b/docs/css/style.css
index 98e3b47..300a8cb 100644
--- a/docs/css/style.css
+++ b/docs/css/style.css
@@ -128,3 +128,10 @@ var {
     font-family: "Courier New", Courier, monospace;
     color: #227;
 }
+
+img.patreon {
+	border: none;
+	display: inline-block;
+	max-height: 13px;
+	margin-bottom: 2px;
+}
\ No newline at end of file
diff --git a/docs/index.md b/docs/index.md
index 166d31b..6960e38 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -2,6 +2,8 @@
 
 欢迎来到OpenGL的世界。这个工程只是我([JoeyDeVries](http://joeydevries.com/))的一次小小的尝试，希望能够建立起一个完善的OpenGL教学平台。无论你学习OpenGL是为了学业，找工作，或仅仅是因为兴趣，这个网站都将能够教会你**现代**(Core-profile) OpenGL的基础，中级，以及高级知识。LearnOpenGL的目标是使用易于理解的形式，使用清晰的例子，展现现代OpenGL的所有知识点，与此同时为以后的学习提供有用的参考。
 
+如果您喜欢这个系列教程的话，不妨到JoeyDeVries的[Patreon](https://www.patreon.com/learnopengl)上支持一下作者，让这个教程能够持续完善并更新。
+
 ## 为什么要阅读这些教程呢？
 
 <img alt="Image of smiling textured containers in OpenGL" src="img/index_image2.png" class="right medium" />
diff --git a/yeti/img/patreon_logo.png b/yeti/img/patreon_logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..79aafc5acc178ded7a54957bbd0c9019eb334714
GIT binary patch
literal 10195
zcmaKS2|Uwr|M+H@n~{{96B3y#$0A{la)ph}J&Z8SF;^vOGL#}$IlAPS(Ga=HA|*<f
zIa4c1Oh`E*`hC~){GQ+Qd;R~<@Ab0R%lG|#-`D5;`Fy^a$DM3Ng=B?5Adu)$JCrL3
z1lHpI1o#0+(&-#B2*k@9ipIua9UYK?Q4!kspr`<Xc47nxcn<=ZnkSO*f#HNWr2s-m
zXrvi@v7-yF6dGg(_c-XN<4Ce1oCvi`jv=@uJD~%U!vjr%;O2*gOcRj+g9t(#UMVqx
z7#WL9G=u-;iv<4Xf)Q|~zbJ9xW^k<IaV4v$7=qG4?StAn@WVn%rZGXmNLQ52KZ$`S
zGx&+PI1&<pNJvP~PSDqmiU~pJnwXd%bo3B<dItcE1F=bwarndok+CXV7XRRZBE$y9
zgp%Syqau~KJn;ch<Tx`p9C)wvPv&u<!T-ZOGWMV51CBs&-yn3gbrAoK4w&^XUH%t#
zBA)dBLw0ohztJNi{ule$I9I}dQ0Kn|#G;c(1cWOgHi{e*NC41P{#`#pVrZ~6_Fpms
zLrHk;FcN|b{(scNlYy}O)35)_mVaRb82?a@>kH)32z&^^fe;xIcft&=ucPx<?*F{;
z2o3u87l5abRxt#8TvQA?DvD?Zx8Nq0((w~faZ#}+qDV?sR!Vw0x&})79PxpnkzAn0
zUycBwqazX(6-bUCM8+LOnZW^wc2H;#(n`+&bx;rZv(Yor)wMooVTH1^uraXKv#`)N
zF|x7wH}a#Av2pmwK*E2MhyD+_!T(AA4+kOvGh-d2f(U@#f4Ksl_zMFbx!I*;`cEwh
zF`@B<Ae)$|h`%}YH-5;V|E#<I|0!JQAM~OBS$VzxNRRlN^$2d7|6AH~tLZNcC?}vU
z5&tSo;Nf4TO^5{QIR+@)fTMewf##4FYGrji*45Th>8Q1pp{|Lc;Q>8uT@YwrE;;w5
zCdy^UQ*(VAHJcsT8aomAgP(03iCQ)((mVB?cN2r(|91Tm?7MhzuNR?qU&HtCM}ACq
zoTha}#XLPzG<mSZMdfPjp|w*BYwu&**Stx!ILG^@W;bSpf)lkWp4-giUsE?-uerk)
z<<NAYrmy;#^~tW@>Bk)HD);HwKb}7D&`|cWka*~MoP>f*xwrN%u_!^K@T*wMb(FDx
zKVN#3oSE;Zkc_vg+i|1lo*s7O4)-@*#@pG=7ixqD20}-g?8jf8E-hNmYr9H)Z1~+>
ztNQ}X5`PwUUhvJpjpr8aUvGQ4qx%*$zBpeg@^%b9C+)EF=#`sCjtr^Rl;;;qnrWyE
zWWD{<b-LMg>-3$uhZ1P>@zrqX5V3pYe8d^K(bW-Uv>7w0zV!Nsj5MRyM*W_f3I_B?
zv(~umsGc$8`r^gn-I~WRpBB(UzBxA!3psimKjb$z_VTc8!j1ZV51;Nq?YRD5=hLG!
zIzswq`#RTv4lGEr!^MI?!cyEH7<8?47YL*TI*PJDCzgJjOzJEoUw!)hC12j=t9{zl
z5|LL6k0FJ!DvighTc_RiJp;e!xm^j23>?nS33adh7FOt46B-<;RS(`TQY_3ayz)s9
zg}#B(wJr?bUZ1oTzZ8;GxcTtzhsBioHO@+B>XgaLAJT(A%+{8@ct?iOWF>|)Lsf@&
zmk^PkC`9BXiqKsw^Y5n?rFx{wG(MH{*ItraqEofBl{2!7u~5?Vah7AMeCoH<OP~pm
zA}>GgOV}$o+nM>6DaCYSPQmqF8Wd<=lyT>)ne+GG%g|hUJ>PIMv^wAbNP#aHBo2Oy
z`fNR6S1;g;&2+<n4~xw6%?r*u88?R~AV6+u(A1;MEAU&Dncf4P49N;w31kzj2wmkL
zHWJN0-^C-9b~3fYI;bUDVT2b!=dGUGOuYn#5-uHxkiv8m{fVoseyBp(nP~D-cUC^F
z-fCY}Pbwsh47?qeWIM5g{Q*OC2d9$R>C!NakCZX*`d$)fT11^x>v_yLqEoEZ2elns
z`jq@Jo#24k1pg5@#lOzWXo-N2^zLESF`FqIU(Jg@?wKL9RA}vdOE|XQ_l{(ZVyHL7
zTLu17HYC)`7pv;ZVhN1g*)Ag$z5KKNHV#4B{V_kfja(f6DXLhqdQOQQWa$zSCiiqY
z<nYZ_ZJAuYVf=WSjC&fIe28t&Y*^>}x!>zptKFFzswrN+vcHodbc5Cb34uVpLZa{N
zfqL(Si+e(A;0U^0&D;q#hZ3q+|G<%NP$u_K-8poojJp_`e1`4qPl?_kbA6WC=Ii}y
zsXHu<w!nW%%KTQ$>5~%1wkQRLSe_n&u2wx~n=1T099<thmDXhaIhv!SvD_V&N{i$z
zg_eST8s$vAX_jo2U8hkygXGmzeX-;|cY9;ebs<Jhw48^0ltj)@7pK;G=&5k6_!!@c
zBFGC+vf$vJb!XV_aQVIQzF4#4EM=y6npIs>Ym2Vf`dRAlF{B-R0|%vEq^)|e+ywW?
zCF0ujE`rNlS^AAhRrTi;@#Ngetq%UtG2^UQ{nVFPeIgts-R~+|M=;Rpxi+Q>fNv}U
z-M&GashOJ_#s|D!wZ+ml@ZCHSJ#|gSBj<3;D(j#^vP5{qNy;7C7J9{?+ohnWAbU)V
za=WgnQ95kG-Ae&a=urBT$1rG!)wn7mrwK=3p$)I%BkE{@saF932H*Ieqght;bJ!Cl
z-Tm5hKZntb$jfAf8Bc}+sf3n-C`o^9IQ}VL=Mdj-QJsEdcC1MWzuW<MY~8v1o6EM?
zv0KUdON}us1Ia`O%)}>2+dIPc7-wZ-R$Cf*=Zw(3!=(GP@<{oL69uNK&-urFEJlC4
zY>SVPC*7iUhRRn66liK;CMDM8Q-r>bkHoQ$!;%2Ez2A?)j<tABrQ)Bs&;oY9$~E)l
z-wDbNQ-}%{Pwh>O|CJ2p5AO2QKS}rdF$x-`E=8?^Z`3U$OP>%U9cQ^4);Zt_G9yuZ
z+k;5^vtJ}C&zOptikdp_tC6t|BH)x8UEY;Q^oQ?a9Kh$Vty1)2FD8i^yP_5v#PW)c
z?I@(BWa-45P9+!eJ_lC@UBWT7U^wEQnkX9b@^SA&JRKpI@P$_;8$^tKQT5GYc^RLD
zHA}?TeK>NklXAtVebrFwpz?^)-$7HHRVDAca*q29MjkYwJ|7xZ_AH3Q*UT9SaOfQg
z2l!K*N6V%M<FCaQN{?<c)0huCPi{Tu`=B;Idi!)ra7CV$7Dk$F%bcleLIr?HQh0+u
zJ7BoT(x=`n0W<s9c5DHEM#QZX-h#h7sC0(dn+u<X>@k~=E>KRxU;q(}Uw`7rtUz~x
z2QK?OR}_`wlgkm``%q!sA?t(wQE7K~_b%S;USxJ|0ke#9Juh&}jut(ZJCerC9J^ak
z{_S-(Cv6H9bd`MBX0IDI!q+`kU{BO`r;l1&p#{c>FGrnt;n0wAPWqu#71#ZBdxdH*
z4ulDP6#E)M$jJyZ8q=8C#n$Tfc^aQLG>iY4Uf|>3Rk*5ATfjWP?1k&SKst1|uzXVW
z1xMO9_B_?F*Sk|-iQg(-ZQau<w{Ef&0lOL@UpZMbr^6<8YXlw=v3n?KY%;AZ{sq0V
z$Mf_6W<?e=*}t(k@t}w%_G0^VVM$6+{*>47nGergS#RloR)ktyF;T}^;+}teIv&={
zxzjdk=Ref-58m7ESa8g*qR4*X-yTQWrd5Kfvif?4ExZHKWaA}>zcWXRZzGN#D}Gy3
zOSD$|o%O-Hd!DPl%WQvrSGvLxa|!N1-W@D=M_?dTSGRsy0)r35zMMN#^IlTdK211n
z5lvR@i?5)C^Hf1*B!)L=c_XQ20bb6U*Sg;@T))QA)}+GqNO{!X*U1tdBBDkP^`O;;
z!Mr9DX1#8mw`}h{UeR#I2g~OEFkO<K&iDXr9Q7I3JtuJ;;(IXXO4UuumiTRx<O{bL
z0_J7$_r-E=Pozayf38ZYqnS~uS$!A^#x<&C@XBo%Mc30s2cd=8a;7zPyx2o|l#r3t
zcZ#D^e+s^wN0mFei?nf`TwW@7JC~>&oGhx@p^_-hD(3kvu!Kn2m_ZUoTIwP3&4YR8
z3Ybr=KOY{D2)4z_2KRrk+aTOw-cOzEq<edeHP^W?`6x!G`ZvHvv^j|Z2{oWOAwk7<
z8z-R;h2&J=Q+4NBTWjXbVf<Eq9*_%nIzm<@bMGJUeK#k-fxki2;+TWJ?)3`r7#W7t
zQZayVaj!`6L6;3!AuR{|q;RX<q@$1&y%hz7$FotHrzm&(Vx^V!=ha5PdqaRjYo9sz
zAHRCH<aPn&Tiz)z-4RKQ8DDF@z`~HxEP|OsSnNl80`XyeS9l{Y`df`er~V#9Qfv7!
zX1uLwaaAi0{Hq$V2jA&UY@y#AsO6);IKJ-MK<2W_j~KZ5$=;J8*<3|n`vGlIcoTPF
zA6yt27}IBh;me&s^c-m$V1FKb{;9C{{PD0{9HA5YF}*+(zYbvpzP^h|y~<31H!=Zn
zhL}mvF6ewf*&V?qfh!e7JGU$erIIP>1_N`--HB2NO^??3O`>`Cr<|IxG{$46k3weM
z{Z4#}st<bC)p(%Uc9<_`+fdbWo)o+}(9;c0n0y=}+2kTzM`4BMAMoB)e$aRgB=?yx
ztrZlwxvEZ#xt7ODtvxtT_bG-u3w8<2d$WJY;NheSaRG8+V<^H_@}Z)eUa5}k4W0B-
z$zZ9y*Lj9DKK&A2mcTn?D&pGq1yyAvTp2cK=>kt=_Fd0TT)vgVNU`%I9K6DaI}fZa
zHt`ka=Sf9o(&1op?YU>M=H0F=NNT<suQ_CXHUZ*8Z&Vh)ax}bj_z^sBv-G1kuo`@T
znhI7lW`F1Lr-%!Y8wU7`oS=q{gRWI$6t^Dlr@_;wk0r{^=CevD*Li>#B##}usY_X$
z*g>=y<vHNdCJ(es8)j2Q^tUioQvOTPxSD5b4j(LKYfU@BL{&IqdWDj-?fgePG+&yc
z8UW;GOrzjizs5nAs^+w)&%Y>ba(IHuc*x}^8}lPseN}Z<#v?+Q2j>lTg1rSrUWP+w
zJB2v$Y_@56t$&k1iS;`3c+oxL^cxMPZC%q4zLR?4*;J;dHn2*S8K@B-9>bnH-9na_
zS-wH*5r`$bjgEc_gfAbdb<VTJJHoX-OY5sX7k3Cfh1EloPy0{KUs_yTzK*;famEL=
zv!H}#7S!?mg8Fv$l6Y2MdEMco_UU(Mn^J1RPZzx4F)d^&nqdAcfwu*G9$XUARe#-V
zE~$ymyAw9dv#508?W~f>yE48wD)r0N4xegZ9T_n0T>!z_nhMlUG&3r}DxOI>lBSle
zk<HJMc0y>fnZJ?0c(+{3$Ig>K(G??tMv;}0+PV%aw;MNtH1|3vZ_8I!W%u>Dm*1EL
zqIe0C(7gOfH4!rUEFowC*J9Eq(4D8YDdpa2Fy?>%ykz~$3+i&c&WPBib3@g0?v!r7
z38cNEC$c~64nqz0r@8hD>hm#<M1u=PIe*9;VhcVOA;lsbCh3z@bb6f?KiFf;g}n)7
zx5eG8D`r{h*Y?v<3nK5e;TfJ8)J$5Wh#WA85kpHVRbN8PA@%*SJIK=2b5Ut3^w^(x
zXIK*BDuUR;2vAID-Zkou`r-x61V%l}(VSUQcmHKf15c}TD;8CW%gD4?wVDlef8e#J
zBpM!bT;FeWsqQ#tGN*MwsC%fS1)+(V^usKwYdIwvu=Z;T=xgSHwmmS4XjbKWUQC{R
z^q0f4#vy@?W4fZ@!SgorKZ?~L5vM1QVb-24u$`2MLt|n#;DqYAd&E}9Lmjf~56INR
z1}qiPGD+H;lD{^?MjzpR_6~CuzO2qs+Sz#BvxsNYGbEFVVh=SMu3vDBA0h2zRFVr7
zwD`^&w3C8w+hWzFqHtjE(Hz1Z8mDINlHmR32lTVAnSr$ABtyxrI%;1NGkw@3xdFKp
zbuq<d5}3Kz_r(0)+W1xMjZKR{?JeLNjJZj>&il|Asp;a06)1(nyIRCtD~V@+x>0a~
zy4S=-q;scNQY=(#u}~Nwt8~l>kae!9quGc}U=>*~S7=Blj8TJ_TjBf`sgRuGE5a`;
zn>=KPKmD*l>&`Wv-%pSz9D2pSdnI#parnuXBmO{F>_*z*P@mOqOk*U4hF*o@eX1z5
zcGab-Wb>{dq2K4IreVO;H>RdoB)KMj3H>{tbgh`9CaCMm`bY_N(tUUa+%j0-wo>z6
zg+4`HJF{vO;p$!jOL0xcO;7D*TVUk5<ZwMm>mbq=kyE=SwW)QJ7(;~WRQxhc$64%p
z?K^wu9IYLSSC~9MjN5-gnN&e_0L-o+7WXJ-#_s-+M9E$}?G$-;Mj+hpla{6cr^(|1
z{V?CVj3SH+KX|Qru3^|BE59tpC%o)7w1h|T?u-;igN`*KV);v><Zs#0HVEty<|e%f
z{SL(TpluxFDDiE|empI8yFJDKrzdvII0w5}?X3!biOblRMe{|ygZ!a=HN|X2w)}RQ
zruNBw@=5ukgYl`o>paI1;2i(tEkRUWir`3CAIG?`22%et4!)^$f~4G{>H2b>^;lEF
zyBctNj4J^2TE^i5=fZbe_1zsGepA#cwOYNm_AK4ruMnDP2bJKcbwB;NB51aKu6hp1
z<oQ&3sMSk)#Jt}Lvema=p@?cXZ{KX7<)!#dnIkue6%vumRW&<p8O05L2+pzQ1g`8{
z5r*hg`zbvU_6zcADC;_(SJ|sWW^;86u>m9dNbMG}%SM>35H=4-uHI_~6W3=&A4xsw
z^S*7ut(z#+XW2jYz6KVX`l9yU$t>D};Ja*bAL^K%f7gCd?HBwMbMeQ9Z_WsQyvLZ(
za5Iy~f3rSC;KT2;D(DZ>XWvi6^+tl0CiXi{J$r9!-Zc37BKa%9sJ>h%+(8%T*_fC3
z^s<50p{$iz!`WTD@94BzFX*$^7|I%km^^>ITuAdt?{9T#pEpOsq&<H<VUAq80cAsn
zm6zf09|C(=Pb!}huDo}{0-M(81)R*($8fjC75XVwx<MJbVdY-HI|ktgJ>&iD4i);Y
z5neygg=Vo_C`R5P-6>*Xs6g7YEzb1gmUKy^x>bS)_79qLIrw*dF8R7j0^i4Es{P2u
z<D{TBjQP{jQ+;b&?VIfV=>?9~qa7CvMBASsk0>;Xs+_`2g&FJYG56rpeb{9aVuf&T
z=r^Vl{W_l7XQQw4G5ukg(cQt5KyU8e`6<PNf!xWXD4A<LY~h(J-6KqKR1Ro-Ks9~6
z0%;a)Nl3!Y#Rtw23QQCcwY1$RzTka9fsK(ZfX^O;n;-YWp3J{;Te+)Q?A3nEWI02y
zuC`nXLxuvbp?*KT+AuCYR4zHFTt9tTM(X^m`sqhLm__Bmj=S25Qr1C=9ErL<!(+Yz
zBKHR0^a{fpk10Ngr4&p?UaFyk7HW^+wp4uGF-D%4wfkbPv*u67-zDeBmaxPWXOoW^
zH-6SxDfX9Ff<E(`B9To-kVnJ<<W?RYLy!;9cU5J+3zfeiJ?1<K8#eLQu&EBa;5IG`
zo7#*h@SXF-DjqPg^HY$?m7!bR`>Ht%_O2Oh5ql*BOUhk8e^7LBBcoV2Jdd2}UOiX;
zIBA3>9g<Ibk{EgiCRGO+8m-|dZh))jDjyr!?0cf>y~m}knd##*$PjyVOJf)uM!dWt
zwX^^mUbVp|Um*fx!xQGmVUyC#p2jnO(7o#qPgY$=3Wp!Mtz<UaH(2Gig7ZJfkr+gs
zVJC7VUi80DkRLV)>wN26mc9Z5aIS{Q-@uLWF2BUhkSd+*PC56CzCW}0(=7xa5x%2B
zy<sc;U;uBlcIwyuCKF&|j1mqw`R4(by1Ciqa{2Q{u~%mgC)_1Re7rIY_SAWcJaSPy
ze%l5(hgzcHix)cmP&>UcPM{wT#I-KJfEwCI7gZG>x~a%0Am_=(x@y%v7XU^Xonlmo
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
NN3ESu^_Ko;{|iS7Z;k)}

literal 0
HcmV?d00001

diff --git a/yeti/nav.html b/yeti/nav.html
index 681c905..050b68b 100644
--- a/yeti/nav.html
+++ b/yeti/nav.html
@@ -66,6 +66,12 @@
                     </a>
                 </li>
                 {% endif %}
+                <li>
+                    <a href="https://www.patreon.com/learnopengl">
+                            <img class="patreon" src="/img/patreon_logo.png" alt="">
+                        Patreon
+                    </a>
+                </li>
             </ul>
         </div>
     </div>

From 43459c9edc96a88537cb636ca4747bd9293e8778 Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Mon, 24 Apr 2017 19:12:08 +0800
Subject: [PATCH 15/19] Update front page

---
 docs/index.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/index.md b/docs/index.md
index 6960e38..47c8bab 100644
--- a/docs/index.md
+++ b/docs/index.md
@@ -1,8 +1,8 @@
 # 欢迎来到OpenGL的世界
 
-欢迎来到OpenGL的世界。这个工程只是我([JoeyDeVries](http://joeydevries.com/))的一次小小的尝试，希望能够建立起一个完善的OpenGL教学平台。无论你学习OpenGL是为了学业，找工作，或仅仅是因为兴趣，这个网站都将能够教会你**现代**(Core-profile) OpenGL的基础，中级，以及高级知识。LearnOpenGL的目标是使用易于理解的形式，使用清晰的例子，展现现代OpenGL的所有知识点，与此同时为以后的学习提供有用的参考。
+欢迎来到OpenGL的世界。这个工程只是我([Joey de Vries](http://joeydevries.com/))的一次小小的尝试，希望能够建立起一个完善的OpenGL教学平台。无论你学习OpenGL是为了学业，找工作，或仅仅是因为兴趣，这个网站都将能够教会你**现代**(Core-profile) OpenGL的基础，中级，以及高级知识。LearnOpenGL的目标是使用易于理解的形式，使用清晰的例子，展现现代OpenGL的所有知识点，与此同时为以后的学习提供有用的参考。
 
-如果您喜欢这个系列教程的话，不妨到JoeyDeVries的[Patreon](https://www.patreon.com/learnopengl)上支持一下作者，让这个教程能够持续完善并更新。
+如果您喜欢这个系列教程的话，不妨到Joey de Vries的[Patreon](https://www.patreon.com/learnopengl)上支持一下作者，让这个教程能够持续完善并更新。
 
 ## 为什么要阅读这些教程呢？
 

From e87f76ec53ce282fa30c10d52246f66ea04dbfdb Mon Sep 17 00:00:00 2001
From: kenlee <ken4000kl@gmail.com>
Date: Wed, 26 Apr 2017 15:27:11 +0800
Subject: [PATCH 16/19] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=BA=86Normal=20Mappi?=
 =?UTF-8?q?ng=E7=AB=A0=E8=8A=82=E7=9A=84=E6=8E=92=E7=89=88=E5=92=8C?=
 =?UTF-8?q?=E7=BF=BB=E8=AF=91=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/05 Advanced Lighting/04 Normal Mapping.md | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/docs/05 Advanced Lighting/04 Normal Mapping.md b/docs/05 Advanced Lighting/04 Normal Mapping.md
index c8e0963..63049e2 100644
--- a/docs/05 Advanced Lighting/04 Normal Mapping.md	
+++ b/docs/05 Advanced Lighting/04 Normal Mapping.md	
@@ -224,12 +224,17 @@ void main()
 
 我们先将所有TBN向量变换到我们所操作的坐标系中，现在是世界空间，我们可以乘以model矩阵。然后我们创建实际的TBN矩阵，直接把相应的向量应用到mat3构造器就行。注意，如果我们希望更精确的话就不要讲TBN向量乘以model矩阵，而是使用法线矩阵，但我们只关心向量的方向，不会平移也和缩放这个变换。
 
-从技术上讲，顶点着色器中无需副切线。所有的这三个TBN向量都是相互垂直的所以我们可以在顶点着色器中庸T和N向量的叉乘，自己计算出副切线：vec3 B = cross(T, N);
-现在我们有了TBN矩阵，如果来使用它呢？基本有两种方式可以使用，我们会把这两种方式都说明一下：
+!!! Important
 
-我们可以用TBN矩阵把所有向量从切线空间转到世界空间，传给像素着色器，然后把采样得到的法线用TBN矩阵从切线空间变换到世界空间；法线就处于和其他光照变量一样的空间中了。
-我们用TBN的逆矩阵把所有世界空间的向量转换到切线空间，使用这个矩阵将除法线以外的所有相关光照变量转换到切线空间中；这样法线也能和其他光照变量处于同一空间之中。
-我们来看看第一种情况。我们从法线贴图重采样得来的法线向量，是以切线空间表达的，尽管其他光照向量是以世界空间表达的。把TBN传给像素着色器，我们就能将采样得来的切线空间的法线乘以这个TBN矩阵，将法线向量变换到和其他光照向量一样的参考空间中。这种方式随后所有光照计算都可以简单的理解。
+	从技术上讲，顶点着色器中无需副切线。所有的这三个TBN向量都是相互垂直的所以我们可以在顶点着色器中使用T和N向量的叉乘，自己计算出副切线：vec3 B = cross(T, N);
+	
+现在我们有了TBN矩阵，如果来使用它呢？通常来说有两种方式使用它，我们会把这两种方式都说明一下：
+
+1. 我们直接使用TBN矩阵，这个矩阵可以把切线坐标空间的向量转换到世界坐标空间。因此我们把它传给片段着色器中，把通过采样得到的法线坐标左乘上TBN矩阵，转换到世界坐标空间中，这样所有法线和其他光照变量就在同一个坐标系中了。
+2. 我们也可以使用TBN矩阵的逆矩阵，这个矩阵可以把世界坐标空间的向量转换到切线坐标空间。因此我们使用这个矩阵左乘其他光照变量，把他们转换到切线空间，这样法线和其他光照变量再一次在一个坐标系中了。
+
+
+**我们来看看第一种情况。**我们从法线贴图重采样得来的法线向量，是以切线空间表达的，尽管其他光照向量是以世界空间表达的。把TBN传给像素着色器，我们就能将采样得来的切线空间的法线乘以这个TBN矩阵，将法线向量变换到和其他光照向量一样的参考空间中。这种方式随后所有光照计算都可以简单的理解。
 
 把TBN矩阵发给像素着色器很简单：
 
@@ -268,7 +273,7 @@ normal = normalize(fs_in.TBN * normal);
 
 因为最后的normal现在在世界空间中了，就不用改变其他像素着色器的代码了，因为光照代码就是假设法线向量在世界空间中。
 
-我们同样看看第二种情况，我们用TBN矩阵的逆矩阵将所有相关的世界空间向量转变到采样所得法线向量的空间：切线空间。TBN的建构还是一样，但我们在将其发送给像素着色器之前先要求逆矩阵：
+**我们同样看看第二种情况。**我们用TBN矩阵的逆矩阵将所有相关的世界空间向量转变到采样所得法线向量的空间：切线空间。TBN的建构还是一样，但我们在将其发送给像素着色器之前先要求逆矩阵：
 
 ```c++
 vs_out.TBN = transpose(mat3(T, B, N));

From b3bf4294c0bc8d82e02dbdc63c201f0c08a76df6 Mon Sep 17 00:00:00 2001
From: kenlee <ken4000kl@gmail.com>
Date: Wed, 26 Apr 2017 15:38:18 +0800
Subject: [PATCH 17/19] add translations to comment

---
 docs/05 Advanced Lighting/04 Normal Mapping.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/05 Advanced Lighting/04 Normal Mapping.md b/docs/05 Advanced Lighting/04 Normal Mapping.md
index 63049e2..750ee29 100644
--- a/docs/05 Advanced Lighting/04 Normal Mapping.md	
+++ b/docs/05 Advanced Lighting/04 Normal Mapping.md	
@@ -4,7 +4,7 @@
       ---|---
 作者     | JoeyDeVries
 翻译     | [Django](http://bullteacher.com/)
-校对     | 暂无
+校对     | [KenLee](https://hellokenlee.github.io/)
 
 我们的场景中已经充满了多边形物体，其中每个都可能由成百上千平坦的三角形组成。我们以向三角形上附加纹理的方式来增加额外细节，提升真实感，隐藏多边形几何体是由无数三角形组成的事实。纹理确有助益，然而当你近看它们时，这个事实便隐藏不住了。现实中的物体表面并非是平坦的，而是表现出无数（凹凸不平的）细节。
 
@@ -182,10 +182,10 @@ bitangent1.y = f * (-deltaUV2.x * edge1.y + deltaUV1.x * edge2.y);
 bitangent1.z = f * (-deltaUV2.x * edge1.z + deltaUV1.x * edge2.z);
 bitangent1 = glm::normalize(bitangent1);  
   
-[...] // similar procedure for calculating tangent/bitangent for plane's second triangle
+[...] // 对平面的第二个三角形采用类似步骤计算切线和副切线
 ```
 
-我们预先计算出等式的分数部分f，然后把它和每个向量的元素进行相应矩阵乘法。如果你把代码和最终的等式对比你会发现，这就是直接套用。最后我们还要进行标准化，来确保切线/副切线向量最后是单位向量。
+我们预先计算出等式的分数部分`f`，然后把它和每个向量的元素进行相应矩阵乘法。如果你把代码和最终的等式对比你会发现，这就是直接套用。最后我们还要进行标准化，来确保切线/副切线向量最后是单位向量。
 
 因为一个三角形永远是平坦的形状，我们只需为每个三角形计算一个切线/副切线，它们对于每个三角形上的顶点都是一样的。要注意的是大多数实现通常三角形和三角形之间都会共享顶点。这种情况下开发者通常将每个顶点的法线和切线/副切线等顶点属性平均化，以获得更加柔和的效果。我们的平面的三角形之间分享了一些顶点，但是因为两个三角形相互并行，因此并不需要将结果平均化，但无论何时只要你遇到这种情况记住它就是件好事。
 

From ba40211cc8f1a5dd12f4df2eb4955d876a0c3ef9 Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Wed, 3 May 2017 21:55:42 +0800
Subject: [PATCH 18/19] Fix #65

---
 docs/04 Advanced OpenGL/05 Framebuffers.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/04 Advanced OpenGL/05 Framebuffers.md b/docs/04 Advanced OpenGL/05 Framebuffers.md
index 302257c..86ac38f 100644
--- a/docs/04 Advanced OpenGL/05 Framebuffers.md	
+++ b/docs/04 Advanced OpenGL/05 Framebuffers.md	
@@ -370,7 +370,7 @@ void main()
     {
         sampleTex[i] = vec3(texture(screenTexture, TexCoords.st + offsets[i]));
     }
-    vec3 col;
+    vec3 col = vec3(0.0);
     for(int i = 0; i < 9; i++)
         col += sampleTex[i] * kernel[i];
 

From 1c3abd15d8c3e91200c4448d800ce35f1d90850a Mon Sep 17 00:00:00 2001
From: Meow J <fang0716fy@gmail.com>
Date: Sun, 7 May 2017 08:57:38 +0800
Subject: [PATCH 19/19] Fix #66

---
 docs/01 Getting started/03 Hello Window.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/01 Getting started/03 Hello Window.md b/docs/01 Getting started/03 Hello Window.md
index d1d04f5..0d62d94 100644
--- a/docs/01 Getting started/03 Hello Window.md	
+++ b/docs/01 Getting started/03 Hello Window.md	
@@ -137,7 +137,7 @@ return 0;
 
 ## 输入
 
-我们同样也希望能够在GLFW中实现一些键盘控制，这可以通过使用GLFW的回调函数(Callback Function)来完成。<def>回调函数</def>事实上是一个函数指针，当我们设置好后，GLWF会在合适的时候调用它。**按键回调**(KeyCallback)是众多回调函数中的一种。当我们设置了按键回调之后，GLFW会在用户有键盘交互时调用它。该回调函数的原型如下所示：
+我们同样也希望能够在GLFW中实现一些键盘控制，这可以通过使用GLFW的回调函数(Callback Function)来完成。<def>回调函数</def>事实上是一个函数指针，当我们设置好后，GLFW会在合适的时候调用它。**按键回调**(KeyCallback)是众多回调函数中的一种。当我们设置了按键回调之后，GLFW会在用户有键盘交互时调用它。该回调函数的原型如下所示：
 
 ```c++
 void key_callback(GLFWwindow* window, int key, int scancode, int action, int mode);