GPURenderBundleEncoder: finish()-Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
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 finish()-Methode der
GPURenderBundleEncoder-Schnittstelle schließt die Aufzeichnung der aktuellen Render-Bundle-Befehlssequenz ab und gibt ein GPURenderBundle-Objekt zurück, das in einen GPURenderPassEncoder.executeBundles()-Aufruf übergeben werden kann, um diese Befehle in einem spezifischen Render-Pass auszuführen.
Syntax
finish(descriptor)
Parameter
descriptorOptional-
Ein Objekt mit den folgenden Eigenschaften:
labelOptional-
Ein String, der ein Label bereitstellt, das zur Identifizierung des Objekts verwendet werden kann, zum Beispiel in
GPUError-Meldungen oder Konsolenwarnungen.
Rückgabewert
Eine Instanz des GPURenderBundle-Objekts.
Validierung
Die folgenden Kriterien müssen erfüllt sein, wenn finish() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und der GPURenderBundleEncoder wird ungültig:
- Der
GPURenderBundleEncodermuss geöffnet sein (d.h. nicht bereits durch einenfinish()-Aufruf beendet). - Der Debug-Stack für den aktuellen Render-Pass muss leer sein (d.h. keine Render-Pass-Debug-Gruppe ist derzeit geöffnet, wie sie durch
pushDebugGroup()geöffnet wurde).
Beispiele
const renderBundleEncoder = device.createRenderBundleEncoder({
colorFormats: [presentationFormat],
});
recordRenderPass(renderBundleEncoder);
const renderBundle = renderBundleEncoder.finish();
Der obige Codeausschnitt stammt aus dem WebGPU Samples Animometer-Beispiel.
Spezifikationen
| Spezifikation |
|---|
| WebGPU # dom-gpurenderbundleencoder-finish |
Browser-Kompatibilität
Siehe auch
- Die WebGPU API