GPUCommandEncoder: copyBufferToBuffer()-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.

Die copyBufferToBuffer()-Methode der GPUCommandEncoder-Schnittstelle kodiert einen Befehl, der Daten von einem GPUBuffer in einen anderen kopiert.

Syntax

copyBufferToBuffer(source, destination)
copyBufferToBuffer(source, destination, size)
copyBufferToBuffer(source, sourceOffset, destination, destinationOffset, size)

Parameter

source: Der GPUBuffer, von dem kopiert werden soll.
sourceOffset Optional: Der Offset, in Bytes, ab dem im source mit dem Kopieren begonnen wird.
destination: Der GPUBuffer, in den kopiert werden soll.
destinationOffset Optional: Der Offset, in Bytes, ab dem im destination mit dem Kopieren begonnen wird.
size Optional: Die Anzahl der Bytes, die kopiert werden sollen.

Hinweis: Der sourceOffset und der destinationOffset können weggelassen werden, wenn Sie einen Teil des Quell-Puffers mit einem Offset von 0 in beiden Puffern kopieren. Der sourceOffset, destinationOffset und size können weggelassen werden, wenn Sie den gesamten Quell-Puffer in den Ziel-Puffer kopieren.

Rückgabewert

Keiner (undefined).

Validierung

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

Der GPUBuffer.usage des source enthält das GPUBufferUsage.COPY_SRC-Flag.
Der GPUBuffer.usage des destination enthält das GPUBufferUsage.COPY_DST-Flag.
size, sourceOffset und destinationOffset sind alle Vielfache von 4.
Die GPUBuffer.size des source ist größer oder gleich sourceOffset + size.
Die GPUBuffer.size des destination ist größer oder gleich destinationOffset + size.
source und destination sind verschiedene GPUBuffer (es kann nicht vom gleichen Puffer aus und in denselben Puffer kopiert werden).

Beispiele

In unserem Basis-Compute-Demo verwenden wir copyBufferToBuffer(), um den Inhalt unseres outputBuffer in den stagingBuffer zu kopieren.

// …

// Create an output buffer to read GPU calculations to, and a staging buffer to be mapped for JavaScript access

const outputBuffer = device.createBuffer({
  size: BUFFER_SIZE,
  usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
});

const stagingBuffer = device.createBuffer({
  size: BUFFER_SIZE,
  usage: GPUBufferUsage.MAP_READ | GPUBufferUsage.COPY_DST,
});

// …

// Create GPUCommandEncoder to encode commands to issue to the GPU
const commandEncoder = device.createCommandEncoder();

// …

// Copy output buffer to staging buffer
commandEncoder.copyBufferToBuffer(
  outputBuffer,
  0, // Source offset
  stagingBuffer,
  0, // Destination offset
  BUFFER_SIZE,
);

// Since we are copying the entire buffer, this can be shortened to
// commandEncoder.copyBufferToBuffer(outputBuffer, stagingBuffer);

// …

Spezifikationen

Spezifikation
WebGPU # dom-gpucommandencoder-copybuffertobuffer

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