GLAPI/glGetUniformSubroutine: Difference between revisions
m Bot: Adding better formatting. |
m Bot: Adding better formatting. |
||
| Line 12: | Line 12: | ||
; shadertype | ; shadertype | ||
: Specifies the shader stage from which to query for subroutine uniform index. {{param|shadertype}} must be one of {{ | : Specifies the shader stage from which to query for subroutine uniform index. {{param|shadertype}} must be one of {{enum|GL_VERTEX_SHADER}}, {{enum|GL_TESS_CONTROL_SHADER}}, {{enum|GL_TESS_EVALUATION_SHADER}}, {{enum|GL_GEOMETRY_SHADER}} or {{enum|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 {{param|location}} for shader stage {{param|shadertype}} of the current program. {{param|location}} must be less than the value of {{ | '''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 {{enum|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 == | ||
{{ | {{enum|GL_INVALID_ENUM}} is generated if {{param|shadertype}} is not one of the accepted values. | ||
{{ | {{enum|GL_INVALID_VALUE}} is generated if {{param|location}} is greater than or equal to the value of {{enum|GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS}} for the shader currently in use at shader stage {{param|shadertype}}. | ||
{{ | {{enum|GL_INVALID_OPERATION}} is generated if no program is active. | ||
== See Also == | == See Also == | ||
Revision as of 17:25, 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/.