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 |
|---|---|
|
func non era un valore accettato. |
|
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 |
|
| Libreria |
|
| DLL |
|