WebGL
The EXT_polygon_offset_clamp extension is part of the WebGL API and adds a limit to the depth offset set with WebGLRenderingContext.polygonOffset().
The depth offset of a polygon grows with its slope, so polygons that are almost parallel to the view direction can get very large offsets. In shadow mapping, this can push shadow-casting polygons behind the surfaces they should shadow, which shows up as holes in the shadows. Limiting the offset to a maximum value avoids this.
WebGL extensions are available using the WebGLRenderingContext.getExtension() method. For more information, see also Using Extensions in the WebGL tutorial.
[!NOTE] This extension is available to both WebGLRenderingContext and WebGL2RenderingContext contexts. Support depends on the system's graphics driver.
Constants
ext.POLYGON_OFFSET_CLAMP_EXT- : A WebGL_API/Types to pass to WebGLRenderingContext.getParameter() to get the current offset limit, as a WebGL_API/Types. The default value is
0.
- : A WebGL_API/Types to pass to WebGLRenderingContext.getParameter() to get the current offset limit, as a WebGL_API/Types. The default value is
Instance methods
- EXT_polygon_offset_clamp.polygonOffsetClampEXT()
- : Sets the scale factor and units used to calculate depth offsets, and a limit for the resulting offset.
Examples
Limiting the depth offset
The depth offset applies only when gl.POLYGON_OFFSET_FILL is enabled. This example sets the same factor and units as polygonOffset(2, 3) would, and also limits the offset to 0.001:
const ext = gl.getExtension("EXT_polygon_offset_clamp");
gl.enable(gl.POLYGON_OFFSET_FILL);
ext.polygonOffsetClampEXT(2, 3, 0.001);
gl.getParameter(ext.POLYGON_OFFSET_CLAMP_EXT); // 0.0010000000474974513
The value is stored as a 32-bit float, so it reads back as the nearest 32-bit value to 0.001.
Specifications
Browser compatibility
See also
- WebGLRenderingContext.getExtension()
- WebGLRenderingContext.polygonOffset()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
