DiecreateComputePipelineAsync() Methode desGPUDevice Interfaces gibt einPromise zurück, das mit einemGPUComputePipeline erfüllt wird. Diese kann die Compute-Shader-Stufe steuern und in einemGPUComputePassEncoder verwendet werden, sobald die Pipeline ohne Blockierungen einsatzbereit ist.

Syntax

createComputePipelineAsync(descriptor)

Parameter

descriptor

Siehe die Descriptor-Definition für die MethodeGPUDevice.createComputePipeline().

Rückgabewert

EinPromise, das mit einerGPUComputePipeline Objektinstanz erfüllt wird, wenn die erstellte Pipeline einsatzbereit ist, ohne zusätzliche Verzögerungen.

Validierung

Wenn die Pipelinenerstellung fehlschlägt und die resultierende Pipeline dadurch ungültig wird, wird das zurückgegebene Promise mit einemGPUPipelineError abgelehnt:

• Wenn dies auf einen internen Fehler zurückzuführen ist, hat derGPUPipelineError einenreason von"internal".
• Wenn dies auf einen Validierungsfehler zurückzuführen ist, hat derGPUPipelineError einenreason von"validation".

Ein Validierungsfehler kann auftreten, wenn eines der folgenden Dinge nicht zutrifft:

• Die von dem imcompute-Eigenschaft referenziertenmodule verwendete Arbeitsgruppenspeichergröße ist kleiner oder gleich demmaxComputeWorkgroupStorageSize-Limit desGPUDevice.
• Dasmodule verwendet eine Anzahl von Compute-Aufrufen pro Arbeitsgruppe, die kleiner oder gleich demmaxComputeInvocationsPerWorkgroup-Limit desGPUDevice ist.
• Die Arbeitsgruppengröße desmodule ist kleiner oder gleich dem entsprechendenmaxComputeWorkgroupSizeX,maxComputeWorkgroupSizeY odermaxComputeWorkgroupSizeZ-Limit desGPUDevice.
• Wenn dieentryPoint-Eigenschaft weggelassen wird, enthält der Shader-Code eine einzelne Compute-Shader-Einstiegspunktfunktion, die der Browser als Standard-Einstiegspunkt verwenden kann.

Beispiele

Einfaches Beispiel

Das folgende Beispiel zeigt einen Prozess:

• Erstellen eines Bind-Gruppen-Layouts mitGPUDevice.createBindGroupLayout().
• Einspeisen desbindGroupLayout inGPUDevice.createPipelineLayout(), um einGPUPipelineLayout zu erstellen.
• Unmittelbare Nutzung dieses Werts in einemcreateComputePipelineAsync() Aufruf, um eineGPUComputePipeline zu erstellen.

async function init() {  // …  const bindGroupLayout = device.createBindGroupLayout({    entries: [      {        binding: 0,        visibility: GPUShaderStage.COMPUTE,        buffer: {          type: "storage",        },      },    ],  });  const computePipeline = await device.createComputePipelineAsync({    layout: device.createPipelineLayout({      bindGroupLayouts: [bindGroupLayout],    }),    compute: {      module: shaderModule,      entryPoint: "main",    },  });  // …}

Spezifikationen

Browser-Kompatibilität

Siehe auch

• DieWebGPU API