GPUDevice: метод createComputePipelineAsync()

Метод createComputePipelineAsync() интерфейса GPUDevice возвращает Promise, который выполняется с GPUComputePipeline, управляющим стадией шейдера вычислений и используемым в GPUComputePassEncoder, как только этот pipeline готов к использованию без задержек.

descriptor

См. определение дескриптора для метода GPUDevice.createComputePipeline().

Promise, который выполняется с объектом GPUComputePipeline, когда созданный pipeline готов к использованию без задержек.

Если создание pipeline терпит неудачу, а полученный pipeline становится недействительным, возвращаемое promise отклоняется с GPUPipelineError:

• Если это внутренняя ошибка, у GPUPipelineError будет свойство reason со значением "internal".
• Если это ошибка проверки, у GPUPipelineError будет свойство reason со значением "validation".

Ошибка проверки может произойти, если хотя бы одно из следующих условий ложно:

• Размер хранилища workgroup, используемый module внутри свойства compute, меньше или равен пределу maxComputeWorkgroupStorageSize GPUDevice ( предел).
• module использует число вызовов вычислений на workgroup, меньше или равное пределу maxComputeInvocationsPerWorkgroup GPUDevice ( предел).
• Размер workgroup module меньше или равен соответствующему пределу maxComputeWorkgroupSizeX, maxComputeWorkgroupSizeY, или maxComputeWorkgroupSizeZ GPUDevice ( предел).
• Если свойство entryPoint опущено, код шейдера содержит единственную функцию входа compute шейдера, которую браузер использует в качестве точки входа по умолчанию.

В следующем примере показан процесс:

• Создание layout bind group с помощью GPUDevice.createBindGroupLayout().
• Передача bindGroupLayout в GPUDevice.createPipelineLayout() для создания GPUPipelineLayout.
• Немедленное использование этого значения в вызове createComputePipelineAsync() для создания GPUComputePipeline.

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",
    },
  });

  // ...
}

• API WebGPU