WebGLRenderingContext.bindTexture()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
bindTexture

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Voir aussi