DiebeginComputePass() Methode derGPUCommandEncoder-Schnittstelle startet die Kodierung eines Compute-Passes und gibt einenGPUComputePassEncoder zurück, der zur Steuerung der Berechnung verwendet werden kann.

Syntax

beginComputePass()beginComputePass(descriptor)

Parameter

descriptorOptional

Ein Objekt mit den folgenden Eigenschaften:

labelOptional

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

timestampWritesOptional

Ein Array von Objekten, das definiert, wo und wann Zeitstempelabfrage-Werte für diesen Pass geschrieben werden. Diese Objekte haben die folgenden Eigenschaften:

querySet

EinGPUQuerySet vom Typ"timestamp", zu dem die Ergebnisse der Zeitstempelabfrage geschrieben werden.

beginningOfPassWriteIndex

Eine Zahl, die den Abfrageindex inquerySet angibt, an dem der Zeitstempel zu Beginn des Render-Passes geschrieben wird. Dies ist optional - wenn nicht definiert, wird kein Zeitstempel für den Beginn des Passes geschrieben.

endOfPassWriteIndex

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

Hinweis:Dastimestamp-queryFeature muss aktiviert sein, um Zeitstempelabfragen zu verwenden. Zeitstempelabfrage-Werte werden in Nanosekunden geschrieben, aber wie der Wert ermittelt wird, ist implementationsspezifisch.

Rückgabewert

EinGPUComputePassEncoder-Objektinstanz.

Validierung

Die folgenden Kriterien müssen beim Aufruf vonbeginComputePass() erfüllt sein, andernfalls wird einGPUValidationError erzeugt und ein ungültigerGPUComputePassEncoder zurückgegeben:

• Dastimestamp-queryFeature ist imGPUDevice aktiviert.

Beispiele

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

// …// Create GPUCommandEncoder to encode commands to issue to the GPUconst commandEncoder = device.createCommandEncoder();// Initiate render passconst passEncoder = commandEncoder.beginComputePass();// Issue commandspassEncoder.setPipeline(computePipeline);passEncoder.setBindGroup(0, bindGroup);passEncoder.dispatchWorkgroups(Math.ceil(BUFFER_SIZE / 64));// End the render 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