GPURenderPassEncoder: метод setIndexBuffer()

Метод setIndexBuffer() интерфейса GPURenderPassEncoder устанавливает текущий GPUBuffer, который будет предоставлять данные индексов для последующих команд отрисовки.

buffer

A GPUBuffer представляющий буфер, содержащий данные индексов для последующих команд отрисовки.

indexFormat

Перечисление, определяющее формат данных индексов, содержащихся в buffer. Возможные значения:

• "uint16"
• "uint32"

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

Число, представляющее смещение в байтах внутри buffer, где начинаются данные индексов. Если опущено, offset по умолчанию равно 0.

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

Число, представляющее размер в байтах данных индексов, содержащихся в buffer. Если опущено, size по умолчанию равен размеру buffer, то есть GPUBuffer.size - offset.

Примечание к indexFormat

indexFormat определяет как тип данных значений индексов в буфере, так и, при использовании с конвейером, который определяет топологию примитива ("line-strip" или "triangle-strip"), также определяет значение перерыва примитива. Значение перерыва примитива – это значение индекса, указывающее, что следует начать новый примитив, а не продолжить построение полосы с предыдущими индексированными вершинами. Значение равно 0xFFFF для "uint16", или 0xFFFFFFFF для "uint32".

None (Undefined).

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

• buffer содержит флаг GPUBufferUsage.INDEX в GPUBuffer.usage.
• offset + size меньше или равно GPUBuffer.size buffer.
• offset кратно размеру в байтах indexFormat (2 для "uint16", 4 для "uint32").

В примере Shadow Mapping из WebGPU Samples setIndexBuffer() используется в двух отдельных проходах рендеринга в каждом кадре анимации, один для отрисовки основной модели и один для отрисовки её тени. Изучите пример кода для полного контекста.

// ...

const commandEncoder = device.createCommandEncoder();
{
  const shadowPass = commandEncoder.beginRenderPass(shadowPassDescriptor);
  shadowPass.setPipeline(shadowPipeline);
  shadowPass.setBindGroup(0, sceneBindGroupForShadow);
  shadowPass.setBindGroup(1, modelBindGroup);
  shadowPass.setVertexBuffer(0, vertexBuffer);
  shadowPass.setIndexBuffer(indexBuffer, "uint16");
  shadowPass.drawIndexed(indexCount);

  shadowPass.end();
}
{
  const renderPass = commandEncoder.beginRenderPass(renderPassDescriptor);
  renderPass.setPipeline(pipeline);
  renderPass.setBindGroup(0, sceneBindGroupForRender);
  renderPass.setBindGroup(1, modelBindGroup);
  renderPass.setVertexBuffer(0, vertexBuffer);
  renderPass.setIndexBuffer(indexBuffer, "uint16");
  renderPass.drawIndexed(indexCount);

  renderPass.end();
}

// ...

• The API WebGPU