GPUBuffer

Интерфейс GPUBuffer API WebGPU представляет собой блок памяти, который можно использовать для хранения исходных данных для использования в операциях GPU.

Экземпляр объекта GPUBuffer создаётся с помощью метода GPUDevice.createBuffer().

label Экспериментально

Строка, предоставляющая метку, которая может использоваться для идентификации объекта, например, в сообщениях GPUError или предупреждениях консоли.

mapState Экспериментально Только для чтения

Перечисление, представляющее состояние сопоставления GPUBuffer.

size Экспериментально Только для чтения

Число, представляющее длину выделения памяти GPUBuffer, в байтах.

usage Экспериментально Только для чтения

Битовые флаги, представляющие разрешенные способы использования GPUBuffer.

destroy() Экспериментально

Уничтожает GPUBuffer.

getMappedRange() Экспериментально

Возвращает ArrayBuffer, содержащий сопоставленное содержимое GPUBuffer в указанном диапазоне.

mapAsync() Экспериментально

Сопоставляет указанный диапазон GPUBuffer. Возвращает Promise, который разрешается, когда содержимое GPUBuffer готово для доступа с помощью GPUBuffer.getMappedRange().

unmap() Экспериментально

Отменяет сопоставление диапазона GPUBuffer, делая его содержимое снова доступным для использования GPU.

В нашем демо-примере вычислений мы создаём выходной буфер для чтения вычислений GPU и буфер буферизации для доступа JavaScript.

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

Позже, как только stagingBuffer содержит результаты вычислений GPU, комбинация методов GPUBuffer используется для чтения данных обратно в JavaScript, чтобы затем их можно было вывести в консоль:

• GPUBuffer.mapAsync() используется для сопоставления GPUBuffer для чтения.
• GPUBuffer.getMappedRange() используется для возврата ArrayBuffer, содержащего содержимое GPUBuffer.
• GPUBuffer.unmap() используется для отмены сопоставления GPUBuffer снова, как только мы прочитали содержимое в JavaScript, как это нужно.

// 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));

• API WebGPU