GPUDevice: phương thức createComputePipelineAsync()

Cú pháp

createComputePipelineAsync(descriptor)

Tham số

descriptor

Xem định nghĩa descriptor cho phương thức GPUDevice.createComputePipeline().

Giá trị trả về

Một Promise sẽ được hoàn tất với một thể hiện GPUComputePipeline khi pipeline được tạo đã sẵn sàng để dùng mà không cần chờ thêm.

Kiểm tra hợp lệ

Nếu việc tạo pipeline thất bại và pipeline kết quả trở nên không hợp lệ, promise trả về sẽ bị từ chối với một GPUPipelineError:

• Nếu nguyên nhân là lỗi nội bộ, GPUPipelineError sẽ có reason là "internal".
• Nếu nguyên nhân là lỗi kiểm tra hợp lệ, GPUPipelineError sẽ có reason là "validation".

Lỗi kiểm tra hợp lệ có thể xảy ra nếu bất kỳ điều nào sau đây là sai:

• Kích thước bộ nhớ lưu trữ workgroup mà module được tham chiếu bên trong thuộc tính compute sử dụng nhỏ hơn hoặc bằng giới hạn maxComputeWorkgroupStorageSize của GPUDevice.
• module sử dụng số lượng compute invocation trên mỗi workgroup nhỏ hơn hoặc bằng maxComputeInvocationsPerWorkgroup của GPUDevice.
• Kích thước workgroup của module nhỏ hơn hoặc bằng maxComputeWorkgroupSizeX, maxComputeWorkgroupSizeY, hoặc maxComputeWorkgroupSizeZ tương ứng của GPUDevice.
• Nếu thuộc tính entryPoint bị bỏ qua, mã shader phải chứa đúng một hàm entry point compute shader để trình duyệt dùng làm entry point mặc định.

Ví dụ

Ví dụ cơ bản

Ví dụ sau mô tả một quy trình:

• Tạo một bind group layout bằng GPUDevice.createBindGroupLayout().
• Đưa bindGroupLayout vào GPUDevice.createPipelineLayout() để tạo một GPUPipelineLayout.
• Dùng ngay giá trị đó trong một lời gọi createComputePipelineAsync() để tạo một 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",
    },
  });

  // …
}

Đặc tả

Tương thích trình duyệt

Xem thêm

• WebGPU API