GPUQueue: submit() Methode

commandBuffers

Ein Array von GPUCommandBuffer-Objekten, die die zu verarbeitenden Befehle für die GPU enthalten. Das Array darf keine doppelten GPUCommandBuffer-Objekte enthalten — jedes kann nur einmal pro submit()-Aufruf übermittelt werden.

Keiner (Undefined).

Die folgenden Kriterien müssen erfüllt sein, wenn submit() aufgerufen wird, andernfalls wird ein GPUValidationError generiert und die GPUQueue wird ungültig:

• Das Array von GPUCommandBuffer-Objekten, auf das im submit()-Aufruf verwiesen wird, enthält keine Duplikate.
• Alle GPUBuffer-, GPUTexture- und GPUQuerySet-Objekte, die in den kodierten Befehlen verwendet werden, sind verfügbar, d.h. nicht unzugänglich (z. B. sind GPUBuffers unzugänglich, wenn sie derzeit gemappt sind) oder zerstört (mit der destroy()-Methode).
• Alle GPUExternalTexture-Objekte, die in den kodierten Befehlen verwendet werden, sind nicht abgelaufen (sie laufen automatisch kurz nach dem Import über importExternalTexture() ab).
• Wenn ein GPUQuerySet-Objekt, das in einem kodierten Befehl verwendet wird, von Typ "occlusion query" ist, wird es nicht bereits verwendet, außer von GPURenderPassEncoder.beginOcclusionQuery().

In unserem Grundlegendes Render-Demo werden eine Reihe von Befehlen über einen GPUCommandEncoder aufgezeichnet:

// …

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

// …

Die durch den GPUCommandEncoder kodierten Befehle werden mithilfe der GPUCommandEncoder.finish()-Methode in einem GPUCommandBuffer neu aufgezeichnet. Der Befehls-Puffer wird dann über einen submit()-Aufruf in die Warteschlange übergeben und ist bereit, von der GPU verarbeitet zu werden.

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

• Die WebGPU API