WebGLRenderingContext: depthFunc() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.depthFunc() Methode der WebGL API spezifiziert eine Funktion, die die Tiefe des eintreffenden Pixels mit dem aktuellen Wert im Tiefenpuffer vergleicht.

Syntax

js
depthFunc(func)

Parameter

func

Ein GLenum, das die Vergleichsfunktion für die Tiefe angibt und die Bedingungen festlegt, unter denen das Pixel gezeichnet wird. Der Standardwert ist gl.LESS. Mögliche Werte sind:

  • gl.NEVER (nie passieren)
  • gl.LESS (passieren, wenn der eintreffende Wert kleiner als der Wert im Tiefenpuffer ist)
  • gl.EQUAL (passieren, wenn der eintreffende Wert gleich dem Wert im Tiefenpuffer ist)
  • gl.LEQUAL (passieren, wenn der eintreffende Wert kleiner oder gleich dem Wert im Tiefenpuffer ist)
  • gl.GREATER (passieren, wenn der eintreffende Wert größer als der Wert im Tiefenpuffer ist)
  • gl.NOTEQUAL (passieren, wenn der eintreffende Wert ungleich dem Wert im Tiefenpuffer ist)
  • gl.GEQUAL (passieren, wenn der eintreffende Wert größer oder gleich dem Wert im Tiefenpuffer ist)
  • gl.ALWAYS (immer passieren)

Rückgabewert

Keiner (undefined).

Beispiele

Das Tiefentest ist standardmäßig deaktiviert. Um das Tiefentest zu aktivieren oder zu deaktivieren, verwenden Sie die Methoden enable() und disable() mit dem Argument gl.DEPTH_TEST.

js
gl.enable(gl.DEPTH_TEST);
gl.depthFunc(gl.NEVER);

Um die aktuelle Tiefenfunktion zu überprüfen, fragen Sie die Konstante DEPTH_FUNC ab.

js
gl.getParameter(gl.DEPTH_FUNC) === gl.NEVER;
// true

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch