Gl.AlphaFunc (gb.opengl)

Paramètres

func

Spécifie la fonction de comparaison alpha. Les constantes symboliques Gl.NEVER, Gl.LESS, Gl.EQUAL, Gl.LEQUAL, Gl.GREATER, Gl.NOTEQUAL, Gl.GEQUAL, and Gl.ALWAYS sont acceptées. La valeur initiale est Gl.ALWAYS.

ref

Spécifie la valeur de référence à laquelle les valeurs alpha entrantes sont comparées. Cette valeur est restreinte au domaine

0 1 , où 0 représente la plus petite valeur alpha possible et 1 la plus grande valeur possible. La référence par défaut est 0.

Description

Le test alpha rejette les fragments en fonction du résultat résultant de la comparaison entre la valeur alpha du fragment entrant et une valeur constante de référence. Gl.AlphaFunc spécifie la valeur de référence et la fonction de comparaison. La comparaison n’est effectuée que si le test alpha est activé. Par défaut, il n’est pas activé. (Voir Gl.Enable and Gl.Disable of Gl.ALPHA_TEST.)

func et ref spécifient les conditions sous lesquelles le pixel est tracé. La valeur entrante d’alpha est comparée à ref en utilisant la fonction spécifiée par func. Si la comparaison réussit, le fragment entrant est tracé s’il satisfait également aux tests de tampons subséquents "stencil" et "depth". Si la comparaison échoue, aucun changement n’est fait dans le tampon de trame à la position du pixel.

Les fonctions de comparaison sont :

Gl.NEVER

jamais accepté.

Gl.LESS

Accepté si la valeur entrante d’alpha est inférieure à la valeur de référence.

Gl.EQUAL

Accepté si la valeur entrante d’alpha est égale à la valeur de référence.

Gl.LEQUAL

Accepté si la valeur entrante d’alpha est inférieure ou égale à la valeur de référence.

Gl.GREATER

Accepté si la valeur entrante d’alpha est supérieure à la valeur de référence.

Gl.NOTEQUAL

Accepté si la valeur entrante d’alpha est différente de la valeur de référence.

Gl.GEQUAL

Accepté si la valeur entrante d’alpha est supérieure ou égale à la valeur de référence.

Gl.ALWAYS

toujours accepté(valeur initiale).

Gl.AlphaFunc opère sur toutes les opérations d’écriture de pixel, incluant celles qui résultent d’une conversion par balayage de points, lignes, polygones, et bitmaps, et des opérations de tracé de pixels et de copie. Gl.AlphaFunc n’affecte pas les opérations d’effacement d’écran.

Notes

Le test Alpha n’est fait qu’en mode RGBA.

Erreurs

Gl.GL_INVALID_ENUM est générée si func n’est pas une valeur acceptée. Gl.GL_INVALID_OPERATION est générée si Gl.AlphaFunc est appelée entre un appel à Gl.Begin et l’appel correspondant à Gl.End.

_ Gets Associés

Gl.Get avec l’ argument Gl.GL_ALPHA_TEST_FUNC

Gl.Get avec l’ argument Gl.GL_ALPHA_TEST_REF

Gl.IsEnabled avec l’ argument Gl.GL_ALPHA_TEST

Voir également

Gl.BlendFunc, Gl.Clear, Gl.DepthFunc, Gl.Enable, Gl.StencilFunc

---

Copyright © 1991-2006 Silicon Graphics, Inc. Ce document est sous licence SGI Free Software B License. Pour les details, voir http://oss.sgi.com/projects/FreeB.

➡ Voir la documentation originale