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(), clearDepth() ou clearStencil().

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 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

Compatibilité des navigateurs

Le tableau de compatibilité de cetee page a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, regardezhttps://github.com/mdn/browser-compat-data et envoyez-nous une pull request.

Voir aussi

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