GPUCommandEncoder: popDebugGroup() Methode

Limited availability

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

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 popDebugGroup()-Methode der GPUCommandEncoder-Schnittstelle beendet eine Debug-Gruppe, die mit einem pushDebugGroup()-Aufruf begonnen wurde.

Dies könnte für Telemetrie verwendet werden oder in Zukunft in GPUError-Meldungen, Browser-Entwicklungstools oder anderen Diensten genutzt werden, um beim Debuggen zu helfen.

Syntax

js
popDebugGroup()

Parameter

Keine.

Rückgabewert

Keiner (Undefined).

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn popDebugGroup() aufgerufen wird, ansonsten wird ein GPUValidationError erzeugt und der GPUCommandEncoder wird ungültig:

  • Der Debug-Stack des Command Encoders ist nicht leer (d.h. es wurde zuvor mindestens eine Debug-Gruppe mit pushDebugGroup() gestartet).

Beispiele

js
// …

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

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

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

passEncoder.end();

commandEncoder.popDebugGroup(); // End labeled debug group

// …

Spezifikationen

Specification
WebGPU
# dom-gpudebugcommandsmixin-popdebuggroup

Browser-Kompatibilität

Siehe auch