WebGLRenderingContext: polygonOffset()-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.polygonOffset()-Methode der WebGL API legt die Skalierungsfaktoren und Einheiten fest, um Tiefenwerte zu berechnen.

Der Offset wird hinzugefügt, bevor der Tiefentest durchgeführt und bevor der Wert in den Tiefenpuffer geschrieben wird.

Syntax

js
polygonOffset(factor, units)

Parameter

factor

Ein GLfloat, der den Skalierungsfaktor für den variablen Tiefenoffset für jedes Polygon festlegt. Der Standardwert ist 0.

units

Ein GLfloat, der den Multiplikator festlegt, mit dem ein implementierungsspezifischer Wert multipliziert wird, um einen konstanten Tiefenoffset zu erzeugen. Der Standardwert ist 0.

Rückgabewert

Keiner (undefined).

Beispiele

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

js
gl.enable(gl.POLYGON_OFFSET_FILL);
gl.polygonOffset(2, 3);

Um den aktuellen Polygon-Offset-Faktor oder die Einheiten zu überprüfen, fragen Sie die Konstanten POLYGON_OFFSET_FACTOR und POLYGON_OFFSET_UNITS ab.

js
gl.getParameter(gl.POLYGON_OFFSET_FACTOR); // 2
gl.getParameter(gl.POLYGON_OFFSET_UNITS); // 3

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch