GPURenderPassEncoder: setPipeline()-Methode

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

Want more browser support for this feature? Tell us why.

Mehr erfahren
Vollständige Kompatibilität anzeigen

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 Render-Pass-Befehle verwendet wird.

Syntax

setPipeline(pipeline)

Parameter

pipeline: Die GPURenderPipeline, die für nachfolgende Render-Pass-Befehle verwendet wird.

Validierung

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

Wenn die GPURenderPipeline in die Tiefenkomponente des Tiefen/Stencil-Anhangs schreibt, ist depthReadOnly (wie im Deskriptor des ursprünglichen GPUCommandEncoder.beginRenderPass()-Aufrufs angegeben) true.
Wenn die GPURenderPipeline in die Stencil-Komponente des Tiefen/Stencil-Anhangs schreibt, ist stencilReadOnly (wie im Deskriptor des ursprünglichen GPUCommandEncoder.beginRenderPass()-Aufrufs angegeben) true.

In unserem Basis-Render-Demo werden mehrere Befehle über einen GPUCommandEncoder aufgezeichnet. Die meisten dieser Befehle stammen vom GPURenderPassEncoder, der über GPUCommandEncoder.beginRenderPass() erstellt wurde. setPipeline() wird an einer geeigneten 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()]);

// …