glAlphaFunc-Funktion
Mit der glAlphaFunc-Funktion kann Ihre Anwendung die Alphatestfunktion festlegen.
Syntax
void WINAPI glAlphaFunc(
GLenum func,
GLclampf ref
);
Parameter
-
func
-
Die Alphavergleichsfunktion. Im Folgenden werden die akzeptierten symbolischen Konstanten und ihre Bedeutungen aufgeführt.
Wert Bedeutung - GL_NEVER
Niemals bestanden. - GL_LESS
Wird übergeben, wenn der eingehende Alphawert kleiner als der Verweiswert ist. - GL_EQUAL
Wird übergeben, wenn der eingehende Alphawert gleich dem Verweiswert ist. - GL_LEQUAL
Wird übergeben, wenn der eingehende Alphawert kleiner oder gleich dem Verweiswert ist. - GL_GREATER
Wird übergeben, wenn der eingehende Alphawert größer als der Verweiswert ist. - GL_NOTEQUAL
Wird übergeben, wenn der eingehende Alphawert nicht gleich dem Verweiswert ist. - GL_GEQUAL
Wird übergeben, wenn der eingehende Alphawert größer oder gleich dem Verweiswert ist. - GL_ALWAYS
Immer erfolgreich. Dies ist die Standardeinstellung. -
ref
-
Der Verweiswert, mit dem eingehende Alphawerte verglichen werden. Dieser Wert wird auf den Bereich 0 bis 1 geklemmt, wobei 0 den niedrigsten möglichen Alphawert und 1 den höchsten möglichen Wert darstellt. Der Standardverweis ist 0.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
func war kein akzeptierter Wert. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Der Alphatest verwirft Fragmente abhängig vom Ergebnis eines Vergleichs zwischen den Alphawerten der eingehenden Fragmente und einem konstanten Referenzwert. Die glAlphaFunc-Funktion gibt die Verweis- und Vergleichsfunktion an. Der Vergleich wird nur durchgeführt, wenn Alphatests aktiviert sind. (Weitere Informationen zu GL_ALPHA_TEST finden Sie unter glEnable.)
Die Parameter funkc und ref geben die Bedingungen an, unter denen das Pixel gezeichnet wird. Der eingehende Alphawert wird mit der von func angegebenen Funktion mit ref verglichen. Wenn der Vergleich erfolgreich ist, wird das eingehende Fragment gezeichnet, abhängig von nachfolgenden Schablonen- und Tiefenpuffertests. Wenn der Vergleich fehlschlägt, wird am Framebuffer an dieser Pixelposition keine Änderung vorgenommen.
Die glAlphaFunc-Funktion funktioniert für alle Pixelschreibvorgänge, einschließlich derer, die sich aus der Scankonvertierung von Punkten, Linien, Polygonen und Bitmaps sowie aus Pixelzeichnungs- und Kopiervorgängen ergeben. Die glAlphaFunc-Funktion wirkt sich nicht auf Vorgänge zum Löschen des Bildschirms aus.
Alphatests werden nur im RGBA-Modus durchgeführt.
Die folgenden Funktionen rufen Informationen im Zusammenhang mit der glAlphaFunc-Funktion ab:
glGet mit Argument GL_ALPHA_TEST_FUNC
glGet mit Argument GL_ALPHA_TEST_REF
glIsEnabled mit Argument GL_ALPHA_TEST
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|