GPURenderPassEncoder: pushDebugGroup()-Methode

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 vor der Verwendung auf produktiven Webseiten.

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

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die pushDebugGroup()-Methode der GPURenderPassEncoder-Schnittstelle startet eine Debuggruppe für den Renderpass, die mit einem angegebenen Label markiert ist und alle folgenden kodierten Befehle umfasst, bis eine popDebugGroup()-Methode aufgerufen wird.

Diese Methode könnte für Telemetrie verwendet werden oder in der Zukunft in GPUError-Meldungen, Entwicklerwerkzeugen des Browsers oder anderen Diensten genutzt werden, um beim Debugging zu helfen.

Syntax

js
pushDebugGroup(groupLabel)

Parameter

groupLabel

Ein String, der das Label für die Debuggruppe repräsentiert.

Rückgabewert

Keiner (Undefined).

Beispiele

js
// ...

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

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

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

passEncoder.popDebugGroup();

// ...

Spezifikationen

Specification
WebGPU
# dom-gpudebugcommandsmixin-pushdebuggroup

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch