GPUCommandEncoder: метод copyBufferToBuffer()

Метод copyBufferToBuffer() интерфейса GPUCommandEncoder кодирует команду, которая копирует данные из одного GPUBuffer в другой.

source

GPUBuffer, из которого производится копирование.

sourceOffset

Смещение в байтах внутри source, с которого начинается копирование.

destination

GPUBuffer, в который производится копирование.

destinationOffset

Смещение в байтах внутри destination, с которого начинается копирование.

size

Количество байтов для копирования.

None (Undefined).

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

• source включает флаг GPUBuffer.usage GPUBufferUsage.COPY_SRC.
• destination включает флаг GPUBuffer.usage GPUBufferUsage.COPY_DST.
• size, sourceOffset, и destinationOffset являются кратными 4.
• source GPUBuffer.size больше или равно sourceOffset + size.
• destination GPUBuffer.size больше или равно destinationOffset + size.
• source и destination являются различными GPUBuffer (копирование не может происходить из одного буфера в тот же буфер).

В нашем демо вычислений мы используем copyBufferToBuffer() для копирования содержимого буфера output в буфер stagingBuffer.

// ...

// Create an output buffer to read GPU calculations to, and a staging buffer to be mapped for JavaScript access

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

// ...

// Create GPUCommandEncoder to encode commands to issue to the GPU
const commandEncoder = device.createCommandEncoder();

// ...

// Copy output buffer to staging buffer
commandEncoder.copyBufferToBuffer(
  output,
  0, // Source offset
  stagingBuffer,
  0, // Destination offset
  BUFFER_SIZE,
);

// ...

• API WebGPU