GPUDevice: метод createBuffer()

Метод createBuffer() интерфейса GPUDevice создаёт GPUBuffer, в котором хранятся исходные данные для использования в операциях с графическим процессором.

descriptor

Объект, содержащий следующие свойства:

label Необязательно

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

mappedAtCreation Необязательно

Булево значение. Если установлено в true, буфер будет отображён при создании, что означает, что вы можете установить значения внутри буфера немедленно, вызвав GPUBuffer.getMappedRange(). Значение по умолчанию - false.

Обратите внимание, что допустимо установить mappedAtCreation: true, чтобы вы могли задать начальные данные буфера, даже если флаги использования GPUBufferUsage.MAP_READ или GPUBufferUsage.MAP_WRITE не установлены.

size

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

usage

Битовые флаги, представляющие разрешённые способы использования GPUBuffer. Возможные значения находятся в таблице значений GPUBuffer.usage.

Обратите внимание, что несколько возможных способов использования можно указать, разделив значения символами «|», например:

usage: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE;

Экземпляр объекта GPUBuffer.

При вызове createBuffer() должны быть соблюдены следующие критерии; в противном случае генерируется GPUValidationError, и возвращается неверный объект GPUBuffer:

• Указан допустимый usage.
• Указан GPUBufferUsage.MAP_READ, и не указаны дополнительные флаги, кроме GPUBufferUsage.COPY_DST.
• Указан GPUBufferUsage.MAP_WRITE, и не указаны дополнительные флаги, кроме GPUBufferUsage.COPY_SRC.
• Указан mappedAtCreation: true, и указанный size кратен 4.

В нашем примере вычислений мы создаём буфер вывода для чтения вычислений графического процессора и буфер кэширования для отображения в 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,
});

• API WebGPU