glClear.3x

Langue: fr

Autres versions - même langue

Version: 109787 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NOM

glClear - efface des buffers à une valeur prédéfinie

SPÉCIFICATION C

void glClear( GLbitfield masque )

PARAMÈTRES

masque
Combinaison OU de bits indiquant le(s) buffer(s) à effacer. Les quatre masques sont GL_COULEUR_BUFFER_BIT, GL_DEPTH_BUFFER_BIT, GL_ACCUM_BUFFER_BIT, et GL_STENCIL_BUFFER_BIT.

DESCRIPTION

glClear met la/les zone(s) définie(s) de la fenêtre aux valeurs précédemment sélectionnées par glClearColor, glClearIndex, glClearDepth, glClearStencil, et glClearAccum. Plusieurs buffers de couleur peuvent être effacés simultanément en sélectionnant plus d'un buffer à la fois en utilisant glDrawBuffer.

Le test du pixel possédant, le test de découpage (scissor), le dithering, et les masques d'écritures des buffers affectent le fonctionnement de glClear. La zone de découpage (scissor) limite la région effacée. Les fonctions Alpha, de mélange (blending), de logique, sur le buffer stencil, de texture mapping, et le buffer de profondeur sont ignorés par glClear.

glClear prend un unique argument qui est la combinaison OU de plusieurs valeurs indiquant quel(s) buffer(s) sont à effacer.

Les valeurs suivantes sont acceptées :

GL_COULEUR_BUFFER_BIT
Indique le(s) buffer(s) de couleur activé(s) en ce moment en écriture.
GL_DEPTH_BUFFER_BIT
Indique le buffer de profondeur.
GL_ACCUM_BUFFER_BIT
Indique le buffer d'accumulation.
GL_STENCIL_BUFFER_BIT
Indique le buffer stencil.

La valeur à laquelle chaque buffer est effacé dépend de sa valeur d'effacement.

NOTES

Si un buffer n'est pas présent, alors un glClear dirigé à ce buffer n'a pas d'effet.

ERREURS

GL_INVALID_VALUE est généré si n'importe quel bit autre que les quatre définis précédemment est dans le masque.

GL_INVALID_OPERATION est généré si glClear est exécuté entre l'exécution de glBegin et l'exécution correspondante de glEnd.

GETS ASSOCIÉS

glGet avec l'argument GL_ACCUM_CLEAR_VALUE
glGet avec l'argument GL_DEPTH_CLEAR_VALUE
glGet avec l'argument GL_INDEX_CLEAR_VALUE
glGet avec l'argument GL_COULEUR_CLEAR_VALUE
glGet avec l'argument GL_STENCIL_CLEAR_VALUE

VOIR AUSSI

glClearAccum(3G), glClearColor(3G), glClearDepth(3G), glClearIndex(3G), glClearStencil(3G), glColorMask(3G), glDepthMask(3G), glDrawBuffer(3G), glScissor(3G), glStencilMask(3G)

TRADUCTION

Sylvain Vignaud <sylvain@vignaud.org>, 2002