función glAlphaFunc
La función glAlphaFunc permite a la aplicación establecer la función de prueba alfa.
Sintaxis
void WINAPI glAlphaFunc(
GLenum func,
GLclampf ref
);
Parámetros
-
func
-
Función de comparación alfa. A continuación se muestran las constantes simbólicas aceptadas y sus significados.
Valor Significado - GL_NEVER
Nunca pasa. - GL_LESS
Pasa si el valor alfa entrante es menor que el valor de referencia. - GL_EQUAL
Pasa si el valor alfa entrante es igual al valor de referencia. - GL_LEQUAL
Pasa si el valor alfa entrante es menor o igual que el valor de referencia. - GL_GREATER
Pasa si el valor alfa entrante es mayor que el valor de referencia. - GL_NOTEQUAL
Pasa si el valor alfa entrante no es igual al valor de referencia. - GL_GEQUAL
Pasa si el valor alfa entrante es mayor o igual que el valor de referencia. - GL_ALWAYS
Siempre pasa. Este es el valor predeterminado. -
ref
-
Valor de referencia al que se comparan los valores alfa entrantes. Este valor se sujeta al intervalo de 0 a 1, donde 0 representa el valor alfa más bajo posible y 1 el valor posible más alto. La referencia predeterminada es 0.
Valor devuelto
Esta función no devuelve ningún valor.
Códigos de error
La función glGetError puede recuperar los siguientes códigos de error.
| Nombre | Significado |
|---|---|
|
func no era un valor aceptado. |
|
Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd. |
Comentarios
La prueba alfa descarta fragmentos según el resultado de una comparación entre los valores alfa de los fragmentos entrantes y un valor de referencia constante. La función glAlphaFunc especifica la función de referencia y comparación. La comparación solo se realiza si las pruebas alfa están habilitadas. (Para obtener más información sobre GL_ALPHA_TEST, consulte glEnable).
Los parámetros func y ref especifican las condiciones en las que se dibuja el píxel. El valor alfa entrante se compara con ref mediante la función especificada por func. Si se supera la comparación, se dibuja el fragmento entrante, condicional en las pruebas posteriores de galería de símbolos y búfer de profundidad. Si se produce un error en la comparación, no se realiza ningún cambio en el búfer de fotogramas en esa ubicación de píxeles.
La función glAlphaFunc funciona en todas las escrituras de píxeles, incluidas las resultantes de la conversión de exámenes de puntos, líneas, polígonos y mapas de bits, y de las operaciones de dibujo y copia de píxeles. La función glAlphaFunc no afecta a las operaciones de borrado de pantalla.
Las pruebas alfa solo se realizan en modo RGBA.
Las funciones siguientes recuperan información relacionada con la función glAlphaFunc :
glGet con GL_ALPHA_TEST_FUNC de argumentos
glGet con GL_ALPHA_TEST_REF de argumentos
glIsEnabled con GL_ALPHA_TEST de argumentos
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|