GPUQueue: writeBuffer()-Methode

Syntax

writeBuffer(buffer, bufferOffset, data, dataOffset, size)

Parameter

buffer

Ein GPUBuffer-Objekt, das den Puffer repräsentiert, in den die Daten geschrieben werden sollen.

bufferOffset

Eine Zahl, die den Versatz in Bytes darstellt, bei dem mit dem Schreiben der Daten innerhalb des GPUBuffer begonnen werden soll.

data

Ein Objekt, das die Datenquelle repräsentiert, die in den GPUBuffer geschrieben werden soll. Dies kann ein ArrayBuffer, TypedArray oder DataView sein.

dataOffset Optional

Eine Zahl, die den Versatz angibt, ab dem die Daten innerhalb der Datenquelle geschrieben werden sollen. Dieser Wert ist eine Anzahl von Elementen, wenn data ein TypedArray ist, und eine Anzahl von Bytes, wenn nicht. Wenn weggelassen, wird dataOffset auf 0 gesetzt.

size Optional

Eine Zahl, die die Größe des Inhalts repräsentiert, der von data in den buffer geschrieben werden soll. Dieser Wert ist eine Anzahl von Elementen, wenn data ein TypedArray ist, und eine Anzahl von Bytes, wenn nicht. Wenn weggelassen, entspricht size der Gesamtgröße von data, abzüglich dataOffset.

Rückgabewert

Keiner (Undefined).

Ausnahmen

OperationError DOMException

Die Methode wirft einen OperationError, wenn die folgenden Kriterien nicht erfüllt sind:

• Die Größe von data ist gleich oder größer als 0.
• dataOffset ist gleich oder kleiner als die Größe von data.
• Die Größe von data (wenn sie in Bytes umgewandelt wird, im Fall von TypedArrays) ist ein Vielfaches von 4.

Validierung

Die folgenden Kriterien müssen beim Aufruf von writeBuffer() erfüllt sein, andernfalls wird ein GPUValidationError generiert und die GPUQueue wird ungültig:

• buffer ist zur Verwendung verfügbar, d.h. nicht nicht verfügbar (GPUBuffers sind nicht verfügbar, wenn sie gerade gemappt oder mit der Methode GPUBuffer.destroy() zerstört wurden).
• Die GPUBuffer.usage von buffer enthält das GPUBufferUsage.COPY_DST-Flag.
• bufferOffset, wenn in Bytes umgewandelt, ist ein Vielfaches von 4.
• Die Größe von data - dataOffset + bufferOffset, wenn in Bytes umgewandelt, ist gleich oder kleiner als die GPUBuffer.size des buffer.

Beispiele

In unserem grundlegenden Render-Demo definieren wir einige Vertex-Daten in einem Float32Array, die wir verwenden werden, um ein Dreieck zu zeichnen:

const vertices = new Float32Array([
  0.0, 0.6, 0, 1, 1, 0, 0, 1, -0.5, -0.6, 0, 1, 0, 1, 0, 1, 0.5, -0.6, 0, 1, 0,
  0, 1, 1,
]);

Um diese Daten in einer Render-Pipeline zu verwenden, müssen wir sie in einen GPUBuffer einfügen. Zuerst erstellen wir den Puffer:

const vertexBuffer = device.createBuffer({
  size: vertices.byteLength, // make it big enough to store vertices in
  usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
});

Um die Daten in den Puffer zu bekommen, können wir writeBuffer() verwenden:

device.queue.writeBuffer(vertexBuffer, 0, vertices, 0, vertices.length);

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Die WebGPU API