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 sind die akzeptierten symbolischen Konstanten und ihre Bedeutungen.
Wert Bedeutung - GL _ NEVER
Nie erfolgreich. - GL _ LESS
Übergibt , wenn der eingehende Alphawert kleiner als der Verweiswert ist. - GL _ EQUAL
Übergibt , wenn der eingehende Alphawert gleich dem Verweiswert ist. - GL _ LEQUAL
Übergibt , wenn der eingehende Alphawert kleiner oder gleich dem Verweiswert ist. - GL _ GREATER
Übergibt, wenn der eingehende Alphawert größer als der Verweiswert ist. - GL _ NOTEQUAL
Übergibt, wenn der eingehende Alphawert ungleich dem Verweiswert ist. - GL _ GEQUAL
Übergibt , wenn der eingehende Alphawert größer oder gleich dem Verweiswert ist. - GL _ ALWAYS
Immer erfolgreich. Dies ist die Standardoption. -
ref
-
Der Verweiswert, mit dem eingehende Alphawerte verglichen werden. Dieser Wert wird an den Bereich 0 bis 1 klammern, 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 glEndaufgerufen. |
Hinweise
Der Alphatest verwirft Fragmente abhängig vom Ergebnis eines Vergleichs zwischen den Alphawerten der eingehenden Fragmente und einem konstanten Verweiswert. Die glAlphaFunc-Funktion gibt die Verweis- und Vergleichsfunktion an. Der Vergleich wird nur ausgeführt, wenn Alphatests aktiviert sind. (Weitere Informationen zu GL _ ALPHA _ TEST, siehe glEnable.)
Die Parameter func und ref geben die Bedingungen an, unter denen das Pixel gezeichnet wird. Der eingehende Alphawert wird mit ref mithilfe der von func angegebenen Funktion verglichen. Wenn der Vergleich erfolgreich ist, wird das eingehende Fragment gezeichnet, abhängig von nachfolgenden Schablonen- und Tiefenpuffertests. Wenn der Vergleich fehlschlägt, wird an dieser Pixelposition keine Änderung am Framepuffer vorgenommen.
Die glAlphaFunc-Funktion arbeitet mit allen Pixelschreibvorgängen, einschließlich der Schreibvorgänge, die sich aus der Scankonvertierung von Punkten, Linien, Polygonen und Bitmaps sowie aus Pixel-Zeichnen- 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
Requirements (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 |
|