WebGLRenderingContext: depthFunc() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WebGLRenderingContext.depthFunc()-Methode der WebGL API legt eine Funktion fest, die die Tiefe der eingehenden Pixel mit dem aktuellen Wert des Tiefenpuffers vergleicht.
Syntax
depthFunc(func)
Parameter
func-
Ein
GLenum, der die Tiefenvergleichsfunktion angibt, welche die Bedingungen festlegt, unter denen das Pixel gezeichnet wird. Der Standardwert istgl.LESS. Mögliche Werte sind:gl.NEVER(niemals durchlassen)gl.LESS(durchlassen, wenn der eingehende Wert kleiner als der Tiefenpufferwert ist)gl.EQUAL(durchlassen, wenn der eingehende Wert dem Tiefenpufferwert entspricht)gl.LEQUAL(durchlassen, wenn der eingehende Wert kleiner oder gleich dem Tiefenpufferwert ist)gl.GREATER(durchlassen, wenn der eingehende Wert größer als der Tiefenpufferwert ist)gl.NOTEQUAL(durchlassen, wenn der eingehende Wert ungleich dem Tiefenpufferwert ist)gl.GEQUAL(durchlassen, wenn der eingehende Wert größer oder gleich dem Tiefenpufferwert ist)gl.ALWAYS(immer durchlassen)
Rückgabewert
Keiner (undefined).
Beispiele
Die Tiefenprüfung ist standardmäßig deaktiviert. Um die Tiefenprüfung zu aktivieren oder zu deaktivieren, verwenden Sie die Methoden enable() und disable() mit dem Argument gl.DEPTH_TEST.
gl.enable(gl.DEPTH_TEST);
gl.depthFunc(gl.NEVER);
Um die aktuelle Tiefenfunktion zu überprüfen, fragen Sie die DEPTH_FUNC-Konstante ab.
gl.getParameter(gl.DEPTH_FUNC) === gl.NEVER;
// true
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification # 5.14.3 |