glBindProgramPipeline.3G - Man Page

bind a program pipeline to the current context

C Specification

void glBindProgramPipeline(GLuint pipeline);

Parameters

pipeline

Specifies the name of the pipeline object to bind to the context.

Description

glBindProgramPipeline binds a program pipeline object to the current context. pipeline must be a name previously returned from a call to glGenProgramPipelines(). If no program pipeline exists with name pipeline then a new pipeline object is created with that name and initialized to the default state vector.

When a program pipeline object is bound using glBindProgramPipeline, any previous binding is broken and is replaced with a binding to the specified pipeline object. If pipeline is zero, the previous binding is broken and is not replaced, leaving no pipeline object bound. If no current program object has been established by glUseProgram(), the program objects used for each stage and for uniform updates are taken from the bound program pipeline object, if any. If there is a current program object established by glUseProgram(), the bound program pipeline object has no effect on rendering or uniform updates. When a bound program pipeline object is used for rendering, individual shader executables are taken from its program objects.

Errors

GL_INVALID_OPERATION is generated if pipeline is not zero or a name previously returned from a call to glGenProgramPipelines() or if such a name has been deleted by a call to glDeleteProgramPipelines().

Version Support

OpenGL Version
Function / Feature Name2.02.13.03.13.23.34.04.14.24.34.44.5
glBindProgramPipeline-------

See Also

glCreateShader(), glCreateProgram(), glCompileShader(), glLinkProgram(), glGenProgramPipelines(), glDeleteProgramPipelines(), glIsProgramPipeline()

Referenced By

glCreateProgramPipelines.3G(3), glDeleteProgramPipelines.3G(3), glGenProgramPipelines.3G(3), glGetProgramPipeline.3G(3), glGetProgramPipelineInfoLog.3G(3), glIsProgramPipeline.3G(3), glValidateProgramPipeline.3G(3).

07/18/2024