WebGL2RenderingContext
======================

**Expérimental:** **Cette fonction est expérimentale**  
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.  
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

L'interface **WebGL2RenderingContext** fournit le contexte de rendu OpenGL ES 3.0 pour la surface de dessin d'un élément HTML `<canvas>`.

Pour obtenir un objet de cette interface, appelez `getContext()` sur un élément `<canvas>`, en fournissant "webgl2" comme argument :


```js
var canevas = document.getElementById("monCanevas");
var gl = canevas.getContext("webgl2");
```


**Note :** WebGL 2 est une extension de WebGL 1. L'interface `WebGL2RenderingContext` implémente tous les membres de l'interface `WebGLRenderingContext`. Certaines méthodes du contexte WebGL 1 peuvent accepter des valeurs supplémentaires lorsqu'elles sont utilisées dans un contexte WebGL 2. Vous trouverez cette information sur les pages de référence WebGL 1.

Le didacticiel WebGL contient plus d'informations, d'exemples et de ressources sur la façon de démarrer avec WebGL.

Constantes
----------

Voir la page des constantes WebGL (en-US).

Informations d'état
-------------------

`WebGL2RenderingContext.getIndexedParameter()` (en-US)

Retourne la valeur indexée pour la `cible` donnée.

Tampons
-------

`WebGL2RenderingContext.bufferData()`

Initialise et crée le magasin de données de l'objet tampon.

`WebGL2RenderingContext.bufferSubData()`

Met à jour un sous-ensemble d'un magasin de données d'un objet tampon.

`WebGL2RenderingContext.copyBufferSubData()` (en-US)

Copie une partie des données d'un tampon vers un autre tampon.

`WebGL2RenderingContext.getBufferSubData()` (en-US)

Lit les données d'un tampon et les écrit dans un `ArrayBuffer` ou un `SharedArrayBuffer`.

Tampons d'image
---------------

`WebGL2RenderingContext.blitFramebuffer()` (en-US)

Transfère un bloc de pixels du tampon d'image lu vers le tampon d'image de dessin.

`WebGL2RenderingContext.framebufferTextureLayer()` (en-US)

Attache une seule couche de texture à un tampon d'image.

`WebGL2RenderingContext.invalidateFramebuffer()` (en-US)

Invalide le contenu des éléments joints dans un tampon d'image.

`WebGL2RenderingContext.invalidateSubFramebuffer()` (en-US)

Invalide le contenu des éléments joints dans un tampon d'image.

`WebGL2RenderingContext.readBuffer()` (en-US)

Sélectionne un tampon de couleur comme source pour les pixels.

Tampons de rendu
----------------

`WebGL2RenderingContext.getInternalformatParameter()` (en-US)

Retourne des informations sur le support, dépendant de l'implémentation, des formats internes.

`WebGL2RenderingContext.renderbufferStorageMultisample()` (en-US)

Crée et initialise le magasin de données d'un objet tampon de rendu et permet de d'indiquer le nombre d'échantillons à utiliser.

Textures
--------

`WebGL2RenderingContext.texStorage2D()` (en-US)

Spécifie tous les niveaux d'un stockage de texture bidimensionnelle.

`WebGL2RenderingContext.texStorage3D()` (en-US)

Spécifie tous les niveaux d'une texture tridimensionnelle ou d'une texture de tableau bidimensionnelle.

`WebGL2RenderingContext.texImage3D()` (en-US)

Spécifie une image de texture tridimensionnelle.

`WebGL2RenderingContext.texSubImage3D()` (en-US)

Spécifie un sous-rectangle de la texture 3D en cours.

`WebGL2RenderingContext.copyTexSubImage3D()` (en-US)

Copie des pixels du tampon WebGLFrame en cours dans une sous-image de texture 3D existante.

`WebGL2RenderingContext.compressedTexImage3D()` (en-US)

Spécifie une image de texture tridimensionnelle dans un format compressé.

`WebGL2RenderingContext.compressedTexSubImage3D()` (en-US)

Spécifie un sous-rectangle tridimensionnel pour une image de texture dans un format compressé.

Programmes et shaders
---------------------

`WebGL2RenderingContext.getFragDataLocation()` (en-US)

Retourne la liaison des numéros de couleur aux variables de sortie varying définies par l'utilisateur.

Uniforms et attributs
---------------------

`WebGL2RenderingContext.uniform[1234][uif][v]()` (en-US)

Méthodes spécifiant les valeurs des variables uniform.

`WebGL2RenderingContext.uniformMatrix[234]x[234]fv()` (en-US)

Méthodes spécifiant les valeurs matricielles pour les variables uniform.

`WebGL2RenderingContext.vertexAttribI4[u]i[v]()` (en-US)

Méthodes spécifiant les valeurs entières des attributs de sommet génériques.

`WebGL2RenderingContext.vertexAttribIPointer()` (en-US)

Spécifie les formats et les emplacements des données entières des attributs de sommet dans un tableau d'attributs de sommet.

Tampons de dessin
-----------------

`WebGL2RenderingContext.vertexAttribDivisor()` (en-US)

Modifie la vitesse à laquelle les attributs de sommet génériques progressent lors du rendu de plusieurs instances de primitives avec `gl.drawArraysInstanced()` (en-US) et `gl.drawElementsInstanced()` (en-US).

`WebGL2RenderingContext.drawArraysInstanced()` (en-US)

Affiche des primitives à partir des données d'un tableau. En outre, elle peut exécuter plusieurs instances de la plage d'éléments.

`WebGL2RenderingContext.drawElementsInstanced()` (en-US)

Affiche des primitives à partir des données d'un tableau. En outre, elle peut exécuter plusieurs instances d'un ensemble d'éléments.

`WebGL2RenderingContext.drawRangeElements()` (en-US)

Affiche des primitives à partir des données d'un tableau dans la plage donnée.

`WebGL2RenderingContext.drawBuffers()` (en-US)

Spécifie une liste de tampons de couleur dans lesquels dessiner.

`WebGL2RenderingContext.clearBuffer[fiuv]()` (en-US)

Efface les tampons du tampon d'image actuellement lié.

Objets requêtes
---------------

Méthodes pour travailler avec les objets `WebGLQuery` (en-US).

`WebGL2RenderingContext.createQuery()` (en-US)

Crée un nouvel objet `WebGLQuery` (en-US).

`WebGL2RenderingContext.deleteQuery()` (en-US)

Supprime l'objet `WebGLQuery` (en-US) donné.

`WebGL2RenderingContext.isQuery()` (en-US)

Retourne `true` si l'objet donné est un objet `WebGLQuery` (en-US) valide.

`WebGL2RenderingContext.beginQuery()` (en-US)

Commence une requête asynchrone.

`WebGL2RenderingContext.endQuery()` (en-US)

Marque la fin d'une requête asynchrone.

`WebGL2RenderingContext.getQuery()` (en-US)

Retourne un objet `WebGLQuery` (en-US) pour la cible donnée.

`WebGL2RenderingContext.getQueryParameter()` (en-US)

Retourne des informations sur une requête.

Objets échantilloneurs
----------------------

`WebGL2RenderingContext.createSampler()` (en-US)

Crée un nouvel objet `WebGLSampler` (en-US).

`WebGL2RenderingContext.deleteSampler()` (en-US)

Supprime l'objet `WebGLSampler` (en-US) donné.

`WebGL2RenderingContext.bindSampler()` (en-US)

Lie le `WebGLSampler` (en-US) donné à une unité de texture.

`WebGL2RenderingContext.isSampler()` (en-US)

Retourne `true` si l'objet donné est un objet `WebGLSampler` (en-US) valide.

`WebGL2RenderingContext.samplerParameter[if]()` (en-US)

Définit les paramètres de l'échantillonneur.

`WebGL2RenderingContext.getSamplerParameter()` (en-US)

Retourne les informations de paramètres de l'échantillonneur.

Objets sync
-----------

`WebGL2RenderingContext.fenceSync()` (en-US)

Crée un nouvel objet `WebGLSync` (en-US) et l'insère dans le flux de commandes GL.

`WebGL2RenderingContext.isSync()` (en-US)

Retourne `true` si l'objet transmis est un objet `WebGLSync` (en-US) valide.

`WebGL2RenderingContext.deleteSync()` (en-US)

Supprime l'objet `WebGLSync` (en-US) donné.

`WebGL2RenderingContext.clientWaitSync()` (en-US)

Bloque et attend qu'un objet `WebGLSync` (en-US) reçoive un signal ou que l'expiration du délai donné soit reçue.

`WebGL2RenderingContext.waitSync()` (en-US)

Retourne immédiatement, mais attend le serveur GL jusqu'à ce que l'objet `WebGLSync` (en-US) donné reçoive un signal.

`WebGL2RenderingContext.getSyncParameter()` (en-US)

Retourne les informations de paramètres d'un objet `WebGLSync` (en-US).

Retour de transformations
-------------------------

`WebGL2RenderingContext.createTransformFeedback()` (en-US)

Crée et initialise les objets `WebGLTransformFeedback` (en-US).

`WebGL2RenderingContext.deleteTransformFeedback()` (en-US)

Supprime l'objet `WebGLTransformFeedback` (en-US) donné.

`WebGL2RenderingContext.isTransformFeedback()` (en-US)

Retourne `true` si l'objet transmis est un objet `WebGLTransformFeedback` (en-US) valide.

`WebGL2RenderingContext.bindTransformFeedback()` (en-US)

Lie l'objet `WebGLTransformFeedback` (en-US) transmis à l'état GL en cours.

`WebGL2RenderingContext.beginTransformFeedback()` (en-US)

Démarre une opération de retour de transformations.

`WebGL2RenderingContext.endTransformFeedback()` (en-US)

Termine une opération de retour de transformations.

`WebGL2RenderingContext.transformFeedbackVaryings()` (en-US)

Indique les valeurs à enregistrer dans les tampons `WebGLTransformFeedback` (en-US).

`WebGL2RenderingContext.getTransformFeedbackVarying()` (en-US)

Retourne des informations sur les variables varying à partir des tampons `WebGLTransformFeedback` (en-US).

`WebGL2RenderingContext.pauseTransformFeedback()` (en-US)

Suspend une opération de retour de transformations.

`WebGL2RenderingContext.resumeTransformFeedback()` (en-US)

Reprend une opération de retour de transformations.

Objets tampons uniforms
-----------------------

`WebGL2RenderingContext.bindBufferBase()` (en-US)

Lie le `WebGLBuffer` donné au point de liaison donné (`cible`) à l'`indice` donné.

`WebGL2RenderingContext.bindBufferRange()` (en-US)

Lie une plage du `WebGLBuffer` donné au point de liaison donné (`cible`) à l'`indice` donné.

`WebGL2RenderingContext.getUniformIndices()` (en-US)

Récupère les indices d'un certain nombre d'uniforms dans un `WebGLProgram`.

`WebGL2RenderingContext.getActiveUniforms()` (en-US)

Récupère des informations sur les uniforms actifs dans un `WebGLProgram`.

`WebGL2RenderingContext.getUniformBlockIndex()` (en-US)

Récupère l'indice d'un bloc uniform dans un `WebGLProgram`.

`WebGL2RenderingContext.getActiveUniformBlockParameter()` (en-US)

Récupère des informations d'un bloc uniform actif dans un `WebGLProgram`.

`WebGL2RenderingContext.getActiveUniformBlockName()` (en-US)

Récupère le nom du bloc uniform actif à l'indice donné dans un `WebGLProgram`.

`WebGL2RenderingContext.uniformBlockBinding()` (en-US)

Affecte des points de liaison aux blocs uniforms actifs.

Objets de tableaux de sommets
-----------------------------

Méthodes pour travailler avec les objets `WebGLVertexArrayObject` (en-US) (VAO).

`WebGL2RenderingContext.createVertexArray()` (en-US)

Crée un nouveau `WebGLVertexArrayObject` (en-US).

`WebGL2RenderingContext.deleteVertexArray()` (en-US)

Supprime le `WebGLVertexArrayObject` (en-US) donné.

`WebGL2RenderingContext.isVertexArray()` (en-US)

Retourne `true` si l'objet donné est un `WebGLVertexArrayObject` (en-US) valide.

`WebGL2RenderingContext.bindVertexArray()` (en-US)

Lie le `WebGLVertexArrayObject` (en-US) donné au tampon.

Spécifications
--------------

| Specification |
| --- |
| WebGL 2.0 Specification # 3.7 |

Compatibilité des navigateurs
-----------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Voir aussi
----------

* `HTMLCanvasElement`
* `WebGLRenderingContext`