GPUComputePassEncoder：setPipeline() 方法

实验性： 这是一个实验性技术
在生产环境中使用之前，请仔细查看浏览器兼容性表。

安全上下文：此功能仅在安全上下文 (HTTPS) 中可用，在一些或所有支持的浏览器中可用。

GPUComputePassEncoder 接口的 setPipeline() 方法设置 GPUComputePipeline，以用于此计算传递。

语法

setPipeline(pipeline)

参数

pipeline: 用于此计算传递的 GPUComputePipeline。

返回值

无 (Undefined).

示例

在我们的基本计算演示中，多个命令通过 GPUCommandEncoder 记录。这些命令中的大多数来自通过 beginComputePass() 创建的 GPUComputePassEncoder。setPipeline() 调用在适当的情况下用于设置用于此传递的管道。

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

// ...

规范

规范
WebGPU # dom-gpucomputepassencoder-setpipeline

浏览器兼容性

BCD 表仅在浏览器中加载

另请参见

The WebGPU API