WebGLRenderingContext: cullFace() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

注意:此功能在 Web Workers 中可用。

WebGLRenderingContext.cullFace() 方法是 WebGL API 的一部分,用于指定是否剔除正面和/或背面多边形。

语法

js
cullFace(mode)

参数

模式

一个 GLenum,用于指定正面或背面多边形是否为剔除的目标。默认值为 gl.BACK。可能的值有:

  • gl.FRONT
  • gl.BACK
  • gl.FRONT_AND_BACK

返回值

无(undefined)。

示例

默认情况下,多边形剔除是禁用的。要启用或禁用剔除,请使用 enable()disable() 方法,并将参数设置为 gl.CULL_FACE

js
gl.enable(gl.CULL_FACE);
gl.cullFace(gl.FRONT_AND_BACK);

要检查当前剔除面模式,请查询 CULL_FACE_MODE 常量。

js
gl.getParameter(gl.CULL_FACE_MODE) === gl.FRONT_AND_BACK;
// true

规范

规范
WebGL 规范
# 5.14.3

浏览器兼容性

另见