The WebGLRenderingContext.activeTexture()
method of the WebGL API specifies which texture unit to make active.
The WebGLRenderingContext.activeTexture()
method of the WebGL API specifies which texture unit to make active.
js
activeTexture(texture)
texture
The texture unit to make active. The value is a gl.TEXTUREI
where I is within the range from 0 to gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1
.
None (undefined
).
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.
The following call selects gl.TEXTURE1
as the current texture. Subsequent calls that modify the texture state will affect this texture.
js
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.
js
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
To get the active texture, query the ACTIVE_TEXTURE
constant.
js
gl.activeTexture(gl.TEXTURE0); gl.getParameter(gl.ACTIVE_TEXTURE); // returns "33984" (0x84C0, gl.TEXTURE0 enum value)
Specification |
---|
WebGL Specification # 5.14.3 |
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 |
© 2005–2023 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