WebGLRenderingContext:hint() 方法

基线 广泛可用

此功能已得到很好的建立,并且可以在许多设备和浏览器版本上运行。它自以下时间起在浏览器中可用 2015 年 7 月.

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

语法

js
hint(target, mode)

参数

target

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

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 相同

mode

设置行为。默认值为 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

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

另请参阅