GPUCommandEncoder

label Experimentell

Ein String, der eine Bezeichnung bereitstellt, die verwendet werden kann, um das Objekt zu identifizieren, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

beginComputePass() Experimentell

Beginnt mit der Kodierung eines Compute-Passes und gibt einen GPUComputePassEncoder zurück, der zur Steuerung der Berechnung verwendet werden kann.

beginRenderPass() Experimentell

Beginnt mit der Kodierung eines Render-Passes und gibt einen GPURenderPassEncoder zurück, der zur Steuerung der Darstellung verwendet werden kann.

clearBuffer() Experimentell

Kodiert einen Befehl, der einen Bereich eines GPUBuffer mit Nullen füllt.

copyBufferToBuffer() Experimentell

Kodiert einen Befehl, der Daten von einem GPUBuffer zu einem anderen kopiert.

copyBufferToTexture() Experimentell

Kodiert einen Befehl, der Daten von einem GPUBuffer zu einer GPUTexture kopiert.

copyTextureToBuffer() Experimentell

Kodiert einen Befehl, der Daten von einer GPUTexture zu einem GPUBuffer kopiert.

copyTextureToTexture() Experimentell

Kodiert einen Befehl, der Daten von einer GPUTexture zu einer anderen kopiert.

finish() Experimentell

Schließt die Aufzeichnung der Befehlssequenz ab, die auf diesem GPUCommandEncoder kodiert wurde, und gibt ein entsprechendes GPUCommandBuffer zurück.

insertDebugMarker() Experimentell

Markiert einen spezifischen Punkt in einer Serie von kodierten Befehlen mit einer Bezeichnung.

popDebugGroup() Experimentell

Beendet eine Debug-Gruppe, die mit einem Aufruf von pushDebugGroup() begonnen wurde.

pushDebugGroup() Experimentell

Beginnt eine Debug-Gruppe, die mit einer spezifischen Bezeichnung markiert wird und alle nachfolgenden kodierten Befehle bis zur Ausführung einer popDebugGroup()-Methode enthält.

resolveQuerySet() Experimentell

Kodiert einen Befehl, der einen GPUQuerySet auflöst und die Ergebnisse in einen angegebenen GPUBuffer kopiert.

writeTimestamp() Nicht standardisiert Veraltet

Kodiert einen Befehl, der einen Zeitstempel in ein GPUQuerySet schreibt, sobald die vorhergehenden Befehle, die in den gleichen GPUCommandBuffer eingereiht wurden, von der GPU ausgeführt wurden.

In unserem grundlegenden Render-Demo werden mehrere Befehle ü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 von dem GPUCommandEncoder kodierten Befehle werden mithilfe der Methode GPUCommandEncoder.finish() in einem GPUCommandBuffer aufgezeichnet. Der Befehlsbuffer wird dann über einen submit()-Aufruf in die Warteschlange übergeben, bereit zur Verarbeitung durch die GPU.

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

• Die WebGPU API