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
Spécification | Statut | Commentaire |
---|---|---|
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 man de l'API OpenGL. |
Compatibilité des navigateurs
BCD tables only load in the browser
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.