GPURenderBundleEncoder: метод setBindGroup()

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

`index`

Индекс, для которого устанавливается группа связей. Соответствует индексу `group` атрибута `group` в коде шейдера (`GPUShaderModule`), используемого в связанной конвейерной линии.

`bindGroup`

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

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

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

• Массивом чисел, указывающим различные смещения.
• Массивом `Uint32Array`, содержащим числа, указывающие смещения.

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

`dynamicOffsetsStart`

Число, указывающее смещение в элементах массива в `dynamicOffsets`, с которого начинаются данные динамических смещений.

`dynamicOffsetsLength`

Число, указывающее количество значений динамических смещений, которые будут считаны из `dynamicOffsets`.

None (`undefined`).

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

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

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

• `index` меньше или равно пределу `maxBindGroupIndex` устройства (предел).
• `index` совпадает с количеством записей в `bindGroupLayout` с установленным `dynamic`.
• Для `index` записей, где связанная `bindGroupLayout` имеет значение `uniform` (см. `createBindGroupLayout`), каждое число в `dynamicOffsets` является кратным пределу `maxUniformBufferOffsetAlignment` устройства (предел).
• Для `index` записей, где связанная `bindGroupLayout` имеет значение `storage` или `storageBuffer` (см. `createBindGroupLayout`), каждое число в `dynamicOffsets` является кратным пределу `maxStorageBufferOffsetAlignment` устройства (предел).
• Для каждой `index` записи, значение `offset` связанной `storageBuffer`, плюс значение `offset` соответствующего элемента макета, плюс соответствующее динамическое смещение, указанное в `dynamicOffsets`, меньше или равно пределу `maxStorageBufferOffset` связанной `storageBuffer`.

function recordRenderPass(passEncoder) {
  if (settings.dynamicOffsets) {
    passEncoder.setPipeline(dynamicPipeline);
  } else {
    passEncoder.setPipeline(pipeline);
  }
  passEncoder.setVertexBuffer(0, vertexBuffer);
  passEncoder.setBindGroup(0, timeBindGroup);
  const dynamicOffsets = [0];
  for (let i = 0; i < numTriangles; ++i) {
    if (settings.dynamicOffsets) {
      dynamicOffsets[0] = i * alignedUniformBytes;
      passEncoder.setBindGroup(1, dynamicBindGroup, dynamicOffsets);
    } else {
      passEncoder.setBindGroup(1, bindGroups[i]);
    }
    passEncoder.draw(3, 1, 0, 0);
  }
}

Данный фрагмент взят из примера Animometer в WebGPU Samples.

• API WebGPU