GLAPI/glUniformSubroutines: 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 '''glUniformSubroutinesuiv'''(GLenum | void '''glUniformSubroutinesuiv'''(GLenum {{param|shadertype}}, GLsizei {{param|count}}, const GLuint *{{param|indices}}); | ||
; 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}}. | ||
; count | ; count | ||
: Specifies the number of uniform indices stored in | : Specifies the number of uniform indices stored in {{param|indices}}. | ||
; indices | ; indices | ||
: Specifies the address of an array holding the indices to load into the shader subroutine variables. | : Specifies the address of an array holding the indices to load into the shader subroutine variables. | ||
| Line 20: | Line 20: | ||
== Description == | == Description == | ||
'''glUniformSubroutines''' loads all active subroutine uniforms for shader stage | '''glUniformSubroutines''' loads all active subroutine uniforms for shader stage {{param|shadertype}} of the current program with subroutine indices from {{param|indices}}, storing {{param|indices[i]}} into the uniform at location {{param|i}}. {{param|count}} must be equal to the value of {{code|GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS}} for the program currently in use at shader stage {{param|shadertype}}. Furthermore, all values in {{param|indices}} must be less than the value of {{code|GL_ACTIVE_SUBROUTINES}} for the shader stage. | ||
== Errors == | == Errors == | ||
| Line 26: | Line 26: | ||
{{code|GL_INVALID_OPERATION}} is generated if no program object is current. | {{code|GL_INVALID_OPERATION}} is generated if no program object is current. | ||
{{code|GL_INVALID_VALUE}} is generated if | {{code|GL_INVALID_VALUE}} is generated if {{param|count}} is not equal to the value of {{code|GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS}} for the shader stage {{param|shadertype}} of the current program. | ||
{{code|GL_INVALID_VALUE}} is generated if any value in | {{code|GL_INVALID_VALUE}} is generated if any value in {{param|indices}} is geater than or equal to the value of {{code|GL_ACTIVE_SUBROUTINES}} for the shader stage {{param|shadertype}} of the current program. | ||
{{code|GL_INVALID_ENUM}} is generated if | {{code|GL_INVALID_ENUM}} is generated if {{param|shadertype}} is not one of the accepted values. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glGetProgramStage}} with argument {{code|GL_ACTIVE_SUBROUTINES}} | |||
{{apifunc|glGetProgramStage}} with argument {{code|GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS}} | |||
== See Also == | == See Also == | ||
{{apifunc|glGetProgram}}, {{apifunc|glGetActiveSubroutineUniform}}, {{apifunc|glGetActiveSubroutineUniformName}}, {{apifunc|glGetProgramStage}} | |||
== Copyright == | == Copyright == | ||
Revision as of 01:26, 29 April 2012
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 4.0 | |
| Core ARB extension | ARB_shader_subroutine | |
glUniformSubroutines: load active subroutine uniforms
Function Definition
void glUniformSubroutinesuiv(GLenum shadertype, GLsizei count, const GLuint *indices);
- 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.
- count
- Specifies the number of uniform indices stored in indices.
- indices
- Specifies the address of an array holding the indices to load into the shader subroutine variables.
Description
glUniformSubroutines loads all active subroutine uniforms for shader stage shadertype of the current program with subroutine indices from indices, storing indices[i] into the uniform at location i. count must be equal to the value of GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS for the program currently in use at shader stage shadertype. Furthermore, all values in indices must be less than the value of GL_ACTIVE_SUBROUTINES for the shader stage.
Errors
GL_INVALID_OPERATION is generated if no program object is current.
GL_INVALID_VALUE is generated if count is not equal to the value of GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS for the shader stage shadertype of the current program.
GL_INVALID_VALUE is generated if any value in indices is geater than or equal to the value of GL_ACTIVE_SUBROUTINES for the shader stage shadertype of the current program.
GL_INVALID_ENUM is generated if shadertype is not one of the accepted values.
Associated Gets
glGetProgramStage with argument GL_ACTIVE_SUBROUTINES
glGetProgramStage with argument GL_ACTIVE_SUBROUTINE_UNIFORM_LOCATIONS
See Also
glGetProgram, glGetActiveSubroutineUniform, glGetActiveSubroutineUniformName, glGetProgramStage
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/.