fonction glAlphaFunc

La fonction glAlphaFunc permet à votre application de définir la fonction de test alpha.

Syntaxe

void WINAPI glAlphaFunc(
   GLenum   func,
   GLclampf ref
);

Paramètres

func

Fonction de comparaison alpha. Voici les constantes symboliques acceptées et leur signification.

Valeur	Signification
GL_NEVER	Ne passe jamais.
GL_LESS	Réussit si la valeur alpha entrante est inférieure à la valeur de référence.
GL_EQUAL	Passe si la valeur alpha entrante est égale à la valeur de référence.
GL_LEQUAL	Passe si la valeur alpha entrante est inférieure ou égale à la valeur de référence.
GL_GREATER	Réussit si la valeur alpha entrante est supérieure à la valeur de référence.
GL_NOTEQUAL	Passe si la valeur alpha entrante n’est pas égale à la valeur de référence.
GL_GEQUAL	Passe si la valeur alpha entrante est supérieure ou égale à la valeur de référence.
GL_ALWAYS	Passe toujours. Il s’agit de la valeur par défaut.

ref

Valeur de référence à laquelle les valeurs alpha entrantes sont comparées. Cette valeur est limitée à la plage de 0 à 1, où 0 représente la valeur alpha la plus faible possible et 1 la valeur la plus élevée possible. La référence par défaut est 0.

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
GL_INVALID_ENUM	func n’était pas une valeur acceptée.
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

Le test alpha ignore les fragments en fonction du résultat d’une comparaison entre les valeurs alpha des fragments entrants et une valeur de référence constante. La fonction glAlphaFunc spécifie la fonction de référence et de comparaison. La comparaison est effectuée uniquement si le test alpha est activé. (Pour plus d’informations sur GL_ALPHA_TEST, consultez glEnable.)

Les paramètres func et ref spécifient les conditions dans lesquelles le pixel est dessiné. La valeur alpha entrante est comparée à ref à l’aide de la fonction spécifiée par func. Si la comparaison réussit, le fragment entrant est dessiné, conditionnel aux tests de gabarit et de mémoire tampon de profondeur suivants. Si la comparaison échoue, aucune modification n’est apportée au framebuffer à cet emplacement de pixel.

La fonction glAlphaFunc fonctionne sur toutes les écritures de pixels, y compris celles résultant de la conversion de points, de lignes, de polygones et de bitmaps, ainsi que des opérations de dessin et de copie de pixels. La fonction glAlphaFunc n’affecte pas les opérations de suppression d’écran.

Le test alpha est effectué uniquement en mode RVBA.

Les fonctions suivantes récupèrent des informations relatives à la fonction glAlphaFunc :

glGet avec argument GL_ALPHA_TEST_FUNC

glGet avec argument GL_ALPHA_TEST_REF

glIsEnabled avec argument GL_ALPHA_TEST

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	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc