WebGL2RenderingContext
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
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 :
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.
Informations d'état
WebGL2RenderingContext.getIndexedParameter()
-
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()
-
Copie une partie des données d'un tampon vers un autre tampon.
WebGL2RenderingContext.getBufferSubData()
-
Lit les données d'un tampon et les écrit dans un
ArrayBuffer
ou unSharedArrayBuffer
.
Tampons d'image
WebGL2RenderingContext.blitFramebuffer()
-
Transfère un bloc de pixels du tampon d'image lu vers le tampon d'image de dessin.
WebGL2RenderingContext.framebufferTextureLayer()
-
Attache une seule couche de texture à un tampon d'image.
WebGL2RenderingContext.invalidateFramebuffer()
-
Invalide le contenu des éléments joints dans un tampon d'image.
WebGL2RenderingContext.invalidateSubFramebuffer()
-
Invalide le contenu des éléments joints dans un tampon d'image.
WebGL2RenderingContext.readBuffer()
-
Sélectionne un tampon de couleur comme source pour les pixels.
Tampons de rendu
WebGL2RenderingContext.getInternalformatParameter()
-
Retourne des informations sur le support, dépendant de l'implémentation, des formats internes.
WebGL2RenderingContext.renderbufferStorageMultisample()
-
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()
-
Spécifie tous les niveaux d'un stockage de texture bidimensionnelle.
WebGL2RenderingContext.texStorage3D()
-
Spécifie tous les niveaux d'une texture tridimensionnelle ou d'une texture de tableau bidimensionnelle.
WebGL2RenderingContext.texImage3D()
-
Spécifie une image de texture tridimensionnelle.
WebGL2RenderingContext.texSubImage3D()
-
Spécifie un sous-rectangle de la texture 3D en cours.
WebGL2RenderingContext.copyTexSubImage3D()
-
Copie des pixels du tampon WebGLFrame en cours dans une sous-image de texture 3D existante.
WebGL2RenderingContext.compressedTexImage3D()
-
Spécifie une image de texture tridimensionnelle dans un format compressé.
WebGL2RenderingContext.compressedTexSubImage3D()
-
Spécifie un sous-rectangle tridimensionnel pour une image de texture dans un format compressé.
Programmes et shaders
WebGL2RenderingContext.getFragDataLocation()
-
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]()
-
Méthodes spécifiant les valeurs des variables uniform.
WebGL2RenderingContext.uniformMatrix[234]x[234]fv()
-
Méthodes spécifiant les valeurs matricielles pour les variables uniform.
WebGL2RenderingContext.vertexAttribI4[u]i[v]()
-
Méthodes spécifiant les valeurs entières des attributs de sommet génériques.
WebGL2RenderingContext.vertexAttribIPointer()
-
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()
-
Modifie la vitesse à laquelle les attributs de sommet génériques progressent lors du rendu de plusieurs instances de primitives avec
gl.drawArraysInstanced()
etgl.drawElementsInstanced()
. WebGL2RenderingContext.drawArraysInstanced()
-
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()
-
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()
-
Affiche des primitives à partir des données d'un tableau dans la plage donnée.
WebGL2RenderingContext.drawBuffers()
-
Spécifie une liste de tampons de couleur dans lesquels dessiner.
WebGL2RenderingContext.clearBuffer[fiuv]()
-
Efface les tampons du tampon d'image actuellement lié.
Objets requêtes
Méthodes pour travailler avec les objets WebGLQuery
.
WebGL2RenderingContext.createQuery()
-
Crée un nouvel objet
WebGLQuery
. WebGL2RenderingContext.deleteQuery()
-
Supprime l'objet
WebGLQuery
donné. WebGL2RenderingContext.isQuery()
-
Retourne
true
si l'objet donné est un objetWebGLQuery
valide. WebGL2RenderingContext.beginQuery()
-
Commence une requête asynchrone.
WebGL2RenderingContext.endQuery()
-
Marque la fin d'une requête asynchrone.
WebGL2RenderingContext.getQuery()
-
Retourne un objet
WebGLQuery
pour la cible donnée. WebGL2RenderingContext.getQueryParameter()
-
Retourne des informations sur une requête.
Objets échantilloneurs
WebGL2RenderingContext.createSampler()
-
Crée un nouvel objet
WebGLSampler
. WebGL2RenderingContext.deleteSampler()
-
Supprime l'objet
WebGLSampler
donné. WebGL2RenderingContext.bindSampler()
-
Lie le
WebGLSampler
donné à une unité de texture. WebGL2RenderingContext.isSampler()
-
Retourne
true
si l'objet donné est un objetWebGLSampler
valide. WebGL2RenderingContext.samplerParameter[if]()
-
Définit les paramètres de l'échantillonneur.
WebGL2RenderingContext.getSamplerParameter()
-
Retourne les informations de paramètres de l'échantillonneur.
Objets sync
WebGL2RenderingContext.fenceSync()
-
Crée un nouvel objet
WebGLSync
et l'insère dans le flux de commandes GL. WebGL2RenderingContext.isSync()
-
Retourne
true
si l'objet transmis est un objetWebGLSync
valide. WebGL2RenderingContext.deleteSync()
-
Supprime l'objet
WebGLSync
donné. WebGL2RenderingContext.clientWaitSync()
-
Bloque et attend qu'un objet
WebGLSync
reçoive un signal ou que l'expiration du délai donné soit reçue. WebGL2RenderingContext.waitSync()
-
Retourne immédiatement, mais attend le serveur GL jusqu'à ce que l'objet
WebGLSync
donné reçoive un signal. WebGL2RenderingContext.getSyncParameter()
-
Retourne les informations de paramètres d'un objet
WebGLSync
.
Retour de transformations
WebGL2RenderingContext.createTransformFeedback()
-
Crée et initialise les objets
WebGLTransformFeedback
. WebGL2RenderingContext.deleteTransformFeedback()
-
Supprime l'objet
WebGLTransformFeedback
donné. WebGL2RenderingContext.isTransformFeedback()
-
Retourne
true
si l'objet transmis est un objetWebGLTransformFeedback
valide. WebGL2RenderingContext.bindTransformFeedback()
-
Lie l'objet
WebGLTransformFeedback
transmis à l'état GL en cours. WebGL2RenderingContext.beginTransformFeedback()
-
Démarre une opération de retour de transformations.
WebGL2RenderingContext.endTransformFeedback()
-
Termine une opération de retour de transformations.
WebGL2RenderingContext.transformFeedbackVaryings()
-
Indique les valeurs à enregistrer dans les tampons
WebGLTransformFeedback
. WebGL2RenderingContext.getTransformFeedbackVarying()
-
Retourne des informations sur les variables varying à partir des tampons
WebGLTransformFeedback
. WebGL2RenderingContext.pauseTransformFeedback()
-
Suspend une opération de retour de transformations.
WebGL2RenderingContext.resumeTransformFeedback()
-
Reprend une opération de retour de transformations.
Objets tampons uniforms
WebGL2RenderingContext.bindBufferBase()
-
Lie le
WebGLBuffer
donné au point de liaison donné (cible
) à l'indice
donné. WebGL2RenderingContext.bindBufferRange()
-
Lie une plage du
WebGLBuffer
donné au point de liaison donné (cible
) à l'indice
donné. WebGL2RenderingContext.getUniformIndices()
-
Récupère les indices d'un certain nombre d'uniforms dans un
WebGLProgram
. WebGL2RenderingContext.getActiveUniforms()
-
Récupère des informations sur les uniforms actifs dans un
WebGLProgram
. WebGL2RenderingContext.getUniformBlockIndex()
-
Récupère l'indice d'un bloc uniform dans un
WebGLProgram
. WebGL2RenderingContext.getActiveUniformBlockParameter()
-
Récupère des informations d'un bloc uniform actif dans un
WebGLProgram
. WebGL2RenderingContext.getActiveUniformBlockName()
-
Récupère le nom du bloc uniform actif à l'indice donné dans un
WebGLProgram
. WebGL2RenderingContext.uniformBlockBinding()
-
Affecte des points de liaison aux blocs uniforms actifs.
Objets de tableaux de sommets
Méthodes pour travailler avec les objets WebGLVertexArrayObject
(VAO).
WebGL2RenderingContext.createVertexArray()
-
Crée un nouveau
WebGLVertexArrayObject
. WebGL2RenderingContext.deleteVertexArray()
-
Supprime le
WebGLVertexArrayObject
donné. WebGL2RenderingContext.isVertexArray()
-
Retourne
true
si l'objet donné est unWebGLVertexArrayObject
valide. WebGL2RenderingContext.bindVertexArray()
-
Lie le
WebGLVertexArrayObject
donné au tampon.
Spécifications
Specification |
---|
WebGL 2.0 Specification # 3.7 |
Compatibilité des navigateurs
BCD tables only load in the browser