WebGLRenderingContext: Methode polygonOffset()
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 Methode WebGLRenderingContext.polygonOffset() der WebGL-API legt die Skalierungsfaktoren und Einheiten zur Berechnung von Tiefenwerten fest.
Der Versatz wird hinzugefügt, bevor der Tiefentest durchgeführt und der Wert in den Tiefenpuffer geschrieben wird.
Syntax
polygonOffset(factor, units)
Parameter
factor-
Ein
GLfloat, der den Skalierungsfaktor für den variablen Tiefenversatz jedes Polygons festlegt. Der Standardwert ist 0. units-
Ein
GLfloat, der den Multiplikator festlegt, mit dem ein implementierungsspezifischer Wert multipliziert wird, um einen konstanten Tiefenversatz zu erzeugen. Der Standardwert ist 0.
Rückgabewert
Keiner (undefined).
Beispiele
Das Füllen mit Polygonversatz ist standardmäßig deaktiviert. Um es zu aktivieren oder zu deaktivieren, verwenden Sie die Methoden enable() und disable() mit dem Argument gl.POLYGON_OFFSET_FILL.
gl.enable(gl.POLYGON_OFFSET_FILL);
gl.polygonOffset(2, 3);
Um den aktuellen Faktor oder die Einheiten für den Polygonversatz abzufragen, verwenden Sie die Konstanten POLYGON_OFFSET_FACTOR und POLYGON_OFFSET_UNITS.
gl.getParameter(gl.POLYGON_OFFSET_FACTOR); // 2
gl.getParameter(gl.POLYGON_OFFSET_UNITS); // 3
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification # 5.14.3 |