GPUDevice: createRenderPipelineAsync() Methode

descriptor

Siehe die Beschreibung des Deskriptors für die Methode GPUDevice.createRenderPipeline().

Ein Promise, das mit einer GPURenderPipeline-Objektinstanz erfüllt wird, wenn die erstellte Pipeline bereit ist, ohne zusätzliche Verzögerung genutzt zu werden.

Falls die Erstellung der Pipeline fehlschlägt und die resultierende Pipeline daher ungültig wird, wird das zurückgegebene Promise mit einem GPUPipelineError abgelehnt:

• Bei einem internen Fehler wird der GPUPipelineError einen reason von "internal" haben.
• Bei einem Validierungsfehler wird der GPUPipelineError einen reason von "validation" haben.

Ein Validierungsfehler kann auftreten, wenn eines der folgenden Kriterien nicht erfüllt ist:

• Für depthStencil-Objekte:
  • format ist ein depth-or-stencil-Format.
  • Die Eigenschaften depthBias, depthBiasClamp und depthBiasSlopeScale sind für Linien- und Punkt-Topologien auf 0 gesetzt, d.h., wenn topology auf "line-list", "line-strip" oder "point-list" gesetzt ist.
  • Wenn depthWriteEnabled true ist oder depthCompare nicht "always" ist, hat format eine Tiefenkomponente.
  • Wenn die Eigenschaften von stencilFront oder stencilBack nicht auf ihren Standardwerten sind, hat format eine Stencil-Komponente.
• Für fragment-Objekte:
  • targets.length ist kleiner oder gleich dem maxColorAttachments Limit des GPUDevice.
  • Für jedes target ist das numerische Äquivalent von writeMask kleiner als 16.
  • Wenn irgendeine der verwendeten Blend-Faktor-Operationen den Quell-Alpha-Kanal nutzt (zum Beispiel "src-alpha-saturated"), muss das Ergebnis einen Alpha-Kanal haben (das heißt, es muss ein vec4 sein).

Das folgende Beispiel zeigt ein einfaches Beispiel für die Konstruktion eines gültigen Render-Pipeline-Beschreibungsobjekts, das dann verwendet wird, um eine GPURenderPipeline über einen createRenderPipelineAsync()-Aufruf zu erstellen.

async function init() {
  // ...

  const vertexBuffers = [
    {
      attributes: [
        {
          shaderLocation: 0, // position
          offset: 0,
          format: "float32x4",
        },
        {
          shaderLocation: 1, // color
          offset: 16,
          format: "float32x4",
        },
      ],
      arrayStride: 32,
      stepMode: "vertex",
    },
  ];

  const pipelineDescriptor = {
    vertex: {
      module: shaderModule,
      entryPoint: "vertex_main",
      buffers: vertexBuffers,
    },
    fragment: {
      module: shaderModule,
      entryPoint: "fragment_main",
      targets: [
        {
          format: navigator.gpu.getPreferredCanvasFormat(),
        },
      ],
    },
    primitive: {
      topology: "triangle-list",
    },
    layout: "auto",
  };

  const renderPipeline =
    await device.createRenderPipelineAsync(pipelineDescriptor);

  // ...
}

• Die WebGPU API