WebGLRenderingContext: hint() 方法

Baseline 已广泛支持

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

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

WebGLRenderingContext.hint() 方法是 WebGL API 的一部分,用于指定某些行为的提示。这些提示的解释取决于具体实现。

语法

js
hint(target, mode)

参数

目标

设置要控制的行为。可能的值

gl.GENERATE_MIPMAP_HINT

使用 WebGLRenderingContext.generateMipmap() 生成 Mipmap 图像时,过滤的质量。

使用 OES_standard_derivatives 扩展时

ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES

GLSL 内置函数 dFdxdFdyfwidth 的导数计算精度。

使用 WebGL 2 上下文时,还可以使用以下值:

gl.FRAGMENT_SHADER_DERIVATIVE_HINT

ext.FRAGMENT_SHADER_DERIVATIVE_HINT_OES 相同

模式

设置行为。默认值为 gl.DONT_CARE。可能的值为

  • gl.FASTEST:应使用最高效的行为。
  • gl.NICEST:应使用最准确或最高质量的选项。
  • gl.DONT_CARE:对此行为没有偏好。

返回值

无(undefined)。

示例

以下示例提示,生成 Mipmap 图像时,过滤质量应以最高效为目标,而不是追求最佳质量。

js
gl.hint(gl.GENERATE_MIPMAP_HINT, gl.FASTEST);

规范

规范
WebGL 规范
# 5.14.3

浏览器兼容性

另见