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