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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
polygonOffset

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch