GPURenderBundleEncoder: pushDebugGroup() 方法

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

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，在一些或所有支持浏览器中可用。

GPURenderBundleEncoder 接口的 pushDebugGroup() 方法开始一个渲染包调试组，该组用指定标签标记，并将包含所有后续编码命令，直到调用 popDebugGroup() 方法。

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

注意：此方法在功能上与 GPURenderPassEncoder 上的等效方法 — pushDebugGroup() 相同。

语法

js
pushDebugGroup(groupLabel)

参数

groupLabel

表示调试组标签的字符串。

返回值

无 (Undefined)。

示例

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-pushdebuggroup

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见