GPUComputePassEncoder: Methode setPipeline()

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.

Die setPipeline()-Methode der GPUComputePassEncoder-Schnittstelle legt die GPUComputePipeline fest, die für diesen Berechnungsvorgang verwendet werden soll.

Syntax

setPipeline(pipeline)

Parameter

pipeline: Die GPUComputePipeline, die für diesen Berechnungsvorgang verwendet werden soll.

In unserem einfachen Berechnungs-Demo werden mehrere Befehle über einen GPUCommandEncoder aufgezeichnet. Die meisten dieser Befehle stammen vom GPUComputePassEncoder, der via beginComputePass() erstellt wird. Der setPipeline()-Aufruf wird verwendet, um die für diesen Durchlauf zu verwendende Pipeline festzulegen.

const BUFFER_SIZE = 1000;

// ...

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

// ...

Spezifikationen

Specification
WebGPU # dom-gpucomputepassencoder-setpipeline

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch

Die WebGPU API