GPUDevice: createRenderPipelineAsync()-Methode

descriptor

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

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

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

• Wenn dies aufgrund eines internen Fehlers geschieht, wird der GPUPipelineError einen reason von "internal" haben.
• Wenn dies aufgrund eines Validierungsfehlers geschieht, wird der GPUPipelineError einen reason von "validation" haben.

Ein Validierungsfehler kann auftreten, wenn eines der folgenden falsch ist:

• Für depthStencil-Objekte:
  • format ist ein depth-or-stencil Format.
  • Die Eigenschaften depthBias, depthBiasClamp und depthBiasSlopeScale sind auf 0 gesetzt für Linien- und Punkt-Topologien, 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 der maxColorAttachments Limit des GPUDevice.
  • Für jedes target ist das numerische Äquivalent von writeMask weniger als 16.
  • Wenn eine der verwendeten Blendfaktor-Operationen den Quell-Alpha-Kanal nutzt (z. B. "src-alpha-saturated"), hat das Ausgangsobjekt einen Alpha-Kanal (das heißt, es muss ein vec4 sein).
  • Wenn die entryPoint-Eigenschaft weggelassen wird, enthält der Shader-Code eine einzige Fragment-Shader-Einstiegspunktfunktion, die vom Browser als Standard-Einstiegspunkt verwendet werden kann.
• Für primitive-Objekte:
  • Wenn die unclippedDepth-Eigenschaft verwendet wird, ist die depth-clip-control Funktion aktiviert.
• Für vertex-Objekte:
  • Wenn die entryPoint-Eigenschaft weggelassen wird, enthält der Shader-Code eine einzige Vertex-Shader-Einstiegspunktfunktion, die vom Browser als Standard-Einstiegspunkt verwendet werden kann.

Das folgende Beispiel zeigt ein einfaches Beispiel für die Konstruktion eines gültigen Render-Pipeline-Deskriptor-Objekts, 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