GPURenderPassEncoder: popDebugGroup() 方法

实验性: 这是一个 实验性技术
在生产环境中使用此功能前,请仔细查看 浏览器兼容性表格

安全上下文:此功能仅在 安全上下文(HTTPS)下可用,并且在部分或全部 支持的浏览器 中可用。

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

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

语法

js
popDebugGroup()

参数

无。

返回值

无(Undefined)。

验证

调用 popDebugGroup() 时必须满足以下条件,否则会生成 GPUValidationError,并且 GPURenderPassEncoder 将变为无效

  • 渲染通道编码器的调试堆栈不为空(即之前至少使用 pushDebugGroup() 启动了一个渲染通道调试组)。

示例

js
// ...

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

passEncoder.pushDebugGroup("mygroupmarker"); // Start labeled debug group

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

passEncoder.popDebugGroup();

// ...

规范

规范
WebGPU
# dom-gpudebugcommandsmixin-popdebuggroup

浏览器兼容性

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

参见