WebGL2RenderingContext: getQuery() 方法

Baseline 已广泛支持

此功能已成熟,并可在多种设备和浏览器版本上运行。自 2021 年 9 月起,所有浏览器均已支持此功能。

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

WebGL2RenderingContext.getQuery() 方法是 WebGL 2 API 的一部分,它返回 target 指定的当前活动的 WebGLQuery 对象,或者返回 null

语法

js
getQuery(target, pname)

参数

目标

一个 GLenum,指定查询的目标。可能的值包括:

gl.ANY_SAMPLES_PASSED

指定一个遮挡查询:这些查询用于检测对象是否可见(即,作用域内的绘图命令是否通过了深度测试,以及通过的样本数量)。

gl.ANY_SAMPLES_PASSED_CONSERVATIVE

与上面相同,但精度较低且速度更快。

gl.TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN

写入变换反馈缓冲区(transform feedback buffers)的图元(primitives)数量。

pname

一个 GLenum,指定查询对象的目标。必须是 gl.CURRENT_QUERY

返回值

一个 WebGLQuery 对象。

示例

js
const currentQuery = gl.getQuery(gl.ANY_SAMPLES_PASSED, gl.CURRENT_QUERY);

规范

规范
WebGL 2.0 规范
# 3.7.12

浏览器兼容性

另见