GPUCommandEncoder: beginComputePass() Methode

Syntax

beginComputePass()
beginComputePass(descriptor)

Parameter

descriptor Optional

Ein Objekt, das die folgenden Eigenschaften enthlt:

label Optional

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

timestampWrites Optional

Ein Array von Objekten, das definiert, wo und wann Zeitstempel-Abfragewerte fr diesen Pass geschrieben werden. Diese Objekte haben die folgenden Eigenschaften:

querySet

Ein GPUQuerySet vom Typ "timestamp", in das die Ergebnisse der Zeitstempelabfrage geschrieben werden.

beginningOfPassWriteIndex

Eine Zahl, die den Abfrageindex in querySet angibt, an dem der Zeitstempel zu Beginn des Render-Passes geschrieben wird. Dies ist optional wenn nicht definiert, wird fr den Beginn des Passes kein Zeitstempel geschrieben.

endOfPassWriteIndex

Eine Zahl, die den Abfrageindex in querySet angibt, an dem der Zeitstempel am Ende des Render-Passes geschrieben wird. Dies ist optional wenn nicht definiert, wird fr das Ende des Passes kein Zeitstempel geschrieben.

Hinweis: Der timestamp-query Feature muss aktiviert sein, um Zeitstempelabfragen zu verwenden. Zeitstempelabfragewerte werden in Nanosekunden geschrieben, aber wie der Wert bestimmt wird, ist implementierungsabhngig.

Rckgabewert

Eine Instanz des GPUComputePassEncoder Objekts.

Validierung

Die folgenden Kriterien mssen erfllt sein, wenn beginComputePass() aufgerufen wird, andernfalls wird ein GPUValidationError erzeugt und ein ungltiger GPUComputePassEncoder zurckgegeben:

• Der timestamp-query Feature ist im GPUDevice aktiviert.

Beispiele

In unserem grundlegenden Compute-Demo werden mehrere Kommandos ber einen GPUCommandEncoder aufgenommen. Die meisten dieser Kommandos stammen vom GPUComputePassEncoder, der ber beginComputePass() erstellt wurde.

// 

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

// Initiate compute 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()]);

// 

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Die WebGPU API