GLES2.0中文API-glLinkProgram

名称

glLinkProgram- 连接一个program对象。

C规范

void glLinkProgram（GLuint program）;

参数

program

指定要链接的program对象的句柄。

描述

glLinkProgram链接program指定的program对象。附加到program的类型为GL_VERTEX_SHADER的着色器对象用于创建将在可编程顶点处理器上运行的可执行文件。 附加到program的类型为GL_FRAGMENT_SHADER的着色器对象用于创建将在可编程片段处理器上运行的可执行文件。

链接操作的状态将存储为program对象状态的一部分。 如果程序对象链接没有错误并且可以使用，则此值将设置为GL_TRUE，否则将设置为GL_FALSE。 可以通过使用参数program和GL_LINK_STATUS调用glGetShaderiv来查询它。

作为链接操作成功的结果，属于program的所有激活的用户定义的统一变量的值将被初始化为0，并且将为每个program对象的活动统一变量分配一个可以通过调用glGetUniformLocation来查询的位置。 此外，任何尚未绑定到通用顶点属性索引的活动用户定义属性变量此时也将绑定到一个索引。

由于OpenGL ES着色语言规范中指定的多种原因，program对象的链接可能会失败。 以下列出了导致链接错误的一些条件:

• 顶点着色器和片元着色器不同时存在于程序对象中。
• 已超出支持的活动属性变量数。
• 已超出统一变量的存储限制。
• 已超出支持的活动统一变量的数量。
• 顶点着色器或片段着色器缺失main函数。
• 片元着色器中实际使用的易变变量未在顶点着色器中以相同的方式声明（或根本未声明）。
• 对函数或变量名的引用尚未解析。
• 使用两种不同类型或两种不同的初始值声明的全局共享变量。
• 一个或多个附加的着色器对象尚未成功编译（通过glCompileShader）或未成功加载预编译的着色器二进制文件（通过glShaderBinary）。
• 绑定通用属性矩阵导致矩阵的某些行超出允许的最大值GL_MAX_VERTEX_ATTRIBS。
• 没有足够的连续顶点属性槽来绑定属性矩阵

成功链接program对象后，可以通过调用glUseProgram使program对象成为当前状态的一部分。 无论链接操作是否成功，program对象的信息日志都将被覆盖。 可以通过调用glGetProgramInfoLog来检索信息日志。

如果链接操作成功并且由于先前调用glUseProgram而指定的program对象当前已被使用，glLinkProgram还将安装生成的可执行文件作为当前呈现状态的一部分。如果当前正在使用的program对象重新链接失败，其链接状态将设置为GL_FALSE，但可执行文件和关联状态将保持当前状态的一部分，直到后续调用glUseProgram将其从使用中删除。 从使用中删除后，在成功重新链接之前，它不能成为当前状态的一部分。

链接操作完成时，program对象的信息日志就被更新了，而且程序也被生成了。在链接操作之后，应用程序可以自由修改附加的着色器对象，编译附加的着色器对象，分离着色器对象，删除着色器对象以及附加其他着色器对象。 这些操作都不会影响信息日志或作为程序对象一部分的程序。

注意

如果链接操作不成功，则关于程序上的先前链接操作的任何信息都将丢失（即，失败的链接不会恢复旧的程序状态）。 即使链接操作不成功，仍然可以从程序中检索某些信息。 例如，glGetActiveAttrib和glGetActiveUniform。

错误

GL_INVALID_VALUE：如果program或shader不是由OpenGL所生成的值。

GL_INVALID_OPERATION:如果program参数传的不是program对象。

相关Gets

glGet 参数：GL_CURRENT_PROGRAM

glGetActiveAttrib 参数：有效的program对象和激活状态的属性变量的句柄。

glGetActiveUniform 参数：有效的program对象和激活状态的统一变量的句柄。

glGetAttachedShaders 参数：有效的program对象

glGetAttribLocation 参数：有效的program对象和属性变量的名称（在shader中的变量字符串）。

glGetProgramiv 参数：有效的program对象和GL_LINK_STATUS

glGetProgramInfoLog 参数：有效的program对象

glGetUniform​​​​​​​ 参数：有效的program对象和一个统一变量地址

glGetUniformLocation​​​​​​​ 参数：有效的program对象和统一变量的名称（在shader中的变量字符串）。

glIsProgram​​​​​​​

另见

glAttachShader, glBindAttribLocation, glCompileShader, glShaderBinary, glCreateProgram, glDeleteProgram, glDetachShader, glUniform, glUseProgram, glValidateProgram

版权

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glLinkProgram.xml

https://blog.csdn.net/flycatdeng

Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.

Android,OpenGL ES,图形学