GPUComputePassEncoder

Интерфейс GPUComputePassEncoder API WebGPU кодирует команды, связанные с управлением этапом вычислений (compute shader), выпущенные GPUComputePipeline. Он является частью общей кодировочной активности GPUCommandEncoder.

Вычислительная схема содержит один вычислительный этап, на котором вычислительный шейдер принимает общие данные, обрабатывает их параллельно по указанному количеству рабочих групп, а затем возвращает результат в один или несколько буферов.

Экземпляр объекта GPUComputePassEncoder создаётся с помощью свойства GPUCommandEncoder.beginComputePass().

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

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

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

Отправляет конкретную сетку рабочих групп для выполнения работы, выполняемой текущим GPUComputePipeline.

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

Отправляет сетку рабочих групп, определённую параметрами GPUBuffer, для выполнения работы, выполняемой текущим GPUComputePipeline.

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

Завершает запись текущей последовательности команд вычислительного прохода.

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

Помечает определённую точку в ряду закодированных команд меткой.

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

Завершает группу отладки, которая начинается вызовом pushDebugGroup().

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

Начинает группу отладки, которая помечена указанной меткой и будет содержать все последующие закодированные команды до вызова метода popDebugGroup().

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

Устанавливает GPUBindGroup для использования в последующих вычислительных командах для данного индекса.

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

Устанавливает GPUComputePipeline для использования в этом вычислительном проходе.

В нашем базовом примере вычислений несколько команд записываются через GPUCommandEncoder. Большинство из этих команд исходят от GPUComputePassEncoder, созданного с помощью GPUCommandEncoder.beginComputePass().

// ...

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

// Create GPUComputePassEncoder to initiate compute pass
const passEncoder = commandEncoder.beginComputePass();

// Issue commands
passEncoder.setPipeline(computePipeline);
passEncoder.setBindGroup(0, bindGroup);
passEncoder.dispatchWorkgroups(Math.ceil(BUFFER_SIZE / 64));

// End the compute pass
passEncoder.end();

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

// End frame by passing array of command buffers to command queue for execution
device.queue.submit([commandEncoder.finish()]);

// ...

• The WebGPU API