GPUQueue: метод submit()

Метод submit() интерфейса GPUQueue планирует выполнение буферов команд, представленных одним или несколькими объектами GPUCommandBuffer, графическим процессором.

commandBuffers

Массив объектов GPUCommandBuffer, содержащих команды, которые должны быть добавлены в очередь для обработки графическим процессором. Массив не должен содержать дублирующих объектов GPUCommandBuffer — каждый из них может быть передан только один раз в вызове submit().

None (Undefined).

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

• Массив объектов GPUCommandBuffer, используемых в вызове submit(), не должен содержать дубликатов.
• Любые объекты GPUBuffer, GPUTexture и GPUQuerySet, используемые в закодированных командах, должны быть доступны для использования, т.е. не недоступны (GPUBuffer недоступны, если они в данный момент отображены) или уничтожены (с помощью метода destroy()).
• Любые объекты GPUExternalTexture, используемые в закодированных командах, не должны быть истекшими (они истекают автоматически вскоре после импорта через importExternalTexture()).
• Если объект GPUQuerySet, используемый в закодированной команде, является объектом запроса типа "occlusion", он не должен быть уже использован, за исключением использования в GPURenderPassEncoder.beginOcclusionQuery().

В нашем примере базового рендеринга несколько команд записываются с помощью 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