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, bevor Sie diese produktiv verwenden.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

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

Syntax

js
setPipeline(pipeline)

Parameter

pipeline

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

Rückgabewert

Keiner (Undefined).

Beispiele

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.

js
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