大网数据广告活动
Web 标准与前端开发

EXT_polygon_offset_clamp: polygonOffsetClampEXT() method

· 52CE 我爱测

The **`polygonOffsetClampEXT()`** method of the EXT_polygon_offset_clamp extension of the WebGL API specifies the scale factor and units used to calculate depth offsets, like WebGLRenderingContext.polygonOffset(), and a limit for the resulting offset.

WebGL

The polygonOffsetClampEXT() method of the EXT_polygon_offset_clamp extension of the WebGL API specifies the scale factor and units used to calculate depth offsets, like WebGLRenderingContext.polygonOffset(), and a limit for the resulting offset.

The offset is computed from factor and units in the same way as with polygonOffset(), then limited by clamp:

  • If clamp is positive, the offset is at most clamp.
  • If clamp is negative, the offset is at least clamp.
  • If clamp is 0 or NaN, the offset isn't limited.

Calling polygonOffset() is the same as calling polygonOffsetClampEXT() with a clamp of 0, so it removes the limit.

The depth offset applies only when gl.POLYGON_OFFSET_FILL is enabled with WebGLRenderingContext.enable().

Syntax

polygonOffsetClampEXT(factor, units, clamp)

Parameters

  • factor
    • : A WebGL_API/Types which sets the scale factor for the variable depth offset for each polygon. The default value is 0.
  • units
    • : A WebGL_API/Types which sets the multiplier by which an implementation-specific value is multiplied with to create a constant depth offset. The default value is 0.
  • clamp
    • : A WebGL_API/Types which sets the maximum (if positive) or minimum (if negative) depth offset. The default value is 0, which means no limit.

Return value

None (undefined).

Examples

Limiting the depth offset

This example enables the depth offset, sets a factor of 2 and units of 3, and 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);

To check the current values, query the POLYGON_OFFSET_FACTOR, POLYGON_OFFSET_UNITS, and POLYGON_OFFSET_CLAMP_EXT constants:

gl.getParameter(gl.POLYGON_OFFSET_FACTOR); // 2
gl.getParameter(gl.POLYGON_OFFSET_UNITS); // 3
gl.getParameter(ext.POLYGON_OFFSET_CLAMP_EXT); // 0.0010000000474974513

Specifications

Browser compatibility

See also

  • EXT_polygon_offset_clamp
  • WebGLRenderingContext.polygonOffset()
  • WebGLRenderingContext.getParameter()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。