WebGLRenderingContext.bindTexture()

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

Syntaxe

js
void gl.bindTexture(cible, texture);

Paramètres

cible

Un GLenum (en-US) 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

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

js
gl.getParameter(gl.TEXTURE_BINDING_2D);

Spécifications

Specification
WebGL Specification
# 5.14.8
WebGL 2.0 Specification
# 3.7.1

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi