GLAPI/glValidateProgramPipeline: Difference between revisions
m Bot: Adding better formatting. |
m Bot: Adding better formatting. |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 18: | Line 18: | ||
'''glValidateProgramPipeline''' instructs the implementation to validate the shader executables contained in {{param|pipeline}} against the current GL state. The implementation may use this as an opportunity to perform any internal shader modifications that may be required to ensure correct operation of the installed shaders given the current GL state. | '''glValidateProgramPipeline''' instructs the implementation to validate the shader executables contained in {{param|pipeline}} against the current GL state. The implementation may use this as an opportunity to perform any internal shader modifications that may be required to ensure correct operation of the installed shaders given the current GL state. | ||
After a program pipeline has been validated, its validation status is set to {{ | After a program pipeline has been validated, its validation status is set to {{enum|GL_TRUE}}. The validation status of a program pipeline object may be queried by calling {{apifunc|glGetProgramPipeline}} with parameter {{enum|GL_VALIDATE_STATUS}}. | ||
If {{param|pipeline}} is a name previously returned from a call to {{apifunc|glGenProgramPipelines}} but that has not yet been bound by a call to {{apifunc|glBindProgramPipeline}}, a new program pipeline object is created with name {{param|pipeline}} and the default state vector. | If {{param|pipeline}} is a name previously returned from a call to {{apifunc|glGenProgramPipelines}} but that has not yet been bound by a call to {{apifunc|glBindProgramPipeline}}, a new program pipeline object is created with name {{param|pipeline}} and the default state vector. | ||
| Line 24: | Line 24: | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_OPERATION}} is generated if {{param|pipeline}} is not a name previously returned from a call to {{apifunc|glGenProgramPipelines}} or if such a name has been deleted by a call to {{apifunc|glDeleteProgramPipelines}}. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glGetProgramPipeline}} with parameter {{ | {{apifunc|glGetProgramPipeline}} with parameter {{enum|GL_VALIDATE_STATUS}}. | ||
{{apifunc|glGetProgramPipelineInfoLog}}. | |||
== See Also == | == See Also == | ||
{{apifunc|glGenProgramPipelines}}, {{apifunc|glBindProgramPipeline}}, {{apifunc|glDeleteProgramPipelines}} | {{apifunc|glGenProgramPipelines}}, {{apifunc|glBindProgramPipeline}}, {{apifunc|glDeleteProgramPipelines}}, {{apifunc|glUseProgramStages}}, {{apifunc|glValidateProgram}} | ||
== Copyright == | == Copyright == | ||
| Line 40: | Line 42: | ||
[[Category:Core API Reference|ValidateProgramPipeline]] | [[Category:Core API Reference|ValidateProgramPipeline]] | ||
[[Category:Core API Ref Shader Program Creation|ValidateProgramPipeline]] | [[Category:Core API Ref Shader Program Creation|ValidateProgramPipeline]] | ||
[[Category:Program Pipeline Object API State Functions|ValidateProgramPipeline]] | |||
Latest revision as of 10:06, 15 August 2013
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 4.1 | |
| Core ARB extension | ARB_separate_shader_objects | |
glValidateProgramPipeline: validate a program pipeline object against current GL state
Function Definition
void glValidateProgramPipeline(GLuint pipeline);
- pipeline
- Specifies the name of a program pipeline object to validate.
Description
glValidateProgramPipeline instructs the implementation to validate the shader executables contained in pipeline against the current GL state. The implementation may use this as an opportunity to perform any internal shader modifications that may be required to ensure correct operation of the installed shaders given the current GL state.
After a program pipeline has been validated, its validation status is set to GL_TRUE. The validation status of a program pipeline object may be queried by calling glGetProgramPipeline with parameter GL_VALIDATE_STATUS.
If pipeline is a name previously returned from a call to glGenProgramPipelines but that has not yet been bound by a call to glBindProgramPipeline, a new program pipeline object is created with name pipeline and the default state vector.
Errors
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.
Associated Gets
glGetProgramPipeline with parameter GL_VALIDATE_STATUS.
See Also
glGenProgramPipelines, glBindProgramPipeline, glDeleteProgramPipelines, glUseProgramStages, glValidateProgram
Copyright
Copyright © 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/.