GPUComputePassEncoder: метод setBindGroup()

Метод setBindGroup() интерфейса GPUComputePassEncoder устанавливает GPUBindGroup для использования в последующих командах вычислений для заданного индекса.

index

Индекс, в котором будет установлен bind group. Он соответствует значению индекса n соответствующего @group(n) атрибута в коде шейдера (GPUShaderModule), используемом в связанной обработке.

bindGroup

GPUBindGroup для использования в последующих командах вычислений, или null, в этом случае любой ранее установленный bind group в данном слоте будет сброшен.

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

Значение, определяющее смещение в байтах для каждой записи в bindGroup при установке hasDynamicOffset: true (т.е. в описателе вызова GPUDevice.createBindGroupLayout(), создавшего объект GPUBindGroupLayout, на котором основан bindGroup). Это значение может быть:

• Массив чисел, определяющих различные смещения.
• Uint32Array, содержащий числа, определяющие смещения.

Если для dynamicOffsets указано значение Uint32Array, оба следующих параметра также требуются:

dynamicOffsetsStart

Число, определяющее смещение в элементах массива в dynamicOffsetsData, где начинаются данные динамического смещения.

dynamicOffsetsLength

Число, определяющее количество значений динамического смещения для чтения из dynamicOffsetsData.

None (Undefined).

Для вызовов setBindGroup(), использующих значение Uint32Array для dynamicOffsets, вызов выбросит исключение RangeError DOMException, если:

• dynamicOffsetsStart меньше 0.
• dynamicOffsetsStart + dynamicOffsetsLength больше, чем dynamicOffsets.length.

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

• index меньше или равно пределу maxBindGroups лимита устройства GPUDevice.
• dynamicOffsets.length совпадает с количеством записей в bindGroup с установленным hasDynamicOffset: true.
• Для записей bindGroup, где bound buffer имеет значение "uniform" (см. GPUDevice.createBindGroupLayout()), каждое число в dynamicOffsets кратно пределу minUniformBufferOffsetAlignment лимита устройства GPUDevice.
• Для записей bindGroup, где bound buffer имеет значение "storage" или "read-only-storage" (см. GPUDevice.createBindGroupLayout()), каждое число в dynamicOffsets кратно пределу minStorageBufferOffsetAlignment лимита устройства GPUDevice.
• Для каждой записи bindGroup, bound buffer плюс соответствующая запись в макете плюс соответствующее динамическое смещение, указанное в dynamicOffsets, меньше или равно size bound buffer.

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

const BUFFER_SIZE = 1000;

// ...

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