GPURenderPassEncoder: executeBundles()-Methode
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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 executeBundles()-Methode der GPURenderPassEncoder-Schnittstelle führt Befehle aus, die zuvor in die referenzierten GPURenderBundles aufgezeichnet wurden, als Teil dieses Render-Passes.
Hinweis:
Nach dem Aufruf von executeBundles() werden die derzeit gesetzten Vertex-Buffer, Index-Buffer, Bind-Gruppen und die Pipeline alle gelöscht, selbst wenn keine Bundles tatsächlich ausgeführt werden.
Syntax
executeBundles(bundles)
Parameter
bundles-
Ein Array von
GPURenderBundle-Objekten, das die auszuführenden vorab aufgezeichneten Befehle enthält.
Rückgabewert
Keiner (undefined).
Validierung
Die folgenden Kriterien müssen beim Aufruf von executeBundles() erfüllt sein, andernfalls wird ein GPUValidationError erzeugt und der GPURenderPassEncoder wird ungültig.
Für jedes GPURenderBundle:
- Wenn die
depthReadOnly-Eigenschaft des Render-Passes (wie im Deskriptor des ursprünglichenGPUCommandEncoder.beginRenderPass()-Aufrufs angegeben)trueist, dann ist auch diedepthReadOnly-Eigenschaft des Bundles (wie im Deskriptor desGPUDevice.createRenderBundleEncoder()-Aufrufs, der den ursprünglichenGPURenderBundleEncodererstellt hat, angegeben)true. - Wenn die
stencilReadOnly-Eigenschaft des Render-Passes (wie im Deskriptor des ursprünglichenGPUCommandEncoder.beginRenderPass()-Aufrufs angegeben)trueist, dann ist auch diestencilReadOnly-Eigenschaft des Bundles (wie im Deskriptor desGPUDevice.createRenderBundleEncoder()-Aufrufs, der den ursprünglichenGPURenderBundleEncodererstellt hat, angegeben)true. - Das Layout der in
GPURenderPassEncoder.setPipeline()angegebenen Render-Pipeline (wie im Deskriptor des ursprünglichenGPUDevice.createRenderPipeline()-Aufrufs definiert) entspricht dem Layout der inGPURenderBundleEncoder.setPipeline()angegebenen Render-Bundle-Pipeline.
Beispiele
Im WebGPU-Samples Animometer-Beispiel werden viele ähnliche Operationen gleichzeitig auf verschiedenen Objekten durchgeführt. executeBundles() wird verwendet, um die Arbeit in mehreren Render-Pässen wiederzuverwenden, um die Leistung zu verbessern. Studieren Sie die Beispiel-Code-Auflistung für den vollständigen Kontext.
// …
return function doDraw(timestamp) {
if (startTime === undefined) {
startTime = timestamp;
}
uniformTime[0] = (timestamp - startTime) / 1000;
device.queue.writeBuffer(uniformBuffer, timeOffset, uniformTime.buffer);
renderPassDescriptor.colorAttachments[0].view = context
.getCurrentTexture()
.createView();
const commandEncoder = device.createCommandEncoder();
const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);
if (settings.renderBundles) {
passEncoder.executeBundles([renderBundle]);
} else {
recordRenderPass(passEncoder);
}
passEncoder.end();
device.queue.submit([commandEncoder.finish()]);
};
// …
Spezifikationen
| Spezifikation |
|---|
| WebGPU # dom-gpurenderpassencoder-executebundles |
Browser-Kompatibilität
Siehe auch
- Die WebGPU API