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
GL_INVALID_ENUM	func war kein akzeptierter Wert.
GL_INVALID_OPERATION	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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Siehe auch

glBegin

glBlendFunc

glClear

glDepthFunc

glEnable

glEnd

glGet

glIsEnabled

glStencilFunc