GPURenderBundleEncoder

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.

Vollständige Kompatibilität anzeigen
Mehr erfahren

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 GPURenderBundleEncoder-Schnittstelle der WebGPU API wird verwendet, um Befehlsbündel vorab aufzuzeichnen.

Die Befehlsbündel werden durch Aufrufe der Methoden von GPURenderBundleEncoder kodiert. Sobald die gewünschten Befehle kodiert sind, werden sie mit der Methode GPURenderBundleEncoder.finish() in einer GPURenderBundle-Objektinstanz aufgezeichnet. Diese Render-Bündel können anschließend in mehreren Render-Durchläufen wiederverwendet werden, indem die GPURenderBundle-Objekte an Aufrufe von GPURenderPassEncoder.executeBundles() übergeben werden.

Im Grunde entspricht dies einem teilweisen Render-Durchlauf: GPURenderBundleEncoder-Instanzen bieten dieselben Funktionen wie GPURenderPassEncoder-Instanzen. Sie können jedoch keine Occlusion-Queries beginnen oder beenden und weder Scissor-Rechteck noch Viewport, Blend-Konstante oder Stencil-Referenz festlegen. Das GPURenderBundle übernimmt all diese Werte von dem GPURenderPassEncoder, der es ausführt.

Hinweis: Aktuell festgelegte Vertex-Buffer, Index-Buffer, Bind-Gruppen und die Pipeline werden sowohl vor der Ausführung eines Render-Bündels als auch nach dessen Ausführung zurückgesetzt.

Die Wiederverwendung vorab aufgezeichneter Befehle kann die Leistung einer Anwendung erheblich verbessern, wenn der Overhead von JavaScript-Zeichenaufrufen einen Engpass darstellt. Render-Bündel sind besonders effektiv, wenn eine Gruppe von Objekten über mehrere Ansichten oder Frames hinweg auf dieselbe Weise gezeichnet wird und sich lediglich der verwendete Buffer-Inhalt unterscheidet, etwa durch aktualisierte Matrix-Uniforms. Ein gutes Beispiel ist VR-Rendering: Das Rendering als Render-Bündel aufzuzeichnen, dann die Ansichtsmatrix anzupassen und das Bündel für jedes Auge erneut auszuführen, ist eine effizientere Möglichkeit, Zeichenaufrufe für beide Darstellungen der Szene auszugeben.

Eine GPURenderBundleEncoder-Objektinstanz wird über die Methode GPUDevice.createRenderBundleEncoder() erstellt.

Hinweis: Die Methoden von GPURenderBundleEncoder sind funktional identisch mit ihren Entsprechungen auf GPURenderPassEncoder. Eine Ausnahme ist GPURenderBundleEncoder.finish(), dessen Zweck dem von GPUCommandEncoder.finish() ähnelt.

Instanzeigenschaften

label: Ein String mit einer Bezeichnung, anhand derer das Objekt beispielsweise in GPUError-Meldungen oder Konsolenwarnungen identifiziert werden kann.

Instanzmethoden

draw(): Zeichnet Primitive auf Grundlage der mit setVertexBuffer() bereitgestellten Vertex-Buffer.
drawIndexed(): Zeichnet indizierte Primitive auf Grundlage der mit setVertexBuffer() und setIndexBuffer() bereitgestellten Vertex- und Index-Buffer.
drawIndirect(): Zeichnet Primitive anhand von Parametern, die aus einem GPUBuffer gelesen werden.
drawIndexedIndirect(): Zeichnet indizierte Primitive anhand von Parametern, die aus einem GPUBuffer gelesen werden.
finish(): Schließt die Aufzeichnung der aktuellen Befehlsfolge für den Render-Durchlauf ab.
insertDebugMarker(): Markiert eine bestimmte Stelle in einer Folge kodierter Befehle mit einer Bezeichnung.
popDebugGroup(): Beendet eine Debug-Gruppe, die mit einem Aufruf von pushDebugGroup() begonnen wurde.
pushDebugGroup(): Beginnt eine Debug-Gruppe mit einer angegebenen Bezeichnung. Sie enthält alle nachfolgenden kodierten Befehle, bis die Methode popDebugGroup() aufgerufen wird.
setBindGroup(): Legt für einen bestimmten Index die GPUBindGroup fest, die für nachfolgende Render-Bündel-Befehle verwendet wird.
setIndexBuffer(): Legt den aktuellen GPUBuffer fest, der Indexdaten für nachfolgende Zeichenbefehle bereitstellt.
setPipeline(): Legt die GPURenderPipeline fest, die für dieses Render-Bündel verwendet wird.
setVertexBuffer(): Legt den aktuellen GPUBuffer, der Vertex-Daten für nachfolgende Zeichenbefehle bereitstellt, fest oder hebt seine Festlegung auf.

Beispiele

Im Animometer-Beispiel der WebGPU Samples werden viele gleichartige Operationen gleichzeitig auf zahlreichen verschiedenen Objekten ausgeführt. Mit der folgenden Funktion wird ein Befehlsbündel kodiert:

// passEncoder is a GPURenderBundleEncoder or a GPURenderPassEncoder
function recordRenderPass(passEncoder) {
  if (settings.dynamicOffsets) {
    passEncoder.setPipeline(dynamicPipeline);
  } else {
    passEncoder.setPipeline(pipeline);
  }
  passEncoder.setVertexBuffer(0, vertexBuffer);
  passEncoder.setBindGroup(0, timeBindGroup);
  const dynamicOffsets = [0];
  for (let i = 0; i < numTriangles; ++i) {
    if (settings.dynamicOffsets) {
      dynamicOffsets[0] = i * alignedUniformBytes;
      passEncoder.setBindGroup(1, dynamicBindGroup, dynamicOffsets);
    } else {
      passEncoder.setBindGroup(1, bindGroups[i]);
    }
    passEncoder.draw(3, 1, 0, 0);
  }
}

Später wird ein GPURenderBundleEncoder erstellt, die Funktion aufgerufen und das Befehlsbündel mit GPURenderBundleEncoder.finish() in einem GPURenderBundle aufgezeichnet:

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

Anschließend wird GPURenderPassEncoder.executeBundles() verwendet, um die Arbeit über mehrere Render-Durchläufe hinweg wiederzuverwenden und so die Leistung zu verbessern. Den vollständigen Zusammenhang zeigt der Quellcode des Beispiels.

// …

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 # gpurenderbundle

Browser-Kompatibilität

Siehe auch

Die WebGPU API

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden