GPURenderPassEncoder: метод setVertexBuffer()

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

slot

Число, ссылающееся на слот буфера вершин, для которого нужно установить буфер вершин.

buffer

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

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

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

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

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

Ничего (Undefined).

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

• buffer содержит флаг GPUBufferUsage.VERTEX в GPUBuffer.usage.
• slot меньше или равно предельному значению GPUDevice для maxVertexBuffers (предел).
• offset + size меньше или равно размеру buffer GPUBuffer.size.
• offset кратно 4.

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

// ...

const renderPipeline = device.createRenderPipeline(pipelineDescriptor);

// Create GPUCommandEncoder to issue commands to the GPU
// Note: render pass descriptor, command encoder, etc. are destroyed after use, fresh one needed for each frame.
const commandEncoder = device.createCommandEncoder();

// Create GPURenderPassDescriptor to tell WebGPU which texture to draw into, then initiate render pass
const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: clearColor,
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
};

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

// Draw the triangle
passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.draw(3);

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

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

// ...

• The API WebGPU