From df10fe28da162fa8518e35953420bfbd7c42fee5 Mon Sep 17 00:00:00 2001 From: wuweizhou Date: Tue, 23 Jun 2015 17:18:54 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E5=9B=BE=E7=89=87=E8=B5=84?= =?UTF-8?q?=E6=BA=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 01 Getting started/05 Shaders.md | 99 ++++++++++++++++++++++++++++++- 01 Getting started/pic1.jpg | Bin 0 -> 48619 bytes 2 files changed, 96 insertions(+), 3 deletions(-) create mode 100644 01 Getting started/pic1.jpg diff --git a/01 Getting started/05 Shaders.md b/01 Getting started/05 Shaders.md index 2ff0c4d..a3fc661 100644 --- a/01 Getting started/05 Shaders.md +++ b/01 Getting started/05 Shaders.md @@ -1,6 +1,99 @@ 本文作者JoeyDeVries,由codeman001翻译自[http://learnopengl.com](http://learnopengl.com/#!Getting-started/Shaders) -##Shaders +##着色器 -未翻译完成... ---- +在[Hello Triangle](https://github.com/Geequlim/LearnOpenGL-CN/blob/master/01%20Getting%20started/04%20Hello%20Triangle.md) 中已经提到,着色器是在GPU上运行的小程序,这些程序负责处理图形渲染管线的特定阶段,简单来说,着色器也是一个处理输入输出的程序。着色器是非常孤立执行的程序,彼此之间没有太多的交互, + +在前面的教程中,我们大致介绍了表面着色器和如何正确使用它们。接下来我们讲接触更加流行的OpenGL着色语言 + +###GLSL +GLSL是写法类似C语言,GLSL是专门针对图形以及向量和矩阵变化设计的。着色器通常开始生命一个版本信息,然后是输入、输出列表以及常量和入口函数(main函数),每个着色器都是在入口函数处来处理输入参数。然后输出结果。 + + +着色器通常具有以下结构: + + #version version_number + in type in_variable_name; + in type in_variable_name; + 6.2 Types 52 + out type out_variable_name; + uniform type uniform_name; + int main() + { + // Process input(s) and do some weird graphics stuff + ... + // Output processed stuff to output variable + out_variable_name = weird_stuff_we_processed; + } + +所谓的顶点着色器就讲顶点属性作为输入的着色器,顶点属性的个数主要受限于硬件实现,OpenGL的保证总有至少16个四分量的顶点可以使用,但是硬件可能个多些,可以通过查询:**GL_MAX_VERTEX_ATTRIBS** + + GLint nrAttributes; + glGetIntegerv(GL_MAX_VERTEX_ATTRIBS, &nrAttributes); + std::cout << "Maximum nr of vertex attributes supported: " << nrAttributes << std::endl; + +这个结果最小返回16,一般情况下使用。 + +###类型 + + +GLSL跟一般的编程语言一样,定义了一些常用的数据类型,基础类型比如:int,float, double, uint and bool等,还用两种我们在教程中经常用到的容器类型:vectors(向量) 和 matrices(矩阵),稍后会提到。 + + +####向量 +一个向量可以包含1-4个分量,分量的类型可以是上面我们提到的基础类型。向量个类型名字规则如下: + +- vecn: 默认向量,有个n浮点型分量. +- bvecn: 有n个bool分量. +- ivecn: 有n个整型分量. +- uvecn: 有n个无符号整型分量. +- dvecn: 有n个双浮点型分量. + +大多数情况下我们使用vecn,因为浮点型足够满足我们大多数需求。 +向量的分量可以通过vec.x来访问第一个分量,同时可以使用.x,.y,.z,.w来访问一个向量的四个成员,同样可以使用rgba来访问颜色值对应的向量,纹理坐标则可以使用stpq来访问分量的值。 +向量的访问方式支持趣味性和扩展性,被称为交叉混合性,实例如下: + + vec2 someVec; + vec4 differentVec = someVec.xyxx; + vec3 anotherVec = differentVec.zyw; + vec4 otherVec = someVec.xxxx + anotherVec.yxzy; +可以使用任意组合来组成新向量,同时也可以把维度小的向量放在高纬度向量的构造函数里来构成新的向量。如下代码: + + vec2 vect = vec2(0.5f, 0.7f); + vec4 result = vec4(vect, 0.0f, 0.0f); + vec4 otherResult = vec4(result.xyz, 1.0f); + +###输入和输出 +着色器是运行在GPU上的小程序,但是麻雀虽小五脏俱全,也会有输入和输出来构成完整的程序,GLSL使用in和out关键字来定义输入和输出。每个着色器可以是这些关键字来指定输入和输出,输入变量经过处理以后会得到适合下个处理阶段可以使用的输出变量,顶点着色器和片段着色器有点小却别。 + +顶点着色器接受特定格式的输入,否则不能正确使用。顶点着色器直接接受输入的顶点数据,但是需要在CPU一边指定数据的对应的位置,前面的教程可以到对位置0的输入(location=0),所以顶点着色器需要一个特定的声明来确定CPU和GPU数据对应关联关系, + + 也可以使用*glGetAttribLocation*来查询对应的位置,这样可以省略layout的声明,但是我觉得可以是用layout声明比较好,这也可以减少GPU的一些工作 +对于片段着色器有个vec4的颜色作为特定的输出,因为片段处理后最终是要生产一个颜色来显示的。否则将输出黑色或白色颜色作为输出。 + +如果我们想从一个着色器向另外一个发送数据,我们需要在发送方定义一个输出,然后再接收方顶一个输入,同时保证这两个变量类型和名字是相同的。 +下面是一个实例来展示如何从顶点着色器传递一个颜色值跟片段着色器使用: + +***顶点着色器*** + + #version 330 core + layout (location = 0) in vec3 position; // The position variable has attribute position 0 + out vec4 vertexColor; // Specify a color output to the fragment shader + void main() + { + gl_Position = vec4(position, 1.0); + vertexColor = vec4(0.5f, 0.0f, 0.0f, 1.0f); + } + +***片段着色器*** + + #version 330 core + in vec4 vertexColor; // 从顶点着色器获得输入 (名字和类型都是一样的) + out vec4 color; + void main() + { + color = vertexColor; + } + +可以看到在顶点着色器生命了一个向量:*vertexColor* 有out修饰,同时在片段着色器声明了一个*vertexColor* 使用in来修饰,这样片段着色器就可以获取顶点着色器处理的*vertexColor*的结果了。 +根据上面shader,可以得出下图的效果: \ No newline at end of file diff --git a/01 Getting started/pic1.jpg b/01 Getting started/pic1.jpg new file mode 100644 index 0000000000000000000000000000000000000000..3386c147d785401cef0abebb6d6784eef8e36477 GIT binary patch literal 48619 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 -N7^a`eTI7UXpvy+n1RL`OC>AHMW{+`jr-i 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 Qg&fc3!rvL|GoruvAI|J1VE_OC literal 0 HcmV?d00001