GLAPI/glGetUniformSubroutine: Difference between revisions
m Renaming category: 'API Reference 4' to 'Core API Reference'. |
m Bot: Adding better formatting. |
||
| Line 9: | Line 9: | ||
== Function Definition == | == Function Definition == | ||
void '''glGetUniformSubroutineuiv'''(GLenum | void '''glGetUniformSubroutineuiv'''(GLenum {{param|shadertype}}, GLint {{param|location}}, GLuint *{{param|values}}); | ||
; shadertype | ; shadertype | ||
: Specifies the shader stage from which to query for subroutine uniform index. | : Specifies the shader stage from which to query for subroutine uniform index. {{param|shadertype}} must be one of {{code|GL_VERTEX_SHADER}}, {{code|GL_TESS_CONTROL_SHADER}}, {{code|GL_TESS_EVALUATION_SHADER}}, {{code|GL_GEOMETRY_SHADER}} or {{code|GL_FRAGMENT_SHADER}}. | ||
; location | ; location | ||
: Specifies the location of the subroutine uniform. | : Specifies the location of the subroutine uniform. | ||
| Line 20: | Line 20: | ||
== Description == | == Description == | ||
'''glGetUniformSubroutine''' retrieves the value of the subroutine uniform at location | '''glGetUniformSubroutine''' retrieves the value of the subroutine uniform at location {{param|location}} for shader stage {{param|shadertype}} of the current program. {{param|location}} must be less than the value of {{code|GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS}} for the shader currently in use at shader stage {{param|shadertype}}. The value of the subroutine uniform is returned in {{param|values}}. | ||
== Errors == | == Errors == | ||
{{code|GL_INVALID_ENUM}} is generated if | {{code|GL_INVALID_ENUM}} is generated if {{param|shadertype}} is not one of the accepted values. | ||
{{code|GL_INVALID_VALUE}} is generated if | {{code|GL_INVALID_VALUE}} is generated if {{param|location}} is greater than or equal to the value of {{code|GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS}} for the shader currently in use at shader stage {{param|shadertype}}. | ||
{{code|GL_INVALID_OPERATION}} is generated if no program is active. | {{code|GL_INVALID_OPERATION}} is generated if no program is active. | ||
| Line 32: | Line 32: | ||
== See Also == | == See Also == | ||
{{apifunc|glGetProgram}}, {{apifunc|glGetActiveSubroutineUniform}}, {{apifunc|glGetActiveSubroutineUniformName}}, {{apifunc|glGetUniformLocation}} | |||
== Copyright == | == Copyright == | ||
Revision as of 01:22, 29 April 2012
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 4.0 | |
| Core ARB extension | ARB_shader_subroutine | |
glGetUniformSubroutine: retrieve the value of a subroutine uniform of a given shader stage of the current program
Function Definition
void glGetUniformSubroutineuiv(GLenum shadertype, GLint location, GLuint *values);
- shadertype
- Specifies the shader stage from which to query for subroutine uniform index. shadertype must be one of GL_VERTEX_SHADER, GL_TESS_CONTROL_SHADER, GL_TESS_EVALUATION_SHADER, GL_GEOMETRY_SHADER or GL_FRAGMENT_SHADER.
- location
- Specifies the location of the subroutine uniform.
- values
- Specifies the address of a variable to receive the value or values of the subroutine uniform.
Description
glGetUniformSubroutine retrieves the value of the subroutine uniform at location location for shader stage shadertype of the current program. location must be less than the value of GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS for the shader currently in use at shader stage shadertype. The value of the subroutine uniform is returned in values.
Errors
GL_INVALID_ENUM is generated if shadertype is not one of the accepted values.
GL_INVALID_VALUE is generated if location is greater than or equal to the value of GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS for the shader currently in use at shader stage shadertype.
GL_INVALID_OPERATION is generated if no program is active.
See Also
glGetProgram, glGetActiveSubroutineUniform, glGetActiveSubroutineUniformName, glGetUniformLocation
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/.