WebGL2RenderingContext: beginQuery() 方法

Baseline 已广泛支持

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

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

WebGL2RenderingContext.beginQuery() 方法是 WebGL 2 API 的一部分，用于启动一个异步查询。target 参数指示要开始哪种类型的查询。

语法

beginQuery(target, query)

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

gl.ANY_SAMPLES_PASSED: 指定一个遮挡查询：这些查询用于检测对象是否可见（即，作用域内的绘图命令是否通过了深度测试，以及通过的样本数量）。
gl.ANY_SAMPLES_PASSED_CONSERVATIVE: 与上面相同，但精度较低且速度更快。
gl.TRANSFORM_FEEDBACK_PRIMITIVES_WRITTEN: 写入变换反馈缓冲区（transform feedback buffers）的图元（primitives）数量。

要开始查询的 WebGLQuery 对象。

无（undefined）。

const query = gl.createQuery();
gl.beginQuery(gl.ANY_SAMPLES_PASSED, query);

// …

规范
WebGL 2.0 规范 # 3.7.12

此页面最后更新于 ⁨2025年6月23日⁩，由 MDN 贡献者修改。