glClear, fonction

La fonction glClear efface les mémoires tampons en valeurs prédéfinies.

Syntaxe

void WINAPI glClear(
   GLbitfield mask
);

Paramètres

mask

Opérateurs OR au niveau du bit des masques qui indiquent les tampons à effacer. Les quatre masques sont les suivants.

Valeur	Signification
GL_COLOR_BUFFER_BIT	Mémoires tampons actuellement activées pour l’écriture de couleurs.
GL_DEPTH_BUFFER_BIT	Mémoire tampon de profondeur.
GL_ACCUM_BUFFER_BIT	Mémoire tampon d’accumulation.
GL_STENCIL_BUFFER_BIT	Mémoire tampon de gabarit.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom	Signification
GL_INVALID_VALUE	Tout bit autre que les quatre bits définis a été défini dans le masque.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glClear définit la zone du plan de bits de la fenêtre sur les valeurs précédemment sélectionnées par glClearColor, glClearIndex, glClearDepth, glClearStencil et glClearAccum. Vous pouvez effacer plusieurs tampons de couleurs simultanément en sélectionnant plusieurs tampons à la fois à l’aide de glDrawBuffer.

Le test de propriété des pixels, le test de ciseaux, le tramage et les masques d’écriture de mémoire tampon affectent le fonctionnement de glClear. La zone ciseaux limite la zone effacée. La fonction glClear ignore la fonction alpha, la fonction blend, l’opération logique, la sténonciation, le mappage de textures et la mise en mémoire tampon z.

La fonction glClear prend un seul argument (masque) qui est le OR au niveau du bit de plusieurs valeurs indiquant la mémoire tampon à effacer.

La valeur à laquelle chaque mémoire tampon est effacée dépend du paramètre de la valeur clear pour cette mémoire tampon.

Si aucune mémoire tampon n’est présente, un appel glClear dirigé vers cette mémoire tampon n’a aucun effet.

Les fonctions suivantes récupèrent des informations relatives à glClear :

glGet avec argument GL_ACCUM_CLEAR_VALUE

glGet avec argument GL_DEPTH_CLEAR_VALUE

glGet avec GL_INDEX_CLEAR_VALUE d’arguments

glGet avec argument GL_COLOR_CLEAR_VALUE

glGet avec argument GL_STENCIL_CLEAR_VALUE

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glClearAccum

glClearColor

glClearDepth

glClearIndex

glClearStencil

glDrawBuffer

glGet

glScissor