GPURenderBundleEncoder: Methode pushDebugGroup()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die pushDebugGroup()-Methode der GPURenderBundleEncoder-Schnittstelle beginnt eine Render-Bundle-Debug-Gruppe, die mit einem angegebenen Label markiert ist und alle nachfolgenden kodierten Befehle enthält, bis eine popDebugGroup()-Methode aufgerufen wird.

Dies könnte für Telemetrie verwendet werden oder möglicherweise in der Zukunft in GPUError-Meldungen, Entwicklungswerkzeugen des Browsers oder anderen Diensten zur Unterstützung der Fehlersuche eingesetzt werden.

Hinweis: Diese Methode ist funktional identisch mit ihrem Äquivalent auf GPURenderPassEncoder — pushDebugGroup().

Syntax

js
pushDebugGroup(groupLabel)

Parameter

groupLabel

Ein String, der das Label für die Debug-Gruppe darstellt.

Rückgabewert

Keiner (Undefined).

Beispiele

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();

// ...

Spezifikationen

Specification
WebGPU
# dom-gpudebugcommandsmixin-pushdebuggroup

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch