GPUCommandEncoder

Интерфейс GPUCommandEncoder API WebGPU представляет собой кодировщик команд, используемый для кодирования команд, которые будут выданы графическому процессору (GPU).

Экземпляр объекта GPUCommandEncoder создаётся через свойство GPUDevice.createCommandEncoder().

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

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

beginComputePass() Экспериментальная

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

beginRenderPass() Экспериментальная

Начинает кодирование прохода отрисовки, возвращая GPURenderPassEncoder, который может быть использован для управления отрисовкой.

clearBuffer() Экспериментальная

Кодирует команду, которая заполняет область GPUBuffer нулями.

copyBufferToBuffer() Экспериментальная

Кодирует команду, которая копирует данные из одного GPUBuffer в другой.

copyBufferToTexture() Экспериментальная

Кодирует команду, которая копирует данные из GPUBuffer в GPUTexture.

copyTextureToBuffer() Экспериментальная

Кодирует команду, которая копирует данные из GPUTexture в GPUBuffer.

copyTextureToTexture() Экспериментальная

Кодирует команду, которая копирует данные из одного GPUTexture в другой.

finish() Экспериментальная

Завершает запись последовательности команд, закодированных в этом GPUCommandEncoder, возвращая соответствующий GPUCommandBuffer.

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

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

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

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

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

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

resolveQuerySet() Экспериментальная

Кодирует команду, которая разрешает GPUQuerySet, копируя результаты в указанный GPUBuffer.

writeTimestamp() Нестандартный Устаревший

Кодирует команду, которая записывает отметку времени в GPUQuerySet после выполнения предыдущих команд, записанных в ту же очередь GPUCommandBuffer, графическим процессором.

В нашем демо базовой отрисовки несколько команд записываются через GPUCommandEncoder:

// ...

// Create GPUCommandEncoder
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 a triangle

passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.draw(3);

// End the render pass

passEncoder.end();

// ...

Команды, закодированные GPUCommandEncoder перекодируются в GPUCommandBuffer с помощью метода GPUCommandEncoder.finish(). Затем буфер команд передаётся в очередь с помощью вызова submit(), готовый к обработке графическим процессором.

device.queue.submit([commandEncoder.finish()]);

• API WebGPU