Documentation de Gambas - /comp/gb.opengl/gl/alphafunc

/comp/gb.opengl/gl/alphafunc

# Gl.AlphaFunc (gb.opengl)

Static Sub AlphaFunc ( Function As Integer, Reference As Float )

Spécifie la fonction test alpha

### 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