DieGPUComputePassEncoder-Schnittstelle derWebGPU-API kodiert Befehle, die mit der Steuerung der Compute-Shader-Phase verbunden sind und von einerGPUComputePipeline ausgegeben werden. Sie ist Teil der umfassenden Kodierungsaktivität einesGPUCommandEncoder.

Eine Compute-Pipeline enthält eine einzelne Compute-Stufe, in der ein Compute-Shader allgemeine Daten verarbeitet, diese parallel über eine festgelegte Anzahl von Arbeitsgruppen verarbeitet und das Ergebnis in einem oder mehreren Puffern zurückgibt.

EinGPUComputePassEncoder-Objekt wird über dieGPUCommandEncoder.beginComputePass()-Eigenschaft erstellt.

Instanz-Eigenschaften

label

Ein String, der ein Label zur Verfügung stellt, das zur Identifizierung des Objekts verwendet werden kann, beispielsweise inGPUError-Meldungen oder Konsolenwarnungen.

Instanz-Methoden

dispatchWorkgroups()

Sendet ein spezifisches Raster von Arbeitsgruppen, um die Arbeit zu erledigen, die von der aktuellenGPUComputePipeline durchgeführt wird.

dispatchWorkgroupsIndirect()

Sendet ein Raster von Arbeitsgruppen, definiert durch die Parameter einesGPUBuffer, um die Arbeit der aktuellenGPUComputePipeline auszuführen.

end()

Beendet die Aufzeichnung der aktuellen Compute-Pass-Befehlssequenz.

insertDebugMarker()

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

popDebugGroup()

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

pushDebugGroup()

Beginnt eine Debug-Gruppe, die mit einem angegebenen Label markiert wird und alle nachfolgenden kodierten Befehle bis zu einerpopDebugGroup()-Methode enthält.

setBindGroup()

Stellt dieGPUBindGroup ein, die für die folgenden Compute-Befehle für einen gegebenen Index verwendet werden soll.

setPipeline()

Stellt dieGPUComputePipeline ein, die für diesen Compute-Pass verwendet werden soll.

Beispiele

In unserembasischen Compute-Demo werden mehrere Befehle über einenGPUCommandEncoder aufgezeichnet. Die meisten dieser Befehle stammen von demGPUComputePassEncoder, der überGPUCommandEncoder.beginComputePass() erstellt wurde.

// …// Create GPUCommandEncoder to encode commands to issue to the GPUconst commandEncoder = device.createCommandEncoder();// Create GPUComputePassEncoder to initiate compute passconst passEncoder = commandEncoder.beginComputePass();// Issue commandspassEncoder.setPipeline(computePipeline);passEncoder.setBindGroup(0, bindGroup);passEncoder.dispatchWorkgroups(Math.ceil(BUFFER_SIZE / 64));// End the compute passpassEncoder.end();// Copy output buffer to staging buffercommandEncoder.copyBufferToBuffer(  output,  0, // Source offset  stagingBuffer,  0, // Destination offset  BUFFER_SIZE,);// End frame by passing array of command buffers to command queue for executiondevice.queue.submit([commandEncoder.finish()]);// …

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DieWebGPU-API