MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey-2018-1

WebGLRenderingContext.bindTexture()

La méthode WebGLRenderingContext.bindTexture() de l'API WebGL lie la WebGLTexture donnée à une cible (point de liaison).

Syntaxe

void gl.bindTexture(cible, texture);

Paramètres

cible
Un GLenum indiquant le point de liaison (cible). Valeurs possibles :
  • gl.TEXTURE_2D : une texture bidimensionnelle ;
  • gl.TEXTURE_CUBE_MAP : une texture mappée sur un cube ;
  • lors de l'utilisation d'un WebGL 2 context, les valeurs suivantes sont en outre disponibles :
    • gl.TEXTURE_3D : une texture tridimensionnelle ;
    • gl.TEXTURE_2D_ARRAY : une texture en tableau bidimensionnelle.
texture
Un objet WebGLTexture à lier.

Valeur retournée

Aucune.

Exceptions

Une erreur gl.INVALID_ENUM est déclenchée si cible n'est pas gl.TEXTURE_2D, gl.TEXTURE_CUBE_MAP, gl.TEXTURE_3D, ou gl.TEXTURE_2D_ARRAY.

Exemples

Liaison d'une texture

var canevas = document.getElementById('canevas');
var gl = canevas.getContext('webgl');
var texture = gl.createTexture();

gl.bindTexture(gl.TEXTURE_2D, texture);

Obtention des liaisons en cours

Pour vérifier la liaison de texture en cours, interrogez les constantes gl.TEXTURE_BINDING_2D ou gl.TEXTURE_BINDING_CUBE_MAP.

gl.getParameter(gl.TEXTURE_BINDING_2D);

Spécifications

Spécification Statut Commentaire
WebGL 1.0
La définition de 'bindTexture' dans cette spécification.
Recommendation

Définition initiale pour WebGL.

OpenGL ES 2.0
La définition de 'glBindTexture' dans cette spécification.
Standard

Page man de l’API OpenGL ES 2.0 (similaire).

WebGL 2.0
La définition de 'bindTexture' dans cette spécification.
Brouillon de l'éditeur Définition mise à jour pour WebGL 2.
Ajoute : gl.TEXTURE_3D et  gl.TEXTURE_2D_ARRAY
OpenGL ES 3.0
La définition de 'glBindTexture' dans cette spécification.
Standard Page man de l’API OpenGL ES 3.0 (similaire).

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple912411125.1
WebGL256 Non51 Non43 Non
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidIE mobileOpera AndroidiOS Safari
Support simple Oui25 Oui Oui11128.1
WebGL25858 Non51 Non43 Non

Voir aussi

Étiquettes et contributeurs liés au document

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