Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gluseprogramstages(3g) [centos man page]

GLUSEPROGRAMSTAGES(3G)						   OpenGL Manual					    GLUSEPROGRAMSTAGES(3G)

NAME

       glUseProgramStages - bind stages of a program object to a program pipeline

C SPECIFICATION

       void glUseProgramStages(GLuint pipeline, GLbitfield stages, GLuint program);

PARAMETERS

       pipeline
	   Specifies the program pipeline object to which to bind stages from program.

       stages
	   Specifies a set of program stages to bind to the program pipeline object.

       program
	   Specifies the program object containing the shader executables to use in pipeline.

DESCRIPTION

       glUseProgramStages binds executables from a program object associated with a specified set of shader stages to the program pipeline object
       given by pipeline.  pipeline specifies the program pipeline object to which to bind the executables.  stages contains a logical combination
       of bits indicating the shader stages to use within program with the program pipeline object pipeline.  stages must be a logical combination
       of GL_VERTEX_SHADER_BIT, GL_TESS_CONTROL_SHADER_BIT, GL_TESS_EVALUATION_SHADER_BIT, GL_GEOMETRY_SHADER_BIT, GL_FRAGMENT_SHADER_BIT and
       GL_COMPUTE_SHADER_BIT. Additionally, the special value GL_ALL_SHADER_BITS may be specified to indicate that all executables contained in
       program should be installed in pipeline.

       If program refers to a program object with a valid shader attached for an indicated shader stage, glUseProgramStages installs the
       executable code for that stage in the indicated program pipeline object pipeline. If program is zero, or refers to a program object with no
       valid shader executable for a given stage, it is as if the pipeline object has no programmable stage configured for the indicated shader
       stages. If stages contains bits other than those listed above, and is not equal to GL_ALL_SHADER_BITS, an error is generated.

NOTES

       The GL_COMPUTE_SHADER_BIT bit is available only if the GL version is 4.3 or greater.

ERRORS

       GL_INVALID_VALUE is generated if shaders contains set bits that are not recognized, and is not the reserved value GL_ALL_SHADER_BITS.

       GL_INVALID_OPERATION is generated if program refers to a program object that was not linked with its GL_PROGRAM_SEPARABLE status set.

       GL_INVALID_OPERATION is generated if program refers to a program object that has not been successfully linked.

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

SEE ALSO

       glGenProgramPipelines(), glDeleteProgramPipelines(), glIsProgramPipeline()

COPYRIGHT

       Copyright (C) 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication
       License, v 1.0, 8 June 1999.  http://opencontent.org/openpub/.

AUTHORS

       opengl.org

opengl.org							    06/10/2014						    GLUSEPROGRAMSTAGES(3G)

Check Out this Related Man Page

GLPROGRAMPARAMETER(3G)						   OpenGL Manual					    GLPROGRAMPARAMETER(3G)

NAME

       glProgramParameter - specify a parameter for a program object

C SPECIFICATION

       void glProgramParameteri(GLuint program, GLenum pname, GLint value);

PARAMETERS

       program
	   Specifies the name of a program object whose parameter to modify.

       pname
	   Specifies the name of the parameter to modify.

       value
	   Specifies the new value of the parameter specified by pname for program.

DESCRIPTION

       glProgramParameter specifies a new value for the parameter nameed by pname for the program object program.

       If pname is GL_PROGRAM_BINARY_RETRIEVABLE_HINT, value should be GL_FALSE or GL_TRUE to indicate to the implementation the intention of the
       application to retrieve the program's binary representation with glGetProgramBinary(). The implementation may use this information to store
       information that may be useful for a future query of the program's binary. It is recommended to set GL_PROGRAM_BINARY_RETRIEVABLE_HINT for
       the program to GL_TRUE before calling glLinkProgram(), and using the program at run-time if the binary is to be retrieved later.

       If pname is GL_PROGRAM_SEPARABLE, value must be GL_TRUE or GL_FALSE and indicates whether program can be bound to individual pipeline
       stages via glUseProgramStages(). A program's GL_PROGRAM_SEPARABLE parameter must be set to GL_TRUEbeforeglLinkProgram() is called in order
       for it to be usable with a program pipeline object. The initial state of GL_PROGRAM_SEPARABLE is GL_FALSE.

ERRORS

       GL_INVALID_OPERATION is generated if program is not the name of an existing program object.

       GL_INVALID_ENUM is generated if pname is not one of the accepted values.

       GL_INVALID_VALUE is generated if value is not a valid value for the parameter named by pname.

ASSOCIATED GETS

       glGetProgram().

SEE ALSO

       glGetProgram(), glGetProgramBinary(), glProgramBinary()

COPYRIGHT

       Copyright (C) 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication
       License, v 1.0, 8 June 1999.  http://opencontent.org/openpub/.

AUTHORS

       opengl.org

opengl.org							    06/10/2014						    GLPROGRAMPARAMETER(3G)
Man Page