GPURenderBundleEncoder: popDebugGroup() 方法

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

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

GPURenderBundleEncoder 接口的 popDebugGroup() 方法用于结束一个渲染束调试组,该调试组由调用 pushDebugGroup() 方法开始。

这可以用于遥测,或在将来可能用于 GPUError 消息、浏览器开发者工具或其他服务中,以帮助调试。

注意:此方法的功能与其在 GPURenderPassEncoder 上的对应方法 — popDebugGroup() — 完全相同。

语法

js
popDebugGroup()

参数

无。

返回值

无 (Undefined)。

验证

调用 popDebugGroup() 时必须满足以下条件,否则将生成 GPUValidationError,并且 GPURenderBundleEncoder 会失效。

  • 渲染束编码器的调试堆栈不为空(即,至少一个渲染束调试组之前已通过 pushDebugGroup() 启动)。

示例

js
// …

const bundleEncoder = device.createRenderBundleEncoder(renderBundleDescriptor);

bundleEncoder.pushDebugGroup("my_group_marker"); // Start labeled debug group

bundleEncoder.setPipeline(renderPipeline);
bundleEncoder.setVertexBuffer(0, vertexBuffer);
bundleEncoder.draw(3);

bundleEncoder.popDebugGroup();

// …

规范

规范
WebGPU
# dom-gpudebugcommandsmixin-popdebuggroup

浏览器兼容性

另见