The WebGLRenderingContext.activeTexture()
method of the WebGL API specifies which texture unit to make active.
WebGLRenderingContext.activeTexture()
Syntax
activeTexture(texture)
Parameters
-
texture
-
The texture unit to make active. The value is a
gl.TEXTUREI
where I is within the range from 0 togl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1
.
Return value
None.
Exceptions
If texture is not one of gl.TEXTUREI
, where I is within the range from 0 to gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1
, a gl.INVALID_ENUM
error is thrown.
Examples
The following call selects gl.TEXTURE1
as the current texture. Subsequent calls that modify the texture state will affect this texture.
gl.activeTexture(gl.TEXTURE1);
The number of texture units is implementation dependent, you can get this number with the help of the MAX_COMBINED_TEXTURE_IMAGE_UNITS
constant. It is, per specification, at least 8.
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
To get the active texture, query the ACTIVE_TEXTURE
constant.
gl.activeTexture(gl.TEXTURE0); gl.getParameter(gl.ACTIVE_TEXTURE); // returns "33984" (0x84C0, gl.TEXTURE0 enum value)
Specifications
Specification |
---|
WebGL Specification # 5.14.3 |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
activeTexture |
9
|
12
|
4
|
11
|
12
|
5.1
|
4.4.3
|
25
|
4
|
12
|
8
|
1.5
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/activeTexture