GPURenderBundleEncoder: popDebugGroup() 方法

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

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,在某些或所有 支持的浏览器 中。

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

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

注意:此方法在功能上与 GPURenderPassEncoder 上的等效方法(popDebugGroup())相同。

语法

js
popDebugGroup()

参数

无。

返回值

无(Undefined)。

验证

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

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

示例

js
// ...

const bundleEncoder = device.createRenderBundleEncoder(renderBundleDescriptor);

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

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

bundleEncoder.popDebugGroup();

// ...

规范

规范
WebGPU
# dom-gpudebugcommandsmixin-popdebuggroup

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅