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 |
|---|---|
|
Tout bit autre que les quatre bits définis a été défini dans le masque. |
|
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 |
|
| Bibliothèque |
|
| DLL |
|