GPURenderPassEncoder

Интерфейс GPURenderPassEncoder API WebGPU кодирует команды, связанные с управлением стадиями вершинного и фрагментного шейдеров, как указано GPURenderPipeline. Это часть общей кодировочной активности GPUCommandEncoder.

Рендерная трубка рендерит графику на GPUTexture привязках, как правило, предназначенных для отображения в элементе <canvas>, но она также может рендерить на текстуры, используемые для других целей, которые никогда не отображаются на экране. Она имеет две основные стадии:

• Стадия вершины, в которой шейдер вершин получает данные о позиционировании, подаваемые на GPU, и использует их для позиционирования ряда вершин в 3D-пространстве, применяя указанные эффекты, такие как вращение, перемещение или перспектива. Затем вершины собираются в примитивы, такие как треугольники (основной строительный блок рендерированной графики), и растрируются GPU, чтобы определить, какие пиксели должен охватывать каждый из них на холсте рисования.

• Стадия фрагмента, в которой шейдер фрагмента вычисляет цвет каждого пикселя, покрываемого примитивами, произведёнными шейдером вершин. Эти вычисления часто используют такие входные данные, как изображения (в виде текстур), которые обеспечивают детали поверхности, а также положение и цвет виртуальных источников света.

Экземпляр объекта GPURenderPassEncoder создается с помощью свойства GPUCommandEncoder.beginRenderPass().

label Экспериментально

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

beginOcclusionQuery() Экспериментальное

Начинает запрос на непрозрачность в указанном индексе соответствующего GPUQuerySet (предоставлен в качестве значения свойства дескриптора occlusionQuerySet, при вызове GPUCommandEncoder.beginRenderPass() для запуска прохода отрисовки).

draw() Экспериментальное

Отрисовывает примитивы на основе буферов вершин, предоставленных setVertexBuffer().

drawIndexed() Экспериментальное

Отрисовывает примитивы с индексами, используя буферы вершин и индексов, предоставленные setVertexBuffer() и setIndexBuffer().

drawIndirect() Экспериментальное

Отрисовывает примитивы, используя параметры, считанные из GPUBuffer.

drawIndexedIndirect() Экспериментальное

Отрисовывает примитивы с индексами, используя параметры, считанные из GPUBuffer.

end() Экспериментальное

Завершает запись текущей последовательности команд прохода отрисовки.

endOcclusionQuery() Экспериментальное

Завершает активный запрос на непрозрачность, ранее начатый с помощью beginOcclusionQuery().

executeBundles() Экспериментальное

Выполняет команды, ранее записанные в указанные GPURenderBundle, как часть этого прохода отрисовки.

insertDebugMarker() Экспериментальное

Помечает определенную точку в серии закодированных команд меткой.

popDebugGroup() Экспериментальное

Завершает группу отладки, начатую вызовом pushDebugGroup().

pushDebugGroup() Экспериментальное

Начинает группу отладки, которая помечается указанной меткой и будет содержать все последующие закодированные команды до вызова метода popDebugGroup().

setBindGroup() Экспериментальное

Устанавливает GPUBindGroup для использования в последующих командах отрисовки для данного индекса.

setBlendConstant() Экспериментальное

Устанавливает постоянные значения цвета и альфы смешивания, используемые с факторами смешивания "constant" и "one-minus-constant" (установленными в описании метода GPUDevice.createRenderPipeline() в свойстве blend).

setIndexBuffer() Экспериментальное

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

setPipeline() Экспериментальное

Устанавливает GPURenderPipeline для использования в этом проходе отрисовки.

setScissorRect() Экспериментальное

Устанавливает прямоугольник обрезки, используемый во время стадии растрирования. После преобразования в координаты области видимости все фрагменты, которые выходят за пределы прямоугольника обрезки, будут отброшены.

setStencilReference() Экспериментальное

Устанавливает значение ссылки на значение маски, используемое во время проверок маски с операцией маски "replace" (как указано в описании метода GPUDevice.createRenderPipeline() в свойствах, определяющих различные операции маски).

setVertexBuffer() Экспериментальное

Устанавливает или отменяет установку текущего GPUBuffer, который будет предоставлять данные вершин для последующих команд отрисовки.

setViewport() Экспериментальное

Устанавливает область видимости, используемую во время стадии растрирования, для линейного отображения от нормированных координат устройства к координатам области видимости.

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

// ...

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()]);

// ...

• API WebGPU