GPUCommandEncoder: метод beginComputePass()

Метод beginComputePass() интерфейса GPUCommandEncoder начинает кодирование вычислительного пасса, возвращая GPUComputePassEncoder, который может использоваться для управления вычислениями.

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

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

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

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

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

Массив объектов, определяющих, где и когда будут записаны значения запросов отметки времени для этого пасса. Эти объекты имеют следующие свойства:

• location: Перечисление, указывающее, когда будет выполнена отметка времени. Доступные значения:
  • "beginning": Отметка времени выполняется вместе с другими закодированными командами в вычислительном пассе после отправки соответствующего GPUCommandBuffer.
  • "end": Отметка времени выполняется как часть отдельного списка прикреплений отметки времени по завершении пасса.
• queryIndex: Число, указывающее индексную позицию в querySet, в которую будет записана отметка времени.
• querySet: GPUQuerySet, в который будет записана отметка времени.

Примечание: Для использования запросов отметки времени необходимо включить функцию timestamp-query.

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

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

• Функция timestamp-query из GPUDevice должна быть включена.
• Ни у двух объектов timestampWrites не должно быть одинакового значения location.. Это означает, что вы можете запускать только две запросы отметки времени за один проход рендеринга.
• Для каждого запроса отметки времени тип GPUQuerySet.type querySet должен быть "timestamp", а значение queryIndex должно быть меньше значения GPUQuerySet.count.

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

// ...

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

// Initiate render pass
const passEncoder = commandEncoder.beginComputePass();

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

// End the render 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()]);

// ...

• API WebGPU