GPURenderBundleEncoder: finish()-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, 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 finish()-Methode der GPURenderBundleEncoder-Schnittstelle beendet die Aufzeichnung der aktuellen Render-Bundle-Befehlsequenz und gibt ein GPURenderBundle-Objekt zurück, das in einem Aufruf von GPURenderPassEncoder.executeBundles() verwendet werden kann, um diese Befehle in einem spezifischen Render-Pass auszuführen.

Syntax

js
finish(descriptor)

Parameter

descriptor Optional

Ein Objekt, das die folgenden Eigenschaften enthält:

label Optional

Ein String, der ein Label bereitstellt, das zum Identifizieren des Objekts verwendet werden kann, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

Rückgabewert

Eine Instanz des Objekts GPURenderBundle.

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn finish() aufgerufen wird, andernfalls wird ein GPUValidationError generiert und der GPURenderBundleEncoder wird ungültig:

  • Der GPURenderBundleEncoder ist geöffnet (d. h. nicht bereits durch einen finish()-Aufruf beendet).
  • Der Debug-Stack für den aktuellen Render-Pass ist leer (d. h. es ist keine Render-Pass-Debug-Gruppe derzeit geöffnet, wie sie durch pushDebugGroup() geöffnet wurde).

Beispiele

js
const renderBundleEncoder = device.createRenderBundleEncoder({
  colorFormats: [presentationFormat],
});
recordRenderPass(renderBundleEncoder);
const renderBundle = renderBundleEncoder.finish();

Der obige Ausschnitt stammt aus den WebGPU-Beispielen des Animometer-Beispiels.

Spezifikationen

Specification
WebGPU
# dom-gpurenderbundleencoder-finish

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch