GPUCommandEncoder

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das GPUCommandEncoder-Interface der WebGPU API repräsentiert einen Befehlscodierer, der verwendet wird, um Befehle zu kodieren, die an die GPU gesendet werden sollen.

Eine GPUCommandEncoder-Objektinstanz wird über die GPUDevice.createCommandEncoder()-Eigenschaft erstellt.

Instanzeigenschaften

label Experimentell

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

Instanzmethoden

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.

Beispiele

In unserem grundlegenden Render-Demo werden mehrere Befehle über einen GPUCommandEncoder aufgezeichnet:

js
// ...

// 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.

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

Hinweis: Studieren Sie die WebGPU-Beispiele, um mehr Beispiele zur Befehlskodierung zu finden.

Spezifikationen

Specification
WebGPU
# gpucommandencoder

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
GPUCommandEncoder
Experimental
beginComputePass
Experimental
timestampWrites descriptor property
Experimental
beginRenderPass
Experimental
color attachment depthSlice option
Experimental
Set depthReadOnly and stencilReadOnly to true separately from one another.
Experimental
timestampWrites descriptor property
Experimental
clearBuffer
Experimental
copyBufferToBuffer
Experimental
copyBufferToTexture
Experimental
copyTextureToBuffer
Experimental
copyTextureToTexture
Experimental
finish
Experimental
insertDebugMarker
Experimental
label
Experimental
popDebugGroup
Experimental
pushDebugGroup
Experimental
resolveQuerySet
Experimental
writeTimestamp
DeprecatedNon-standard

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
In development. Supported in a pre-release version.
In development. Supported in a pre-release version.
No support
No support
Experimental. Expect behavior to change in the future.
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
User must explicitly enable this feature.
Has more compatibility info.

Siehe auch