Nom

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

SpÉcification c

void f3glClear( GLbitfield masque ) .nf .fi

ParamÈtres

f2masque Combinaison OU de bits indiquant le(s) buffer(s) à effacer. Les quatre masques sont %f3GL_COULEUR_BUFFER_BIT, %f3GL_DEPTH_BUFFER_BIT, %f3GL_ACCUM_BUFFER_BIT, et %f3GL_STENCIL_BUFFER_BIT.

Description

%f3glClear met la/les zone(s) définie(s) de la fenêtre aux valeurs précédemment sélectionnées par %f3glClearColor, %f3glClearIndex, %f3glClearDepth, %f3glClearStencil, et %f3glClearAccum. Plusieurs buffers de couleur peuvent être effacés simultanément en sélectionnant plus d'un buffer à la fois en utilisant %f3glDrawBuffer.

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 %f3glClear. 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 %f3glClear.

%f3glClear 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 :

%f3GL_COULEUR_BUFFER_BIT Indique le(s) buffer(s) de couleur activé(s) en ce moment en écriture.

%f3GL_DEPTH_BUFFER_BIT Indique le buffer de profondeur.

%f3GL_ACCUM_BUFFER_BIT Indique le buffer d'accumulation.

%f3GL_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 %f3glClear dirigé à ce buffer n'a pas d'effet.

Erreurs

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

%f3GL_INVALID_OPERATION est généré si %f3glClear est exécuté entre l'exécution de %f3glBegin et l'exécution correspondante de %f3glEnd.

Gets associÉs

%f3glGet avec l'argument %f3GL_ACCUM_CLEAR_VALUE %f3glGet avec l'argument %f3GL_DEPTH_CLEAR_VALUE %f3glGet avec l'argument %f3GL_INDEX_CLEAR_VALUE %f3glGet avec l'argument %f3GL_COULEUR_CLEAR_VALUE %f3glGet avec l'argument %f3GL_STENCIL_CLEAR_VALUE

Voir aussi

%f3glClearAccum(3G), %f3glClearColor(3G), %f3glClearDepth(3G), %f3glClearIndex(3G), %f3glClearStencil(3G), %f3glColorMask(3G), %f3glDepthMask(3G), %f3glDrawBuffer(3G), %f3glScissor(3G), %f3glStencilMask(3G)

Traduction

Sylvain Vignaud < sylvain@vignaud.org >, 2002