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.TEXTUREI
où 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