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

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

js
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().

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

Spécifications

Specification
WebGL Specification
# 5.14.11

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi