WebGLRenderingContext.clear()

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

Compatibilité des navigateurs

Les données de compatibilité de ce tableau ont été générées à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une pull request sur https://github.com/mdn/browser-compat-data.

Voir aussi

• WebGLRenderingContext.clearColor()
• WebGLRenderingContext.clearDepth()
• WebGLRenderingContext.clearStencil()