From 6605764a8c66a01c427270c272de549dda6da922 Mon Sep 17 00:00:00 2001 From: Meow J Date: Sat, 16 Jul 2016 14:00:05 +0800 Subject: [PATCH] 01-05 --- docs/01 Getting started/05 Shaders.md | 241 +++++++++--------- docs/img/01/05/shaders.png | Bin 0 -> 14193 bytes docs/img/01/05/shaders3.png | Bin 0 -> 28648 bytes .../vertex_attribute_pointer_interleaved.png | Bin 0 -> 15004 bytes glossary.md | 18 +- 5 files changed, 138 insertions(+), 121 deletions(-) create mode 100644 docs/img/01/05/shaders.png create mode 100644 docs/img/01/05/shaders3.png create mode 100644 docs/img/01/05/vertex_attribute_pointer_interleaved.png diff --git a/docs/01 Getting started/05 Shaders.md b/docs/01 Getting started/05 Shaders.md index c72e2f8..36d9c45 100644 --- a/docs/01 Getting started/05 Shaders.md +++ b/docs/01 Getting started/05 Shaders.md @@ -6,15 +6,15 @@ 翻译 | [Django](http://bullteacher.com/) 校对 | Geequlim -在[Hello Triangle](http://learnopengl-cn.readthedocs.org/zh/latest/01%20Getting%20started/04%20Hello%20Triangle/)教程中提到，着色器(Shader)是运行在GPU上的小程序。这些小程序为图形渲染管线的一个特定部分而运行。从基本意义上来说，着色器不是别的，只是一种把输入转化为输出的程序。着色器也是一种相当独立的程序，它们不能相互通信；只能通过输入和输出的方式来进行沟通。 +在[Hello Triangle](04 Hello Triangle.md)教程中提到，着色器(Shader)是运行在GPU上的小程序。这些小程序为图形渲染管线的某个特定部分而运行。从基本意义上来说，着色器只是一种把输入转化为输出的程序。着色器也是一种非常独立的程序，因为它们之间不能相互通信；它们之间唯一的沟通只有通过输入和输出。 -前面的教程里我们简要地触及了一点着色器的皮毛。了解了如何恰当地使用它们。现在我们会用一种更加通用的方式详细解释着色器，特别是OpenGL着色器语言。 +前面的教程里我们简要地触及了一点着色器的皮毛，并了解了如何恰当地使用它们。现在我们会用一种更加广泛的形式详细解释着色器，特别是OpenGL着色器语言(GLSL)。 # GLSL -着色器是使用一种叫GLSL的类C语言写成的。GLSL是为图形计算量身定制的，它包含针对向量和矩阵操作的有用特性。 +着色器是使用一种叫GLSL的类C语言写成的。GLSL是为图形计算量身定制的，它包含一些针对向量和矩阵操作的有用特性。 -着色器的开头总是要声明版本，接着是输入和输出变量、uniform和`main`函数。每个着色器的入口都是`main`函数，在这里我们处理所有输入变量，用输出变量输出结果。如果你不知道什么是uniform也不用担心，我们后面会进行讲解。 +着色器的开头总是要声明版本，接着是输入和输出变量、uniform和main函数。每个着色器的入口点都是main函数，在这个函数中我们处理所有的输入变量，并将结果输出到输出变量中。如果你不知道什么是uniform也不用担心，我们后面会进行讲解。 一个典型的着色器有下面的结构： @@ -30,14 +30,14 @@ uniform type uniform_name; int main() { - // 处理输入 + // 处理输入并进行一些图形操作 ... - // 输出 + // 输出处理过的结果到输出变量 out_variable_name = weird_stuff_we_processed; } ``` -当我们谈论特别是谈到顶点着色器的时候，每个输入变量也叫顶点属性(Vertex Attribute)。能声明多少个顶点属性是由硬件决定的。OpenGL确保至少有16个包含4个元素的顶点属性可用，但是有些硬件或许可用更多，你可以查询`GL_MAX_VERTEX_ATTRIB`S来获取这个数目。 +当我们特别谈论到顶点着色器的时候，每个输入变量也叫顶点属性(Vertex Attribute)。我们能声明的顶点属性是有上限的，它一般由硬件来决定。OpenGL确保至少有16个包含4分量的顶点属性可用，但是有些硬件或许允许更多的顶点属性，你可以查询GL_MAX_VERTEX_ATTRIBS来获取具体的上限： ```c++ GLint nrAttributes; @@ -45,29 +45,29 @@ glGetIntegerv(GL_MAX_VERTEX_ATTRIBS, &nrAttributes); std::cout << "Maximum nr of vertex attributes supported: " << nrAttributes << std::endl; ``` -通常情况下它会返回至少16个，大部分情况下是够用了。 +通常情况下它至少会返回16个，大部分情况下是够用了。 ## 数据类型 -GLSL有像其他编程语言相似的数据类型。GLSL有C风格的默认基础数据类型：`int`、`float`、`double`、`uint`和`bool`。GLSL也有两种容器类型，教程中我们会使用很多，它们是向量(Vector)和矩阵(Matrix)，其中矩阵我们会在之后的教程里再讨论。 +和其他编程语言一样，GLSL有数据类型可以来指定变量的种类。GLSL中包含C等其它语言大部分的默认基础数据类型：`int`、`float`、`double`、`uint`和`bool`。GLSL也有两种容器类型，它们会在这个教程中使用很多，分别是向量(Vector)和矩阵(Matrix)，其中矩阵我们会在之后的教程里再讨论。 ### 向量 -GLSL中的向量(Vector)可以包含有1、2、3或者4个分量，分量类型可以是前面默认基础类型的任意一个。它们可以是下面的形式(n代表元素数量)： +GLSL中的向量是一个可以包含有1、2、3或者4个分量的容器，分量的类型可以是前面默认基础类型的任意一个。它们可以是下面的形式(`n`代表分量的数量)： 类型|含义 ---|--- - vecn | 包含n个默认为float元素的向量 - bvecn| 包含n个布尔元素向量 - ivecn| 包含n个int元素的向量 - uvecn| 包含n个unsigned int元素的向量 - dvecn| 包含n个double元素的向量 + `vecn` | 包含`n`个float分量的默认向量 + `bvecn`| 包含`n`个bool分量的向量 + `ivecn`| 包含`n`个int分量的向量 + `uvecn`| 包含`n`个unsigned int分量的向量 + `dvecn`| 包含n个double分量的向量 -大多数时候我们使用vecn，因为float足够满足大多数要求。 +大多数时候我们使用`vecn`，因为float足够满足大多数要求了。 -一个向量的元素可以通过`vec.x`这种方式获取，这里`x`是指这个向量的第一个元素。你可以分别使用`.x`、`.y`、`.z`和`.w`来获取它们的第1、2、3、4号元素。GLSL也允许你使用**rgba**来获取颜色的元素，或是**stpq**获取纹理坐标元素。 +一个向量的分量可以通过`vec.x`这种方式获取，这里`x`是指这个向量的第一个分量。你可以分别使用`.x`、`.y`、`.z`和`.w`来获取它们的第1、2、3、4个分量。GLSL也允许你对颜色使用`rgba`，或是对纹理坐标使用`stpq`访问相同的分量。 -向量的数据类型也允许一些有趣而灵活的元素选择方式，叫做重组(Swizzling)。重组允许这样的语法： +向量这一数据类型也允许一些有趣而灵活的分量选择方式，叫做重组(Swizzling)。重组允许这样的语法： ```c++ vec2 someVec; @@ -76,7 +76,7 @@ vec3 anotherVec = differentVec.zyw; vec4 otherVec = someVec.xxxx + anotherVec.yxzy; ``` -你可以使用上面任何4个字母组合来创建一个新的和原来向量一样长的向量(但4个元素需要是同一种类型)；不允许在一个vec2向量中去获取.z元素。我们可以把一个向量作为一个参数传给不同的向量构造函数，以减少参数需求的数量： +你可以使用上面4个字母任意组合来创建一个和原来向量一样长的（同类型）新向量，只要原来向量有那些分量即可；然而，你不允许在一个`vec2`向量中去获取`.z`元素。我们也可以把一个向量作为一个参数传给不同的向量构造函数，以减少需求参数的数量： ```c++ vec2 vect = vec2(0.5f, 0.7f); @@ -84,41 +84,41 @@ vec4 result = vec4(vect, 0.0f, 0.0f); vec4 otherResult = vec4(result.xyz, 1.0f); ``` -向量是一种灵活的数据类型，我们可以把用在所有输入和输出上。学完教程你会看到很多如何创造性地管理向量的例子。 +向量是一种灵活的数据类型，我们可以把用在各种输入和输出上。学完教程你会看到很多新颖的管理向量的例子。 ## 输入与输出 -着色器是各自独立的小程序，但是它们都是一个整体的局部，出于这样的原因，我们希望每个着色器都有输入和输出，这样才能进行数据交流和传递。GLSL定义了`in`和`out`关键字来实现这个目的。每个着色器使用这些关键字定义输入和输出，无论在哪儿，一个输出变量就能与一个下一个阶段的输入变量相匹配。他们在顶点和片段着色器之间有点不同。 +虽然着色器是各自独立的小程序，但是它们都是一个整体的一部分，出于这样的原因，我们希望每个着色器都有输入和输出，这样才能进行数据交流和传递。GLSL定义了`in`和`out`关键字专门来实现这个目的。每个着色器使用这两个关键字设定输入和输出，只要一个输出变量与下一个着色器阶段的输入匹配，它就会传递下去。但在顶点和片段着色器中会有点不同。 -顶点着色器应该接收的输入是一种特有形式，否则就会效率低下。顶点着色器的输入是特殊的，它所接受的是从顶点数据直接输入的。为了定义顶点数据被如何组织，我们使用`location`元数据指定输入变量，这样我们才可以在CPU上配置顶点属性。我们已经在前面的教程看过`layout (location = 0)`。顶点着色器需要为它的输入提供一个额外的`layout`定义，这样我们才能把它链接到顶点数据。 +顶点着色器应该接收的是一种特殊形式的输入，否则就会效率低下。顶点着色器的输入特殊在，它从顶点数据中直接接收输入。为了定义顶点数据该如何管理，我们使用`location`这一元数据指定输入变量，这样我们才可以在CPU上配置顶点属性。我们已经在前面的教程看过这个了，`layout (location = 0)`。顶点着色器需要为它的输入提供一个额外的`layout`标识，这样我们才能把它链接到顶点数据。 !!! Important - 也可以移除`layout (location = 0)`，通过在OpenGL代码中使用`glGetAttribLocation`请求属性地址(Location)，但是我更喜欢在着色器中设置它们，理解容易而且节省时间。 + 你也可以忽略`layout (location = 0)`标识符，通过在OpenGL代码中使用glGetAttribLocation查询属性位置值(Location)，但是我更喜欢在着色器中设置它们，这样会更容易理解而且节省你（和OpenGL）的工作量。 -另一个例外是片段着色器需要一个`vec4`颜色输出变量，因为片段着色器需要生成一个最终输出的颜色。如果你在片段着色器没有定义输出颜色，OpenGL会把你的物体渲染为黑色(或白色)。 +另一个例外是片段着色器，它需要一个`vec4`颜色输出变量，因为片段着色器需要生成一个最终输出的颜色。如果你在片段着色器没有定义输出颜色，OpenGL会把你的物体渲染为黑色（或白色）。 -所以，如果我们打算从一个着色器向另一个着色器发送数据，我们必须**在发送方着色器中声明一个输出，在接收方着色器中声明一个同名输入**。当名字和类型都一样的时候，OpenGL就会把两个变量链接到一起，它们之间就能发送数据了(这是在链接程序(Program)对象时完成的)。为了展示这是这么工作的，我们会改变前面教程里的那个着色器，让顶点着色器为片段着色器决定颜色。 +所以，如果我们打算从一个着色器向另一个着色器发送数据，我们必须在发送方着色器中声明一个输出，在接收方着色器中声明一个类似的输入。当类型和名字都一样的时候，OpenGL就会把两个变量链接到一起，它们之间就能发送数据了（这是在链接程序对象时完成的）。为了展示这是如何工作的，我们会稍微改动一下之前教程里的那个着色器，让顶点着色器为片段着色器决定颜色。 **顶点着色器** ```c++ #version 330 core -layout (location = 0) in vec3 position; // 位置变量的属性为0 +layout (location = 0) in vec3 position; // position变量的属性位置值为0 out vec4 vertexColor; // 为片段着色器指定一个颜色输出 void main() { - gl_Position = vec4(position, 1.0); // 把一个vec3作为vec4的构造器的参数 - vertexColor = vec4(0.5f, 0.0f, 0.0f, 1.0f); // 把输出颜色设置为暗红色 + gl_Position = vec4(position, 1.0); // 注意我们如何把一个vec3作为vec4的构造器的参数 + vertexColor = vec4(0.5f, 0.0f, 0.0f, 1.0f); // 把输出变量设置为暗红色 } ``` **片段着色器** ```c++ #version 330 core -in vec4 vertexColor; // 和顶点着色器的vertexColor变量类型相同、名称相同 +in vec4 vertexColor; // 从顶点着色器传来的输入变量（名称相同、类型相同） out vec4 color; // 片段着色器输出的变量名可以任意命名，类型必须是vec4 @@ -128,23 +128,23 @@ void main() } ``` -你可以看到我们在顶点着色器中声明了一个`vertexColor`变量作为`vec4`输出，在片段着色器声明了一个一样的`vertexColor`。由于它们**类型相同并且名字也相同**，片段着色器中的`vertexColor`就和顶点着色器中的`vertexColor`链接了。因为我们在顶点着色器中设置的颜色是深红色的，片段着色器输出的结果也是深红色的。下面的图片展示了输出结果： +你可以看到我们在顶点着色器中声明了一个vertexColor变量作为`vec4`输出，并在片段着色器中声明了一个类似的vertexColor。由于它们名字相同且类型相同，片段着色器中的vertexColor就和顶点着色器中的vertexColor链接了。由于我们在顶点着色器中将颜色设置为深红色，最终的片段也是深红色的。下面的图片展示了输出结果： -![](http://learnopengl.com/img/getting-started/shaders.png) +![](../img/01/05/shaders.png) -我们完成了从顶点着色器向片段着色器发送数据。让我们更上一层楼，看看能否从应用程序中直接给片段着色器发送一个颜色！ +完成了！我们成功地从顶点着色器向片段着色器发送数据。让我们更上一层楼，看看能否从应用程序中直接给片段着色器发送一个颜色！ ## Uniform -uniform是另一种从CPU应用向GPU着色器发送数据的方式，但uniform和顶点属性有点不同。首先，uniform是**全局的(Global)**。这里全局的意思是uniform变量必须在所有着色器程序对象中都是独一无二的，它可以在着色器程序的任何着色器任何阶段使用。第二，无论你把uniform值设置成什么，uniform会一直保存它们的数据，直到它们被重置或更新。 +Uniform是一种从CPU中的应用向GPU中的着色器发送数据的方式，但uniform和顶点属性有些不同。首先，uniform是**全局的(Global)**。全局意味着uniform变量必须在每个着色器程序对象中都是独一无二的，而且它可以被着色器程序的任意着色器在任意阶段访问。第二，无论你把uniform值设置成什么，uniform会一直保存它们的数据，直到它们被重置或更新。 -我们可以简单地通过在片段着色器中设置uniform关键字接类型和变量名来声明一个GLSL的uniform。之后，我们可以在着色器中使用新声明的uniform了。我们来看看这次是否能通过uniform设置三角形的颜色： +我们可以在一个着色器中添加`uniform`关键字至类型和变量名前来声明一个GLSL的uniform。从此处开始我们就可以在着色器中使用新声明的uniform了。我们来看看这次是否能通过uniform设置三角形的颜色： ```c++ #version 330 core out vec4 color; -uniform vec4 ourColor; //在程序代码中设置 +uniform vec4 ourColor; // 在OpenGL程序代码中设定这个变量 void main() { @@ -152,13 +152,13 @@ void main() } ``` -我们在片段着色器中声明了一个uniform vec4的`ourColor`，并把片段着色器的输出颜色设置为uniform值。因为uniform是全局变量，我们我们可以在任何着色器中定义它们，而无需通过顶点着色器作为中介。顶点着色器中不需要这个uniform所以不用在那里定义它。 +我们在片段着色器中声明了一个uniform `vec4`的ourColor，并把片段着色器的输出颜色设置为uniform值的内容。因为uniform是全局变量，我们我们可以在任何着色器中定义它们，而无需通过顶点着色器作为中介。顶点着色器中不需要这个uniform，所以我们不用在那里定义它。 !!! Attention - 如果你声明了一个uniform却在GLSL代码中没用过，编译器会静默移除这个变量，从而最后编译出的版本中并不会包含它，如果有一个从没用过的uniform出现在已编译版本中会出现几个错误，记住这点！ + 如果你声明了一个uniform却在GLSL代码中没用过，编译器会静默移除这个变量，导致最后编译出的版本中并不会包含它，这可能导致几个非常麻烦的错误，记住这点！ -uniform现在还是空的；我们没有给它添加任何数据，所以下面就做这件事。我们首先需要找到着色器中uniform的索引/地址。当我们得到uniform的索引/地址后，我们就可以更新它的值了。这里我们不去给像素传递一个颜色，而是随着时间让它改变颜色： +这个uniform现在还是空的；我们还没有给它添加任何数据，所以下面我们就做这件事。我们首先需要找到着色器中uniform属性的索引/位置值。当我们得到uniform的索引/位置值后，我们就可以更新它的值了。这次我们不去给像素传递单独一个颜色，而是让它随着时间改变颜色： ```c++ GLfloat timeValue = glfwGetTime(); @@ -168,30 +168,30 @@ glUseProgram(shaderProgram); glUniform4f(vertexColorLocation, 0.0f, greenValue, 0.0f, 1.0f); ``` -首先我们通过`glfwGetTime()`获取运行的秒数。然后我们使用余弦函数在0.0到-1.0之间改变颜色，最后储存到`greenValue`里。 +首先我们通过glfwGetTime()获取运行的秒数。然后我们使用sin函数让颜色在0.0到1.0之间改变，最后将结果储存到greenValue里。 -接着，我们用`glGetUniformLocation`请求`uniform ourColor`的地址。我们为请求函数提供着色器程序和uniform的名字(这是我们希望获得的地址的来源)。如果`glGetUniformLocation`返回`-1`就代表没有找到这个地址。最后，我们可以通过`glUniform4f`函数设置uniform值。注意，查询uniform地址不需要在之前使用着色器程序，但是更新一个unform之前**必须**使用程序(调用`glUseProgram`)，因为它是在当前激活的着色器程序中设置unform的。 +接着，我们用glGetUniformLocation查询uniform `ourColor`的位置值。我们为查询函数提供着色器程序和uniform的名字（这是我们希望获得的位置值的来源）。如果glGetUniformLocation返回`-1`就代表没有找到这个位置值。最后，我们可以通过glUniform4f函数设置uniform值。注意，查询uniform地址不要求你之前使用过着色器程序，但是更新一个unform之前你**必须**先使用程序（调用glUseProgram)，因为它是在当前激活的着色器程序中设置unform的。 !!! Important - 因为OpenGL是C库内核，所以它不支持函数重载，在函数参数不同的时候就要定义新的函数；glUniform是一个典型例子。这个函数有一个特定的作为类型的后缀。有几种可用的后缀： + 因为OpenGL在其核心是一个C库，所以它不支持类型重载，在函数参数不同的时候就要为其定义新的函数；glUniform是一个典型例子。这个函数有一个特定的后缀，标识设定的uniform的类型。可能的后缀有： 后缀|含义 ---|-- - f | 函数需要以一个float作为它的值 - i | 函数需要一个int作为它的值 - ui| 函数需要一个unsigned int作为它的值 - 3f| 函数需要3个float作为它的值 - fv| 函数需要一个float向量/数组作为它的值 + `f` | 函数需要一个float作为它的值 + `i` | 函数需要一个int作为它的值 + `ui`| 函数需要一个unsigned int作为它的值 + `3f`| 函数需要3个float作为它的值 + `fv`| 函数需要一个float向量/数组作为它的值 - 每当你打算配置一个OpenGL的选项时就可以简单地根据这些规则选择适合你的数据类型的重载的函数。在我们的例子里，我们使用uniform的4float版，所以我们通过`glUniform4f`传递我们的数据(注意，我们也可以使用fv版本)。 + 每当你打算配置一个OpenGL的选项时就可以简单地根据这些规则选择适合你的数据类型的重载函数。在我们的例子里，我们希望分别设定uniform的4个float值，所以我们通过glUniform4f传递我们的数据(注意，我们也可以使用`fv`版本)。 -现在你知道如何设置uniform变量的值了，我们可以使用它们来渲染了。如果我们打算让颜色慢慢变化，我们就要在游戏循环的每一帧更新这个uniform，否则三角形就不会改变颜色。下面我们就计算greenValue然后每个渲染迭代都更新这个uniform： +现在你知道如何设置uniform变量的值了，我们可以使用它们来渲染了。如果我们打算让颜色慢慢变化，我们就要在游戏循环的每一次迭代中（所以他会逐帧改变）更新这个uniform，否则三角形就不会改变颜色。下面我们就计算greenValue然后每个渲染迭代都更新这个uniform： ```c++ while(!glfwWindowShouldClose(window)) { - // 检测事件 + // 检测并调用事件 glfwPollEvents(); // 渲染 @@ -199,7 +199,7 @@ while(!glfwWindowShouldClose(window)) glClearColor(0.2f, 0.3f, 0.3f, 1.0f); glClear(GL_COLOR_BUFFER_BIT); - // 激活着色器 + // 记得激活着色器 glUseProgram(shaderProgram); // 更新uniform颜色 @@ -215,49 +215,50 @@ while(!glfwWindowShouldClose(window)) } ``` -新代码和上一节的很相似。这次，我们在每个循环绘制三角形前先更新uniform值。如果你成功更新uniform了，你会看到你的三角形逐渐由绿变黑再变绿。 +这里的代码对之前代码是一次非常直接的修改。这次，我们在每次迭代绘制三角形前先更新uniform值。如果你正确更新了uniform，你会看到你的三角形逐渐由绿变黑再变回绿色。 -如果你在哪儿卡住了，[这里有源码](http://www.learnopengl.com/code_viewer.php?code=getting-started/shaders-uniform)。 +如果你在哪儿卡住了，可以到[这里](http://www.learnopengl.com/code_viewer.php?code=getting-started/shaders-uniform)查看源码。 -就像你所看到的那样，uniform是个设置属性的很有用的工具，它可以在渲染循环中改变，也可以在你的应用和着色器之间进行数据交互，但假如我们打算为每个顶点设置一个颜色的时候该怎么办？这种情况下，我们就不得不声明和顶点数目一样多的uniform了。在顶点属性问题上一个更好的解决方案一定要能包含足够多的数据，这是我们接下来要讲的内容。 +可以看到，uniform对于设置一个在渲染迭代中会改变的属性是一个非常有用的工具，它也是一个在程序和着色器间数据交互的很好工具，但假如我们打算为每个顶点设置一个颜色的时候该怎么办？这种情况下，我们就不得不声明和顶点数目一样多的uniform了。在这一问题上更好的解决方案是在顶点属性中包含更多的数据，这是我们接下来要做的事情。 -## 更多属性 +## 更多属性！ -前面的教程中，我们了解了如何填充VBO、配置顶点属性指针以及如何把它们都储存到VAO里。这次，我们同样打算把颜色数据加进顶点数据中。我们将把颜色数据表示为3个float的**顶点数组(Vertex Array)**。我们为三角形的每个角分别指定为红色、绿色和蓝色： +在前面的教程中，我们了解了如何填充VBO、配置顶点属性指针以及如何把它们都储存到一个VAO里。这次，我们同样打算把颜色数据加进顶点数据中。我们将把颜色数据添加为3个float值至vertices数组。我们将把三角形的三个角分别指定为红色、绿色和蓝色： ```c++ GLfloat vertices[] = { - // 位置 // 颜色 + // 位置 // 颜色 0.5f, -0.5f, 0.0f, 1.0f, 0.0f, 0.0f, // 右下 -0.5f, -0.5f, 0.0f, 0.0f, 1.0f, 0.0f, // 左下 0.0f, 0.5f, 0.0f, 0.0f, 0.0f, 1.0f // 顶部 }; ``` -由于我们现在发送到顶点着色器的数据更多了，有必要调整顶点着色器，使它能够把颜色值作为一个顶点属性输入。需要注意的是我们用`layout`标识符来吧`color`属性的`location`设置为1： +由于现在有更多的数据要发送到顶点着色器，我们有必要去调整一下顶点着色器，使它能够接收颜色值作为一个顶点属性输入。需要注意的是我们用`layout`标识符来把color属性的位置值设置为1： ```c++ #version 330 core -layout (location = 0) in vec3 position; // 位置变量的属性position为 0 -layout (location = 1) in vec3 color; // 颜色变量的属性position为 1 +layout (location = 0) in vec3 position; // 位置变量的属性位置值为 0 +layout (location = 1) in vec3 color; // 颜色变量的属性位置值为 1 out vec3 ourColor; // 向片段着色器输出一个颜色 void main() { gl_Position = vec4(position, 1.0); - ourColor = color; // 把ourColor设置为我们从顶点数据那里得到的输入颜色 + ourColor = color; // 将ourColor设置为我们从顶点数据那里得到的输入颜色 } ``` -由于我们不再使用uniform来传递片段的颜色了，现在使用的`ourColor`输出变量要求必须也去改变片段着色器： +由于我们不再使用uniform来传递片段的颜色了，现在使用`ourColor`输出变量，我们必须再修改一下片段着色器： ```c++ #version 330 core -in vec3 ourColor +in vec3 ourColor; out vec4 color; + void main() { color = vec4(ourColor, 1.0f); @@ -266,12 +267,12 @@ void main() 因为我们添加了另一个顶点属性，并且更新了VBO的内存，我们就必须重新配置顶点属性指针。更新后的VBO内存中的数据现在看起来像这样： -![](http://learnopengl.com/img/getting-started/vertex_attribute_pointer_interleaved.png) +![](../img/01/05/vertex_attribute_pointer_interleaved.png) -知道了当前使用的layout，我们就可以使用`glVertexAttribPointer`函数更新顶点格式， +知道了现在使用的布局，我们就可以使用glVertexAttribPointer函数更新顶点格式， ```c++ -// 顶点属性 +// 位置属性 glVertexAttribPointer(0, 3, GL_FLOAT, GL_FALSE, 6 * sizeof(GLfloat), (GLvoid*)0); glEnableVertexAttribArray(0); // 颜色属性 @@ -279,28 +280,27 @@ glVertexAttribPointer(1, 3, GL_FLOAT, GL_FALSE, 6 * sizeof(GLfloat), (GLvoid*)(3 glEnableVertexAttribArray(1); ``` -`glVertexAttribPointer`函数的前几个参数比较明了。这次我们配置属性location为1的顶点属性。颜色值有3个float那么大，我们不去标准化这些值。 +glVertexAttribPointer函数的前几个参数比较明了。这次我们配置属性位置值为1的顶点属性。颜色值有3个float那么大，我们不去标准化这些值。 -由于我们现在有了两个顶点属性，我们不得不重新计算步长值(Stride)。为获得数据队列中下一个属性值(比如位置向量的下个x元素)我们必须向右移动6个float，其中3个是位置值，另外三个是颜色值。这给了我们6个步长的大小，每个步长都是float的字节数(=24字节)。 +由于我们现在有了两个顶点属性，我们不得不重新计算**步长**值。为获得数据队列中下一个属性值（比如位置向量的下个`x`分量）我们必须向右移动6个float，其中3个是位置值，另外3个是颜色值。这使我们的步长值为6乘以float的字节数（=24字节）。 +同样，这次我们必须指定一个偏移量。对于每个顶点来说，位置顶点属性在前，所以它的偏移量是0。颜色属性紧随位置数据之后，所以偏移量就是`3 * sizeof(GLfloat)`，用字节来计算就是12字节。 -同样，这次我们必须指定一个偏移量(Offset)。对于每个顶点来说，位置(Position)顶点属性是先声明的，所以它的偏移量是0。颜色属性紧随位置数据之后，所以偏移量就是`3*sizeof(GLfloat)`，用字节来计算就是12字节。 +运行程序你应该会看到如下结果： -运行应用你会看到如下结果： -![](http://learnopengl.com/img/getting-started/shaders3.png) +![](../img/01/05/shaders3.png) -如果你有困惑，可以[在这里获得源码](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-interpolated)。 +如果你在哪卡住了，可以在[这里](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-interpolated)查看源码。 -这个图片可能不是你所期望的那种，因为我们只提供3个颜色，而不是我们现在看到的大调色板。这是所谓片段着色器进行**片段插值(Fragment Interpolation)**的结果。当渲染一个三角形在像素化(Rasterization 也译为光栅化)阶段通常生成比原来的顶点更多的像素。像素器就会基于每个像素在三角形的所处相对位置决定像素的位置。 +这个图片可能不是你所期望的那种，因为我们只提供了3个颜色，而不是我们现在看到的大调色板。这是在片段着色器中进行的所谓片段插值(Fragment Interpolation)的结果。当渲染一个三角形时，光栅化(Rasterization)阶段通常会造成比原指定顶点更多的片段。光栅会根据每个片段在三角形形状上所处相对位置决定这些片段的位置。 +基于这些位置，它会插值(Interpolate)所有片段着色器的输入变量。比如说，我们有一个线段，上面的端点是绿色的，下面的端点是蓝色的。如果一个片段着色器在线段的70%的位置运行，它的颜色输入属性就会是一个绿色和蓝色的线性结合；更精确地说就是30%蓝 + 70%绿。 -基于这些位置，它**插入(Interpolate)**所有片段着色器的输入变量。比如说，我们有一个线段，上面的那个点是绿色的，下面的点是蓝色的。如果一个片段着色器正在处理的那个片段(实际上就是像素)是在线段的70%的位置，它的颜色输入属性就会是一个绿色和蓝色的线性结合；更精确地说就是30%蓝+70%绿。 - -这正是这个三角形里发生的事。我们有3个顶点，和相应的3个颜色，从这个三角形的像素来看它可能包含50,000左右的像素，片段着色器为这些像素进行插值。如果你仔细看这些颜色，你会发现其中的奥秘：红到紫再到蓝。像素插值会应用到所有片段着色器的输入属性上。 +这正是在这个三角形中发生了什么。我们有3个顶点，和相应的3个颜色，从这个三角形的像素来看它可能包含50000左右的片段，片段着色器为这些像素进行插值颜色。如果你仔细看这些颜色就应该能明白了：红首先变成到紫再变为蓝色。片段插值会被应用到片段着色器的所有输入属性上。 # 我们自己的着色器类 -编写、编译、管理着色器是件麻烦事。在着色器的最后主题里，我们会写一个类来让我们的生活轻松一点，这个类从硬盘读着色器，然后编译和链接它们，对它们进行错误检测，这就变得很好用了。这也会给你一些关于如何把我们目前所学的知识封装到一个抽象的对象里的灵感。 +编写、编译、管理着色器是件麻烦事。在着色器主题的最后，我们会写一个类来让我们的生活轻松一点，它可以从硬盘读取着色器，然后编译并链接它们，并对它们进行错误检测，这就变得很好用了。这也会让你了解该如何封装目前所学的知识到一个抽象对象中。 -我们会在头文件里创建整个类，主要为了学习，也可以方便移植。我们先来添加必要的include，定义类结构： +我们会把着色器类全部放在在头文件里，主要是为了学习用途，当然也方便移植。我们先来添加必要的include，并定义类结构： ```c++ #ifndef SHADER_H @@ -311,19 +311,17 @@ glEnableVertexAttribArray(1); #include #include -using namespace std; - -#include ; // 包含glew获取所有的OpenGL必要headers +#include ; // 包含glew来获取所有的必须OpenGL头文件 class Shader { public: - // 程序ID - GLuint Program; - // 构造器读取并创建Shader - Shader(const GLchar * vertexSourcePath, const GLchar * fragmentSourcePath); - // 使用Program - void Use(); + // 程序ID + GLuint Program; + // 构造器读取并构建着色器 + Shader(const GLchar* vertexPath, const GLchar* fragmentPath); + // 使用程序 + void Use(); }; #endif @@ -331,50 +329,55 @@ public: !!! Important - 在上面，我们用了几个预处理指令(Preprocessor Directives)。这些预处理指令告知你的编译器，只在没被包含过的情况下才包含和编译这个头文件，即使多个文件都包含了这个shader头文件,它是用来防止链接冲突的。 + 在上面，我们在头文件顶部使用了几个预处理指令(Preprocessor Directives)。这些预处理指令会告知你的编译器只在它没被包含过的情况下才包含和编译这个头文件，即使多个文件都包含了这个着色器头文件。它是用来防止链接冲突的。 -shader类保留了着色器程序的ID。它的构造器需要顶点和片段着色器源代码的文件路径，我们可以把各自的文本文件储存在硬盘上。`Use`函数看似平常，但是能够显示这个自造类如何让我们的生活变轻松(虽然只有一点)。 +着色器类储存了着色器程序的ID。它的构造器需要顶点和片段着色器源代码的文件路径，这样我们就可以把源码的文本文件储存在硬盘上了。我们还添加了一个Use函数，它其实不那么重要，但是能够显示这个自造类如何让我们的生活变得轻松（虽然只有一点）。 ## 从文件读取 -我们使用C++文件流读取着色器内容，储存到几个string对象里：(译注1) +我们使用C++文件流读取着色器内容，储存到几个`string`对象里：(译注1) !!! note "译注1" 实际上把着色器代码保存在文件中适合学习OpenGL的时候，实际开发中最好把一个着色器直接储存为多个字符串，这样具有更高的灵活度。 ```c++ -Shader(const GLchar * vertexPath, const GLchar * fragmentPath) +Shader(const GLchar* vertexPath, const GLchar* fragmentPath) { - // 1. 从文件路径获得vertex/fragment源码 + // 1. 从文件路径中获取顶点/片段着色器 std::string vertexCode; std::string fragmentCode; - - try { + std::ifstream vShaderFile; + std::ifstream fShaderFile; + // 保证ifstream对象可以抛出异常： + vShaderFile.exceptions(std::ifstream::badbit); + fShaderFile.exceptions(std::ifstream::badbit); + try + { // 打开文件 - std::ifstream vShaderFile(vertexPath); - std::ifstream fShaderFile(fragmentPath); - + vShaderFile.open(vertexPath); + fShaderFile.open(fragmentPath); std::stringstream vShaderStream, fShaderStream; - // 读取文件缓冲到流 + // 读取文件的缓冲内容到流中 vShaderStream << vShaderFile.rdbuf(); - fShaderStream << fShaderFile.rdbuf(); - - // 关闭文件句柄 + fShaderStream << fShaderFile.rdbuf(); + // 关闭文件 vShaderFile.close(); fShaderFile.close(); - - // 将流转为GLchar数组 + // 转换流至GLchar数组 vertexCode = vShaderStream.str(); - fragmentCode = fShaderStream.str(); + fragmentCode = fShaderStream.str(); } - catch(std::exception e) + catch(std::ifstream::failure e) { - std::cout << "ERROR::SHADER::FILE_NOT_SUCCESFULLY_READ" << std::endl; + std::cout << "ERROR::SHADER::FILE_NOT_SUCCESFULLY_READ" << std::endl; } + const GLchar* vShaderCode = vertexCode.c_str(); + const GLchar* fShaderCode = fragmentCode.c_str(); + [...] ``` -下一步，我们需要编译和链接着色器。注意，我们也要检查编译/链接是否失败，如果失败，打印编译错误，调试的时候这及其重要(这些错误日志你总会需要的)： +下一步，我们需要编译和链接着色器。注意，我们也将检查编译/链接是否失败，如果失败则打印编译时错误，调试的时候这些错误输出会及其重要（你总会需要这些错误日志的）： ```c++ // 2. 编译着色器 @@ -386,38 +389,36 @@ GLchar infoLog[512]; vertex = glCreateShader(GL_VERTEX_SHADER); glShaderSource(vertex, 1, &vShaderCode, NULL); glCompileShader(vertex); - -// 打印编译时错误 +// 打印编译错误（如果有的话） glGetShaderiv(vertex, GL_COMPILE_STATUS, &success); if(!success) { glGetShaderInfoLog(vertex, 512, NULL, infoLog); std::cout << "ERROR::SHADER::VERTEX::COMPILATION_FAILED\n" << infoLog << std::endl; }; - -// 对片段着色器进行类似处理 + +// 片段着色器也类似 [...] - + // 着色器程序 this->Program = glCreateProgram(); glAttachShader(this->Program, vertex); glAttachShader(this->Program, fragment); glLinkProgram(this->Program); - -// 打印连接错误 +// 打印连接错误（如果有的话） glGetProgramiv(this->Program, GL_LINK_STATUS, &success); if(!success) { glGetProgramInfoLog(this->Program, 512, NULL, infoLog); std::cout << "ERROR::SHADER::PROGRAM::LINKING_FAILED\n" << infoLog << std::endl; } - -// 删除着色器 + +// 删除着色器，它们已经链接到我们的程序中了，已经不再需要了 glDeleteShader(vertex); glDeleteShader(fragment); ``` -最后我们也要实现Use函数： +最后我们也会实现Use函数： ```c++ void Use() @@ -426,7 +427,7 @@ void Use() } ``` -现在我们写完了一个完整的着色器类。使用着色器类很简单；我们创建一个着色器对象以后，就可以简单的使用了： +现在我们就写完了一个完整的着色器类。使用这个着色器类很简单；只要创建一个着色器对象，从那一点开始我们就可以开始使用了： ```c++ Shader ourShader("path/to/shaders/shader.vs", "path/to/shaders/shader.frag"); @@ -441,10 +442,10 @@ while(...) 我们把顶点和片段着色器储存为两个叫做`shader.vs`和`shader.frag`的文件。你可以使用自己喜欢的名字命名着色器文件；我自己觉得用`.vs`和`.frag`作为扩展名很直观。 -使用新着色器类的[程序](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-using-object)，[着色器类](http://learnopengl.com/code_viewer.php?type=header&code=shader)，[顶点着色器](http://learnopengl.com/code_viewer.php?type=vertex&code=getting-started/basic)，[片段着色器](http://learnopengl.com/code_viewer.php?type=fragment&code=getting-started/basic)。 +源码：[使用新着色器类的程序](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-using-object)，[着色器类](http://learnopengl.com/code_viewer.php?type=header&code=shader)，[顶点着色器](http://learnopengl.com/code_viewer.php?type=vertex&code=getting-started/basic)，和[片段着色器](http://learnopengl.com/code_viewer.php?type=fragment&code=getting-started/basic)。 # 练习 1. 修改顶点着色器让三角形上下颠倒：[参考解答](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-exercise1) -2. 通过使用uniform定义一个水平偏移，在顶点着色器中使用这个偏移量把三角形移动到屏幕右侧：[参考解答](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-exercise2) -3. 使用`out`关键字把顶点位置输出到片段着色器，把像素的颜色设置为与顶点位置相等(看看顶点位置值是如何在三角形中进行插值的)。做完这些后，尝试回答下面的问题：为什么在三角形的左下角是黑的?：[参考解答](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-exercise3) \ No newline at end of file +2. 使用uniform定义一个水平偏移量，在顶点着色器中使用这个偏移量把三角形移动到屏幕右侧：[参考解答](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-exercise2) +3. 使用`out`关键字把顶点位置输出到片段着色器，并将片段的颜色设置为与顶点位置相等（来看看连顶点位置值都在三角形中被插值的结果）。做完这些后，尝试回答下面的问题：为什么在三角形的左下角是黑的?：[参考解答](http://learnopengl.com/code_viewer.php?code=getting-started/shaders-exercise3) \ No newline at end of file diff --git a/docs/img/01/05/shaders.png b/docs/img/01/05/shaders.png new file mode 100644 index 0000000000000000000000000000000000000000..b66c3a3d652bd0dfe23994c3b7210586624f864a GIT binary patch literal 14193 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%0D91X_s> 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