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
GL_INVALID_ENUM	func no era un valor aceptado.
GL_INVALID_OPERATION	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	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc