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

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari pour iOSSamsung Internet
Support simpleChrome Support complet 9Edge Support complet 12Firefox Support complet 4IE Support complet 11Opera Support complet 12Safari Support complet 5.1WebView Android Support complet OuiChrome Android Support complet 25Edge Mobile Support complet OuiFirefox Android Support complet OuiOpera Android Support complet 12Safari iOS Support complet 8.1Samsung Internet Android Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : NemoNobobyPersonne, SphinxKnight, Noctisdark
Dernière mise à jour par : NemoNobobyPersonne,