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
GL _ INVALID _ ENUM
func war kein akzeptierter Wert.
GL _ INVALID _ OPERATION
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Siehe auch

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc