WebGLRenderingContext.activeTexture()

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.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.

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

Spécification Statué Commentaire
WebGL 1.0
La définition de 'activeTexture' dans cette spécification.
Recommendation Définition initiale.
OpenGL ES 2.0
La définition de 'glActiveTexture' dans cette spécification.
Standard Page man de l'API OpenGL.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
Support simpleChrome Support complet 9Edge Support complet 12Firefox Support complet 4IE Support complet 11Opera Support complet 12Safari Support complet 5.1WebView Android Support complet OuiChrome Android Support complet 25Edge Mobile Support complet OuiFirefox Android Support complet OuiOpera Android Support complet 12Safari iOS Support complet 8.1Samsung Internet Android Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : NemoNobobyPersonne
Dernière mise à jour par : NemoNobobyPersonne,