WebGLRenderingContext.activeTexture()
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.TEXTUREIoù I 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
BCD tables only load in the browser