WebGLRenderingContext.activeTexture()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode WebGLRenderingContext.activeTexture() de l'API WebGL indique quelle unité de texture doit être rendue active.
Syntaxe
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.
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.
gl.getParameter(gl.MAX_COMBINED_TEXTURE_IMAGE_UNITS);
Pour obtenir la texture en cours, faire une requête sur la constante ACTIVE_TEXTURE.
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
Chargement…