名称
glUseProgram- 使用程序对象作为当前渲染状态的一部分
C规范
void glUseProgram(GLuint program);
参数
program
指定程序对象的句柄,该程序对象的可执行文件将用作当前渲染状态的一部分。
描述
glUseProgram使用程序对象program作为当前渲染状态的一部分。通过使用glAttachShader成功将着色器对象附加到程序对象,使用glCompileShader成功编译着色器对象,并成功链接程序对象与glLinkProgram,之后就可以在程序对象中创建每个阶段的可执行文件。
程序对象将会包含一个可执行文件,该文件将会运行顶点(类型为GL_VERTEX_SHADER
的着色器对象)和片元(类型为GL_FRAGMENT_SHADER
的着色器对象)处理器(前提是这两个着色器都成功的编译并被链接到程序对象上了)。
在使用程序对象时,应用程序可以自由修改附着的着色器对象,编译附着的着色器对象,附着着色器对象以及分离或删除着色器对象。这些操作都不会影响属于当前状态的可执行文件。但是,如果链接操作成功,则重新链接当前正在使用的程序对象将安装程序对象作为当前渲染状态的一部分(请参阅glLinkProgram)。如果当前正在使用的程序对象重新链接失败,其链接状态将设置为GL_FALSE,但可执行文件和关联状态将保持当前状态的一部分,直到后续调用glUseProgram将其从使用中删除。从使用中删除后,在成功重新链接之前,它不能成为当前状态的一部分。
如果program为0,则当前呈现状态引用无效的程序对象,并且会使得任何glDrawArrays或glDrawElements命令的顶点和片段着色器执行的结果未定义。
注意
与纹理对象和缓冲区对象一样,只要上下文的服务器端共享相同的地址空间,程序对象的名称空间就可以在一组上下文中共享。如果名称空间跨上下文共享,则也会共享任何附着对象和与这些附着对象关联的数据。
当从不同的执行线程访问对象时,应用程序负责跨API调用提供同步。
错误
GL_INVALID_VALUE
:如果program是0,或者不是OpenGL生成的值。
GL_INVALID_OPERATION
:program不是程序对象
GL_INVALID_OPERATION
:如果program不能成为当前状态的一部分。
相关Gets
glGet 参数GL_CURRENT_PROGRAM
glGetActiveAttrib 使用有效的程序对象和活动属性变量的索引
glGetActiveUniform 使用有效的程序对象和活动的统一变量的索引
glGetAttachedShaders 使用有效的程序对象
glGetAttribLocation 使用有效的程序对象和属性变量的名称
glGetProgramiv 使用有效的程序对象和要查询的参数
glGetProgramInfoLog 使用有效的程序对象
glGetUniform 使用有效的程序对象和统一变量的位置
glGetUniformLocation 使用有效的程序对象和统一变量的名称
另见
glAttachShader,glBindAttribLocation,glBindAttribLocation,glCreateProgram,glDeleteProgram,glDeleteShader,glLinkProgram,glGetUniform ,glValidateProgram,glVertexAttrib
版权
https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glUseProgram.xml
https://blog.csdn.net/flycatdeng
Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.