gl.AlphaFunc(func, ref)
gl.AlphaFunc()
gibt den Referenzwert und die
Vergleichsfunktion an. Der Vergleich wird nur durchgeführt, wenn der
Alpha-Test aktiviert ist. Standardmäßig ist er nicht aktiviert.
(Siehe gl.Enable() und gl.Disable() unter #GL_ALPHA_TEST
.)
func
und ref
geben die Bedingungen an, unter denen das Pixel gezeichnet wird.
Der eingehende Alpha-Wert wird in ref
mit der in func
angegebenen Funktion
verglichen. Wenn der Wert den Vergleich besteht, wird das eingehende Fragment
gezeichnet, wenn es auch nachfolgende Schablonen- und Tiefenpuffer-Tests
(Stencil- und Depth-Puffertest) durchläuft. Wenn der Wert den Vergleich nicht
besteht, wird keine Änderung an dem Bildpuffer an dieser Pixelstelle vorgenommen.
Die Vergleichsfunktionen sind wie folgt:
#GL_NEVER
#GL_LESS
#GL_EQUAL
#GL_LEQUAL
#GL_GREATER
#GL_NOTEQUAL
#GL_GEQUAL
#GL_ALWAYS
gl.AlphaFunc()
funktioniert bei allen Pixelschreibvorgängen, einschließlich
denjenigen, die sich aus der Scanumwandlung von Punkten, Linien, Polygonen
und Bitmaps ergeben und aus Pixelzeichnungs- und Pixelkopiervorgängen. gl.AlphaFunc()
wirkt sich nicht auf Bildschirmlöschvorgänge aus.
Weitere Informationen finden Sie in einem OpenGL-Referenzhandbuch.
#GL_INVALID_ENUM
wird generiert, wenn func
kein akzeptierter Wert ist.
#GL_INVALID_OPERATION
wird generiert, wenn gl.AlphaFunc()
zwischen
gl.Begin() und gl.End() ausgeführt wird.
#GL_ALPHA_TEST_FUNC
gl.Get() mit dem Argument #GL_ALPHA_TEST_REF
gl.IsEnabled() mit dem Argument #GL_ALPHA_TEST