Nom

glAlphaFunc - spécifie la fonction de test alpha

SpÉcification c

void f3glAlphaFunc( GLenum func, .nf .ta w'f3void glAlphaFunc( 'u GLclampf ref ) .fi

ParamÈtres

f2func Spécifie la fonction de comparaison alpha. Les constantes symboliques %f3GL_NEVER, %f3GL_LESS, %f3GL_EQUAL, %f3GL_LEQUAL, %f3GL_GREATER, %f3GL_NOTEQUAL, %f3GL_GEQUAL, et %f3GL_ALWAYS sont acceptées. La valeur initiale est %f3GL_ALWAYS.

f2ref Spécifie la valeur référence à laquelle les valeurs alpha arrivant sont comparées. Cette valeur est limitée à l'intervale [0, 1], où 0 représente la plus petite valeur alpha possible et 1 la plus grande valeur possible. La valeur initiale de référence est 0.

Description

Le test alpha rejette des fragments suivant le résultat de la comparaison entre la valeur alpha d'un fragment arrivant et une valeur constante. %f3glAlphaFunc spécifie la valeur référence et la fonction de comparaison. La comparaison est exécutée seulement si le test alpha est activé. Par défaut, il n'est pas activé. (Voir %f3glEnable et %f3glDisable avec %f3GL_ALPHA_TEST.)

f2func et f2ref spécifie les conditions sous lesquelles le pixel est affiché. La valeur alpha arrivant est comparée à f2ref en utilisant la fonction spécifiée par f2func. Si la valeur passe la comparaison, le fragment arrivant est affiché s'il passe également les tests activés des buffers de stencil et de profondeur. Si la valeur échoue à la comparaison, aucun changement n'est fait au buffer image à la position de ce pixel. Les fonctions de comparaison sont :

%f3GL_NEVER Ne passe jamais.

%f3GL_LESS Passe si la valeur alpha arrivant est plus petite que la valeur référence.

%f3GL_EQUAL Passe si la valeur alpha arrivant est égale à la valeur référence.

%f3GL_LEQUAL Passe si la valeur alpha arrivant est plus petite ou égale à la valeur référence.

%f3GL_GREATER Passe si la valeur alpha arrivant est plus grande que la valeur référence.

%f3GL_NOTEQUAL Passe si la valeur alpha arrivant n'est pas egale à la valeur référence.

%f3GL_GEQUAL Passe si la valeur alpha arrivant est plus grande ou égale à la valeur référence.

%f3GL_ALWAYS Passe toujours (valeur initial).

%f3glAlphaFunc agit sur toutes les opérations d'écriture de pixels, y compris celles résultant de l'affichage de points, de lignes, de polygones, d'images, et d'opérations d'affichage et de copie de pixel. %f3glAlphaFunc n'affecte pas les opérations d'effacement de l'écran.

Notes

Le test Alpha ne fonctionne qu'en mode RGBA.

Erreurs

%f3GL_INVALID_ENUM est générée si f2func n'est pas une valeur acceptée.

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

Gets associÉs

%f3glGet avec l'argument %f3GL_ALPHA_TEST_FUNC %f3glGet avec l'argument %f3GL_ALPHA_TEST_REF %f3glIsEnabled l'avec argument %f3GL_ALPHA_TEST

Voir aussi

%f3glBlendFunc(3G), %f3glClear(3G), %f3glDepthFunc(3G), %f3glEnable(3G), %f3glStencilFunc(3G)

Traduction

Sylvain Vignaud < sylvain@vignaud.org >, 2002