MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

WebGLRenderingContext.clear() est une méthode de l'API WebGL qui permet de charger une valeur pré-initialisée dans un tampon.

Ces valeurs pré-initialisées peuvent être configurées grâce aux méthodes clearColor(), clearDepth() ou clearStencil().

Le scissor box, dithering, ou buffer writemasks peuvent affecter le fonctionnement de la méthode clear().

Syntaxe

void gl.clear(mask);

Paramètres

mask
Un masque binaire OR GLbitfield qui indique les tampons à effacer. Les valeurs possibles sont :
  • gl.COLOR_BUFFER_BIT
  • gl.DEPTH_BUFFER_BIT
  • gl.STENCIL_BUFFER_BIT

Exceptions levées

Si mask n'est pas une des valeurs possible, une erreur gl.INVALID_ENUM sera levée.

Valeur de retour

Aucune.

Exemples

La méthode clear() peut prendre plusieurs valeurs en entrée.

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

Pour obtenir la valeur prédéfinie d'un masque donné, on peut obtenir les valeurs des 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 État Commentaires
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 de manuel pour l'API OpenGL.

Compatibilité des navigateurs

Fonctionnalité Chrome Edge Firefox Internet Explorer Opera Safari Servo
Support simple9124.011125.1Aucun support
Fonctionnalité Android Chrome for Android Edge Mobile Firefox for Android IE Mobile Opera Mobile Safari Mobile
Support simple(Oui)25(Oui)4.011128.1

Voir aussi

Étiquettes et contributeurs liés au document

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