GLAPI/glActiveTexture: Difference between revisions
< GLAPI
m fixed sort key |
JeffKhronos (talk | contribs) |
||
| (12 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{infobox feature | {{infobox feature | ||
| name = glActiveTexture | | name = glActiveTexture | ||
| core = 1. | | core = 1.3 | ||
}} | }} | ||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glActiveTexture'''(GLenum | void '''glActiveTexture'''(GLenum {{param|texture}}); | ||
; texture | ; texture | ||
: Specifies which texture unit to make active. The number of texture units is implementation dependent, but must be at least 80. | : Specifies which texture unit to make active. The number of texture units is implementation dependent, but must be at least 96 (80 in GL 4.2, 48 in GL 3.3). {{param|texture}} must be one of {{enum|GL_TEXTURE''i''}}, where ''i'' ranges from 0 ({{enum|GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS}} - 1). The initial value is {{enum|GL_TEXTURE0}}. | ||
== Description == | == Description == | ||
'''glActiveTexture''' selects which texture unit subsequent texture state calls will affect. The number of texture units an implementation supports is implementation dependent, but must be at least 80. | '''glActiveTexture''' selects which texture unit subsequent texture state calls will affect. The number of texture units an implementation supports is implementation dependent, but must be at least 96 (80 in GL 4.2, 48 in GL 3.3). | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_ENUM}} is generated if {{param|texture}} is not one of {{enum|GL_TEXTURE''i''}}, where ''i'' ranges from 0 to ({{enum|GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS}} - 1). | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glGet}} with argument {{enum|GL_ACTIVE_TEXTURE}}, or {{enum|GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS}}. | |||
== See Also == | == See Also == | ||
{{apifunc|glBindTexture}}, {{apifunc|glCompressedTexImage1D}}, {{apifunc|glCompressedTexImage2D}}, {{apifunc|glCompressedTexImage3D}}, {{apifunc|glCompressedTexSubImage1D}}, {{apifunc|glCompressedTexSubImage2D}}, {{apifunc|glCompressedTexSubImage3D}}, {{apifunc|glCopyTexImage1D}}, {{apifunc|glCopyTexImage2D}}, {{apifunc|glCopyTexSubImage1D}}, {{apifunc|glCopyTexSubImage2D}}, {{apifunc|glCopyTexSubImage3D}}, {{apifunc|glGetTexImage}}, {{apifunc|glGetTexLevelParameter}}, {{apifunc|glGetTexParameter}}, {{apifunc|glGetCompressedTexImage}}, {{apifunc|glGenerateMipmap}}, {{apifunc|glTexBuffer}}, {{apifunc|glTexBufferRange}}, {{apifunc|glTexImage1D}}, {{apifunc|glTexImage2D}}, {{apifunc|glTexImage2DMultisample}}, {{apifunc|glTexImage3D}}, {{apifunc|glTexImage3DMultisample}}, {{apifunc|glTexStorage1D}}, {{apifunc|glTexStorage2D}}, {{apifunc|glTexStorage3D}}, {{apifunc|glTexSubImage1D}}, {{apifunc|glTexSubImage2D}}, {{apifunc|glTexSubImage3D}}, {{apifunc|glTexParameter}} | |||
* [[Texture]] | |||
* [[Sampler (GLSL)]] | |||
== Copyright == | == Copyright == | ||
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see [ | Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see [https://khronos.org/registry/OpenGL-Refpages/LICENSES/LicenseRef-FreeB.txt LicenseRef-FreeB]. | ||
[[Category:API Reference | [[Category:Core API Reference|ActiveTexture]] | ||
[[Category:Core API Ref Texturing|ActiveTexture]] | |||
Latest revision as of 21:40, 5 February 2021
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 1.3 | |
glActiveTexture: select active texture unit
Function Definition
void glActiveTexture(GLenum texture);
- texture
- Specifies which texture unit to make active. The number of texture units is implementation dependent, but must be at least 96 (80 in GL 4.2, 48 in GL 3.3). texture must be one of GL_TEXTUREi, where i ranges from 0 (GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1). The initial value is GL_TEXTURE0.
Description
glActiveTexture selects which texture unit subsequent texture state calls will affect. The number of texture units an implementation supports is implementation dependent, but must be at least 96 (80 in GL 4.2, 48 in GL 3.3).
Errors
GL_INVALID_ENUM is generated if texture is not one of GL_TEXTUREi, where i ranges from 0 to (GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1).
Associated Gets
glGet with argument GL_ACTIVE_TEXTURE, or GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS.
See Also
glBindTexture, glCompressedTexImage1D, glCompressedTexImage2D, glCompressedTexImage3D, glCompressedTexSubImage1D, glCompressedTexSubImage2D, glCompressedTexSubImage3D, glCopyTexImage1D, glCopyTexImage2D, glCopyTexSubImage1D, glCopyTexSubImage2D, glCopyTexSubImage3D, glGetTexImage, glGetTexLevelParameter, glGetTexParameter, glGetCompressedTexImage, glGenerateMipmap, glTexBuffer, glTexBufferRange, glTexImage1D, glTexImage2D, glTexImage2DMultisample, glTexImage3D, glTexImage3DMultisample, glTexStorage1D, glTexStorage2D, glTexStorage3D, glTexSubImage1D, glTexSubImage2D, glTexSubImage3D, glTexParameter
Copyright
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see LicenseRef-FreeB.