Função glAlphaFunc
A função glAlphaFunc permite que seu aplicativo defina a função de teste alfa.
Sintaxe
void WINAPI glAlphaFunc(
GLenum func,
GLclampf ref
);
Parâmetros
-
func
-
A função de comparação alfa. A seguir estão as constantes simbólicas aceitas e seus significados.
Valor Significado - GL_NEVER
Nunca passa. - GL_LESS
Passa se o valor alfa de entrada for menor que o valor de referência. - GL_EQUAL
Passa se o valor alfa de entrada for igual ao valor de referência. - GL_LEQUAL
Passa se o valor alfa de entrada for menor ou igual ao valor de referência. - GL_GREATER
Passa se o valor alfa de entrada for maior que o valor de referência. - GL_NOTEQUAL
Passa se o valor alfa de entrada não for igual ao valor de referência. - GL_GEQUAL
Passa se o valor alfa de entrada for maior ou igual ao valor de referência. - GL_ALWAYS
Sempre passa. Esse é o padrão. -
ref
-
O valor de referência ao qual os valores alfa de entrada são comparados. Esse valor é fixado no intervalo de 0 a 1, em que 0 representa o menor valor alfa possível e 1 o valor mais alto possível. A referência padrão é 0.
Retornar valor
Essa função não retorna um valor.
Códigos de erro
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
| Nome | Significado |
|---|---|
|
func não era um valor aceito. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
Comentários
O teste alfa descarta fragmentos dependendo do resultado de uma comparação entre os valores alfa dos fragmentos de entrada e um valor de referência constante. A função glAlphaFunc especifica a função de referência e comparação. A comparação será executada somente se o teste alfa estiver habilitado. (Para obter mais informações sobre GL_ALPHA_TEST, consulte glEnable.)
Os parâmetros func e ref especificam as condições sob as quais o pixel é desenhado. O valor alfa de entrada é comparado ao ref usando a função especificada por func. Se a comparação for aprovada, o fragmento de entrada será desenhado, condicional em testes subsequentes de estêncil e buffer de profundidade. Se a comparação falhar, nenhuma alteração será feita no framebuffer nesse local de pixel.
A função glAlphaFunc opera em todas as gravações de pixel, incluindo aquelas resultantes da conversão de verificação de pontos, linhas, polígonos e bitmaps e de operações de desenho e cópia de pixel. A função glAlphaFunc não afeta as operações de limpeza de tela.
O teste alfa é feito somente no modo RGBA.
As seguintes funções recuperam informações relacionadas à função glAlphaFunc :
glGet com GL_ALPHA_TEST_FUNC de argumento
glGet com GL_ALPHA_TEST_REF de argumento
glIsEnabled com argumento GL_ALPHA_TEST
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|