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