table of contents
GLCLEAR(3G) | GLCLEAR(3G) |
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