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
GL_INVALID_ENUM	func não era um valor aceito.
GL_INVALID_OPERATION	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	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc