DiecreateBuffer()-Methode desGPUDevice-Interfaces erstellt einGPUBuffer, in dem Rohdaten gespeichert werden, die in GPU-Operationen verwendet werden sollen.

Syntax

createBuffer(descriptor)

Parameter

descriptor

Ein Objekt, das die folgenden Eigenschaften enthält:

labelOptional

Ein String, der ein Label bereitstellt, das zur Identifizierung des Objekts verwendet werden kann, zum Beispiel inGPUError-Nachrichten oder Konsolenwarnungen.

mappedAtCreationOptional

Ein Boolean. Wenn auftrue gesetzt, wird der Buffer bei der Erstellung abgebildet, was bedeutet, dass Sie die Werte innerhalb des Buffers sofort festlegen können, indem SieGPUBuffer.getMappedRange() aufrufen. Der Standardwert istfalse.

Beachten Sie, dass es gültig ist,mappedAtCreation: true zu setzen, um die anfänglichen Daten des Buffers festzulegen, selbst wenn dieGPUBufferUsage.MAP_READ oderGPUBufferUsage.MAP_WRITE Nutzungsflags nicht gesetzt sind.

size

Eine Zahl, die die Größe des Buffers in Bytes darstellt. WennmappedAtCreation auftrue gesetzt ist, muss dies ein Vielfaches von4 sein.

usage

Diebitweisen Flags, die die erlaubten Nutzungen für denGPUBuffer darstellen. Die möglichen Werte sind in derGPUBuffer.usage Werte-Tabelle aufgeführt.

Beachten Sie, dass mehrere mögliche Nutzungen angegeben werden können, indem Werte mitbitwise OR getrennt werden, zum Beispiel:GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE.

Rückgabewert

EineGPUBuffer-Objektinstanz.

Ausnahmen

RangeErrorDOMException

Wird ausgelöst, wennmappedAtCreation auftrue gesetzt ist und die angegebenesize kein Vielfaches von4 ist.

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenncreateBuffer() aufgerufen wird. Andernfalls wird einGPUValidationError erzeugt und ein ungültigesGPUBuffer-Objekt zurückgegeben:

• Eine gültigeusage ist angegeben.
• GPUBufferUsage.MAP_READ ist angegeben, und es sind keine zusätzlichen Flags außerGPUBufferUsage.COPY_DST angegeben.
• GPUBufferUsage.MAP_WRITE ist angegeben, und es sind keine zusätzlichen Flags außerGPUBufferUsage.COPY_SRC angegeben.

Beispiele

In unseremgrundlegenden Berechnungs-Demo 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,});

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DieWebGPU API