WebGLRenderingContext.activeTexture()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode WebGLRenderingContext.activeTexture() de l'API WebGL indique quelle unité de texture doit être rendue active.

Syntaxe

js
void gl.activeTexture(texture);

Paramètres

texture

L'unité de texture à rendre active. La valueur est une gl.TEXTUREII est dans la plage de 0 à gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1.

Valeur retournée

Aucune.

Exceptions

Si texture n'est pas l'une des gl.TEXTUREI, où I est dans la plage de 0 à gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1, une erreur gl.INVALID_ENUM est déclenchée.

Exemples

L'appel suivant choisit gl.TEXTURE1 comme texture en cours. Les appels suivants qui modifient l'état de la texture affecteront cette texture.

js
gl.activeTexture(gl.TEXTURE1);

Le nombre d'unités de texture dépend de l'implémentation, vous pouvez obtenir ce nombre à l'aide de la constante MAX_COMBINED_TEXTURE_IMAGE_UNITS. Il est, de par la spécification, d'au moins 8.

js
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);

Pour obtenir la texture en cours, faire une requête sur la constante ACTIVE_TEXTURE.

js
gl.activeTexture(gl.TEXTURE0);
gl.getParameter(gl.ACTIVE_TEXTURE);
// retourne "33984" (0x84C0, valeur enum pour gl.TEXTURE0)

Spécifications

Specification
WebGL Specification
# 5.14.3

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
activeTexture

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi