GPURenderPassEncoder: setPipeline()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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 GPURenderPassEncoder-Schnittstelle setzt die GPURenderPipeline, die für nachfolgende Renderpass-Befehle verwendet werden soll.

Syntax

setPipeline(pipeline)

Parameter

pipeline: Die GPURenderPipeline, die für nachfolgende Renderpass-Befehle verwendet werden soll.

Validierung

Die folgenden Kriterien müssen erfüllt sein, wenn setPipeline() aufgerufen wird, andernfalls wird ein GPUValidationError generiert und der GPURenderPassEncoder wird ungültig:

Wenn die GPURenderPipeline die Tiefenkomponente des Tiefen-/Stencil-Anhangs beschreibt, ist depthReadOnly (wie im Deskriptor des auslösenden GPUCommandEncoder.beginRenderPass()-Aufrufs angegeben) true.
Wenn die GPURenderPipeline die Stencil-Komponente des Tiefen-/Stencil-Anhangs beschreibt, ist stencilReadOnly (wie im Deskriptor des auslösenden GPUCommandEncoder.beginRenderPass()-Aufrufs angegeben) true.

In unserem grundlegenden Render-Demo werden mehrere Befehle über einen GPUCommandEncoder aufgezeichnet. Die meisten dieser Befehle stammen von dem GPURenderPassEncoder, der über GPUCommandEncoder.beginRenderPass() erstellt wurde. setPipeline() wird an geeigneter Stelle aufgerufen, um die Render-Pipeline festzulegen.

// …

const renderPipeline = device.createRenderPipeline(pipelineDescriptor);

// Create GPUCommandEncoder to issue commands to the GPU
// Note: render pass descriptor, command encoder, etc. are destroyed after use, fresh one needed for each frame.
const commandEncoder = device.createCommandEncoder();

// Create GPURenderPassDescriptor to tell WebGPU which texture to draw into, then initiate render pass
const renderPassDescriptor = {
  colorAttachments: [
    {
      clearValue: clearColor,
      loadOp: "clear",
      storeOp: "store",
      view: context.getCurrentTexture().createView(),
    },
  ],
};

const passEncoder = commandEncoder.beginRenderPass(renderPassDescriptor);

// Draw the triangle
passEncoder.setPipeline(renderPipeline);
passEncoder.setVertexBuffer(0, vertexBuffer);
passEncoder.draw(3);

// End the render pass
passEncoder.end();

// End frame by passing array of command buffers to command queue for execution
device.queue.submit([commandEncoder.finish()]);

// …