GPUCommandEncoder: beginComputePass() Methode

descriptor Optional

Ein Objekt, das die folgenden Eigenschaften enthält:

label Optional

Ein Zeichenfolgenwert, der ein Label bereitstellt, das zur Identifikation des Objekts verwendet werden kann, beispielsweise in GPUError-Meldungen oder Konsolenwarnungen.

timestampWrites Optional

Ein Array von Objekten, die definieren, wo und wann Zeitstempel-Abfragewerte für diesen Durchlauf geschrieben werden. Diese Objekte haben die folgenden Eigenschaften:

• location: Ein enumerierter Wert, der angibt, wann der Zeitstempel ausgeführt wird. Verfügbare Werte sind:

  • "beginning": Der Zeitstempel wird zusammen mit den anderen kodierten Befehlen im Compute-Durchlauf ausgeführt, sobald der entsprechende GPUCommandBuffer übermittelt wird.
  • "end": Der Zeitstempel wird als Teil einer separaten Liste von Zeitstempel-Anhängen ausgeführt, sobald der Durchlauf endet.

• queryIndex: Eine Nummer, die die Indexposition im querySet angibt, an die der Zeitstempel geschrieben wird.

• querySet: Das GPUQuerySet, in das der Zeitstempel geschrieben wird.

Hinweis: Die timestamp-query Funktionalität muss aktiviert sein, um Zeitstempel-Abfragen zu verwenden.

Eine Instanz des GPUComputePassEncoder-Objekts.

Die folgenden Kriterien müssen beim Aufrufen von beginComputePass() erfüllt sein. Andernfalls wird ein GPUValidationError generiert und ein ungültiger GPUComputePassEncoder wird zurückgegeben:

• Die timestamp-query Funktionalität ist im GPUDevice aktiviert.
• Keine zwei timestampWrites-Objekte dürfen dieselbe location haben. Dies bedeutet, dass Sie effektive nur zwei Zeitstempel-Abfragen pro Renderdurchlauf ausführen können.
• Für jede Zeitstempel-Abfrage muss der querySet GPUQuerySet.type "timestamp" sein, und der queryIndex-Wert muss kleiner als die GPUQuerySet.count sein.

In unserem Grundlagen-Beispiel für Compute werden mehrere Befehle über einen GPUCommandEncoder aufgezeichnet. Die meisten dieser Befehle stammen aus dem über beginComputePass() erstellten GPUComputePassEncoder.

// ...

// Create GPUCommandEncoder to encode commands to issue to the GPU
const commandEncoder = device.createCommandEncoder();

// Initiate render pass
const passEncoder = commandEncoder.beginComputePass();

// Issue commands
passEncoder.setPipeline(computePipeline);
passEncoder.setBindGroup(0, bindGroup);
passEncoder.dispatchWorkgroups(Math.ceil(BUFFER_SIZE / 64));

// End the render pass
passEncoder.end();

// Copy output buffer to staging buffer
commandEncoder.copyBufferToBuffer(
  output,
  0, // Source offset
  stagingBuffer,
  0, // Destination offset
  BUFFER_SIZE,
);

// End frame by passing array of command buffers to command queue for execution
device.queue.submit([commandEncoder.finish()]);

// ...

• Die WebGPU API