La méthode WebGLRenderingContext.bindBuffer() de l'API WebGL lie un WebGLBuffer donné à une cible.

Syntaxe

void gl.bindBuffer(cible, tampon);

Paramètres

cible
Un GLenum spécifiant le point de liaison (cible). Valeurs possibles :
  • gl.ARRAY_BUFFER : tampon contenant des attributs de sommet, tels que des coordonnées de vertex, des données de coordonnées de texture ou des données de couleurs de sommet ;
  • gl.ELEMENT_ARRAY_BUFFER : tampon utilisé pour les indices d'éléments ;
  • Lors de l'utilisation d'un WebGL context 2, les valeurs suivantes sont disponibles en plus :
    • gl.COPY_READ_BUFFER : tampon pour la copie d'un objet tampon à un autre ;
    • gl.COPY_WRITE_BUFFER : tampon pour la copie d'un objet tampon à un autre ;
    • gl.TRANSFORM_FEEDBACK_BUFFER : tampon pour les opérations de retour de la transformation ;
    • gl.UNIFORM_BUFFER : tampon utilisé pour stocker des blocs uniformes ;
    • gl.PIXEL_PACK_BUFFER : tampon utilisé pour les opérations de transfert de pixels ;
    • gl.PIXEL_UNPACK_BUFFER : tampon utilisé pour les opérations de transfert de pixels.
tampon
Un WebGLBuffer à lier.

Valeur retournée

Aucune.

Exceptions

Une seule cible peut être liée à un WebGLBuffer donné. Une tentative de lier le tampon à une autre cible déclenchera une erreur INVALID_OPERATION et la liaison du tampon en cours restera la même.

Exemples

Liaison d'un tampon à une cible

var canevas = document.getElementById('canevas');
var gl = canevas.getContext('webgl');
var tampon = gl.createBuffer();

gl.bindBuffer(gl.ARRAY_BUFFER, tampon);

Récupération des liaisons en cours

Pour vérifier les liaisons de tampon en cours, interrogez les constantes ARRAY_BUFFER_BINDING et ELEMENT_ARRAY_BUFFER_BINDING.

gl.getParameter(gl.ARRAY_BUFFER_BINDING);
gl.getParameter(gl.ELEMENT_ARRAY_BUFFER_BINDING);

Spécifications

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

Définition initiale pour WebGL.

OpenGL ES 2.0
La définition de 'glBindBuffer' dans cette spécification.
Standard Page man de l’API OpenGL ES 2 (similaire).
WebGL 2.0
La définition de 'bindBuffer' dans cette spécification.
Brouillon de l'éditeur

Définition mise à jour pour WebGL 2.

Ajoute de nouveaux tampons cible :
gl.COPY_READ_BUFFER,
gl.COPY_WRITE_BUFFER,
gl.TRANSFORM_FEEDBACK_BUFFER,
gl.UNIFORM_BUFFER,
gl.PIXEL_PACK_BUFFER,
gl.PIXEL_UNPACK_BUFFER

OpenGL ES 3.0
La définition de 'glBindBuffer' dans cette spécification.
Standard Page man de l’API OpenGL ES 3 (similaire).

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
WebGL2Chrome Support complet 56Edge Aucun support NonFirefox Support complet 51IE Aucun support NonOpera Support complet 43Safari Aucun support NonWebView Android Support complet 58Chrome Android Support complet 58Edge Mobile Aucun support NonFirefox Android Support complet 51Opera Android Support complet 43Safari iOS Aucun support NonSamsung Internet Android Support complet 7.0

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Voir aussi

Étiquettes et contributeurs liés au document

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