Cette page a été traduite à partir de l'anglais par la communauté. Vous pouvez également contribuer en rejoignant la communauté francophone sur MDN Web Docs.

WebGLRenderingContext.clear()

La méthode WebGLRenderingContext.clear() de l'API WebGL efface les tampons avec des valeurs prédéfinies.

Ces valeurs prédéfinies peuvent être affectées par clearColor() (en-US), clearDepth() (en-US) ou clearStencil() (en-US).

Les masques d'écriture, de détourage, de tramage et de tampon peuvent affecter la méthode clear().

Syntaxe

void gl.clear(masque);

Paramètres

masque

Un masque OU par bits GLbitfield (en-US) qui indique les tampons à effacer. Les valeurs possibles sont :

  • gl.COLOR_BUFFER_BIT
  • gl.DEPTH_BUFFER_BIT
  • gl.STENCIL_BUFFER_BIT

Valeur retournée

Aucune.

Exceptions

Si masque n'est pas l'une des valeurs possibles listées, une erreur gl.INVALID_ENUM est déclenchée.

Exemples

La méthode clear() accepte des valeurs multiples.

gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);

Pour obtenir les valeurs d'effacement courantes, interrogez les constantes COLOR_CLEAR_VALUE, DEPTH_CLEAR_VALUE et STENCIL_CLEAR_VALUE grâce à la méthode getParameter().

gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);

Spécifications

Spécification Statut Commentaire
WebGL 1.0
La définition de 'clear' dans cette spécification.		 Recommendation Définition initiale.
OpenGL ES 2.0
La définition de 'glClear' dans cette spécification.		 Standard Page man de l'API OpenGL.

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi