GPURenderBundleEncoder: pushDebugGroup() 方法

可用性有限

此特性不是基線特性,因為它在一些最廣泛使用的瀏覽器中不起作用。

安全上下文: 此功能僅在安全上下文(HTTPS)中可用,且支援此功能的瀏覽器數量有限。

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

GPURenderBundleEncoder 介面的 pushDebugGroup() 方法會開始一個渲染束除錯組,該除錯組會用指定的標籤進行標記,幷包含之後編碼的所有命令,直到呼叫 popDebugGroup() 方法為止。

這可以用於遙測,或在將來可能用於 GPUError 訊息、瀏覽器開發者工具或其他服務中,以幫助除錯。

注意:此方法在功能上與其在 GPURenderPassEncoder 上的對應方法 — pushDebugGroup() — 完全相同。

語法

js
pushDebugGroup(groupLabel)

引數

groupLabel

一個字串,表示除錯組的標籤。

返回值

無 (Undefined)。

示例

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

瀏覽器相容性

另見