GPUBuffer

Die GPUBuffer-Schnittstelle der WebGPU API repräsentiert einen Speicherblock, der verwendet werden kann, um rohe Daten zu speichern, die in GPU-Operationen verwendet werden.

Eine GPUBuffer-Objektinstanz wird mit der Methode GPUDevice.createBuffer() erstellt.

Instanzeigenschaften

label

Ein String, der ein Etikett bereitstellt, das verwendet werden kann, um das Objekt zu identifizieren, zum Beispiel in GPUError-Meldungen oder Konsolenwarnungen.

mapState Schreibgeschützt

Ein enumerierter Wert, der den abgebildeten Zustand des GPUBuffer darstellt.

size Schreibgeschützt

Eine Zahl, die die Länge der Speicherzuweisung des GPUBuffer in Bytes darstellt.

usage Schreibgeschützt

Die Bitweise-Flags, die die erlaubten Verwendungen des GPUBuffer darstellen.

Instanzmethoden

destroy()

Zerstört den GPUBuffer.

getMappedRange()

Gibt einen ArrayBuffer zurück, der die abgebildeten Inhalte des GPUBuffer im angegebenen Bereich enthält.

mapAsync()

Bildet den angegebenen Bereich des GPUBuffer ab. Gibt ein Promise zurück, das gelöst wird, wenn der Inhalt des GPUBuffer bereit ist, mit GPUBuffer.getMappedRange() zugegriffen zu werden.

unmap()

Hebt die Abbildung des abgebildeten Bereichs des GPUBuffer auf, damit sein Inhalt wieder von der GPU verwendet werden kann.

Beispiele

In unserem grundlegenden Berechnungsbeispiel erstellen wir einen Ausgabepuffer, um GPU-Berechnungen zu lesen, und einen Staging-Puffer, der für den Zugriff durch JavaScript abgebildet wird.

const output = 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,
});

Später, sobald der stagingBuffer die Ergebnisse der GPU-Berechnung enthält, wird eine Kombination von GPUBuffer-Methoden verwendet, um die Daten zurück an JavaScript zu lesen, damit sie in der Konsole protokolliert werden können:

• GPUBuffer.mapAsync() wird verwendet, um den GPUBuffer zum Lesen abzubilden.
• GPUBuffer.getMappedRange() wird verwendet, um einen ArrayBuffer zurückzugeben, der den Inhalt des GPUBuffer enthält.
• GPUBuffer.unmap() wird verwendet, um den GPUBuffer wieder aufzuheben, sobald wir den Inhalt nach Bedarf in JavaScript gelesen haben.

// map staging buffer to read results back to JS
await stagingBuffer.mapAsync(
 GPUMapMode.READ,
 0, // Offset
 BUFFER_SIZE, // Length
);
const copyArrayBuffer = stagingBuffer.getMappedRange(0, BUFFER_SIZE);
const data = copyArrayBuffer.slice(0);
stagingBuffer.unmap();
console.log(new Float32Array(data));

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die WebGPU API