DieGPUCommandEncoder-Schnittstelle derWebGPU API stellt einen Encoder dar, der eine Sequenz von GPU-Befehlen sammelt, die an die GPU gesendet werden sollen.

EineGPUCommandEncoder-Objektinstanz wird über die EigenschaftGPUDevice.createCommandEncoder() erstellt.

Instanzeigenschaften

label

Ein String, der ein Label bereitstellt, das verwendet werden kann, um das Objekt zu identifizieren, beispielsweise inGPUError-Meldungen oder Konsolenwarnungen.

Instanzmethoden

beginComputePass()

Beginnt die Kodierung eines Compute-Passes und gibt einenGPUComputePassEncoder zurück, der zur Steuerung der Berechnung verwendet werden kann.

beginRenderPass()

Beginnt die Kodierung eines Render-Passes und gibt einenGPURenderPassEncoder zurück, der zur Steuerung des Renderings verwendet werden kann.

clearBuffer()

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

copyBufferToBuffer()

Kodiert einen Befehl, der Daten von einemGPUBuffer in einen anderen kopiert.

copyBufferToTexture()

Kodiert einen Befehl, der Daten von einemGPUBuffer in eineGPUTexture kopiert.

copyTextureToBuffer()

Kodiert einen Befehl, der Daten von einerGPUTexture in einenGPUBuffer kopiert.

copyTextureToTexture()

Kodiert einen Befehl, der Daten von einerGPUTexture in eine andere kopiert.

finish()

Beendet die Aufzeichnung der auf diesemGPUCommandEncoder kodierten Befehlssequenz und gibt einen entsprechendenGPUCommandBuffer zurück.

insertDebugMarker()

Markiert einen bestimmten Punkt in einer Reihe von kodierten Befehlen mit einem Label.

popDebugGroup()

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

pushDebugGroup()

Beginnt eine Debug-Gruppe, die mit einem angegebenen Label markiert wird und alle folgenden kodierten Befehle bis zur AufrufmethodepopDebugGroup() enthält.

resolveQuerySet()

Kodiert einen Befehl, der einenGPUQuerySet auflöst und die Ergebnisse in einen angegebenenGPUBuffer kopiert.

writeTimestamp()Nicht standardisiertVeraltet

Kodiert einen Befehl, der einen Zeitstempel in einenGPUQuerySet schreibt, sobald die vorherigen Befehle, die in denselben in die Warteschlange gestelltenGPUCommandBuffer aufgezeichnet wurden, von der GPU ausgeführt wurden.

Beispiele

In unseremGrundlegenden Render-Demo werden mehrere Befehle über einenGPUCommandEncoder aufgezeichnet:

// …// Create GPUCommandEncoderconst commandEncoder = device.createCommandEncoder();// Create GPURenderPassDescriptor to tell WebGPU which texture to draw into, then initiate render passconst renderPassDescriptor = {  colorAttachments: [    {      clearValue: clearColor,      loadOp: "clear",      storeOp: "store",      view: context.getCurrentTexture().createView(),    },  ],};const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);// Draw a trianglepassEncoder.setPipeline(renderPipeline);passEncoder.setVertexBuffer(0, vertexBuffer);passEncoder.draw(3);// End the render passpassEncoder.end();// …

Die vomGPUCommandEncoder kodierten Befehle werden unter Verwendung der MethodeGPUCommandEncoder.finish() in einenGPUCommandBuffer aufgezeichnet. Der Befehlsbuffer wird dann über einen Aufruf vonsubmit() in die Warteschlange übergeben und kann von der GPU verarbeitet werden.

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

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DieWebGPU API