funzione glAlphaFunc

La funzione glAlphaFunc consente all'applicazione di impostare la funzione di test alfa.

Sintassi

void WINAPI glAlphaFunc(
   GLenum   func,
   GLclampf ref
);

Parametri

func

Funzione di confronto alfa. Di seguito sono riportate le costanti simboliche accettate e i loro significati.

Valore	Significato
GL_NEVER	Non passa mai.
GL_LESS	Passa se il valore alfa in ingresso è minore del valore di riferimento.
GL_EQUAL	Passa se il valore alfa in ingresso è uguale al valore di riferimento.
GL_LEQUAL	Passa se il valore alfa in ingresso è minore o uguale al valore di riferimento.
GL_GREATER	Passa se il valore alfa in ingresso è maggiore del valore di riferimento.
GL_NOTEQUAL	Passa se il valore alfa in ingresso non è uguale al valore di riferimento.
GL_GEQUAL	Passa se il valore alfa in ingresso è maggiore o uguale al valore di riferimento.
GL_ALWAYS	Passa sempre. Questo è il valore predefinito.

ref

Valore di riferimento a cui vengono confrontati i valori alfa in ingresso. Questo valore viene bloccato all'intervallo da 0 a 1, dove 0 rappresenta il valore alfa più basso possibile e 1 il valore più alto possibile. Il riferimento predefinito è 0.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

I codici di errore seguenti possono essere recuperati dalla funzione glGetError .

Nome	Significato
GL_INVALID_ENUM	func non era un valore accettato.
GL_INVALID_OPERATION	La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

Il test alfa elimina frammenti a seconda del risultato di un confronto tra i valori alfa dei frammenti in ingresso e un valore di riferimento costante. La funzione glAlphaFunc specifica la funzione di riferimento e confronto. Il confronto viene eseguito solo se il test alfa è abilitato. Per altre informazioni su GL_ALPHA_TEST, vedere glEnable.

I parametri func e ref specificano le condizioni in cui viene disegnato il pixel. Il valore alfa in ingresso viene confrontato con ref usando la funzione specificata da func. Se il confronto passa, il frammento in ingresso viene disegnato, condizionale per i test successivi dello stencil e del buffer di profondità. Se il confronto ha esito negativo, non viene apportata alcuna modifica al framebuffer in corrispondenza di tale posizione pixel.

La funzione glAlphaFunc opera su tutte le scritture pixel, incluse quelle risultanti dalla conversione di punti, linee, poligoni e bitmap e da operazioni di disegno e copia pixel. La funzione glAlphaFunc non influisce sulle operazioni di cancellazione dello schermo.

I test alfa vengono eseguiti solo in modalità RGBA.

Le funzioni seguenti recuperano informazioni correlate alla funzione glAlphaFunc :

glGet con argomento GL_ALPHA_TEST_FUNC

glGet con argomento GL_ALPHA_TEST_REF

glIsEnabled con argomento GL_ALPHA_TEST

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	Gl.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc