GPUCanvasContext: configure() method

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

Phương thức configure() của giao diện GPUCanvasContext cấu hình ngữ cảnh để sử dụng cho kết xuất với GPUDevice cho trước. Khi được gọi, canvas ban đầu sẽ bị xóa thành màu đen trong suốt.

Cú pháp

configure(configuration)

Tham số

configuration

Đối tượng chứa các thuộc tính sau:

alphaMode Optional

Giá trị được liệt kê xác định hiệu ứng mà các giá trị alpha sẽ có trên nội dung của các texture được trả về bởi getCurrentTexture() khi đọc, hiển thị hoặc sử dụng làm nguồn hình ảnh. Các giá trị có thể là:

opaque: Các giá trị alpha bị bỏ qua, nếu texture chưa đục thì kênh alpha sẽ được xóa thành 1.0 khi sử dụng làm nguồn hình ảnh hoặc hiển thị trên màn hình. Đây là giá trị mặc định.
premultiplied: Các giá trị màu được nhân trước với giá trị alpha của chúng. Ví dụ, màu đỏ 100% ở mức alpha 50% là [0.5, 0, 0, 0.5].

colorSpace Optional

Không gian màu mà các giá trị được ghi vào texture được trả về bởi getCurrentTexture() nên được hiển thị. Các giá trị có thể là srgb (mặc định) và display-p3.

device

GPUDevice mà thông tin kết xuất cho ngữ cảnh sẽ đến từ đó.

format

Định dạng mà các texture được trả về bởi getCurrentTexture() sẽ có. Có thể là bgra8unorm, rgba8unorm, hoặc rgba16float. Định dạng texture canvas tối ưu cho hệ thống hiện tại có thể được trả về bởi GPU.getPreferredCanvasFormat(). Khuyến nghị sử dụng cái này, nếu bạn không sử dụng định dạng ưa thích khi cấu hình ngữ cảnh canvas, bạn có thể gặp phải chi phí bổ sung, chẳng hạn như sao chép texture bổ sung, tùy thuộc vào nền tảng.

toneMapping Optional

Đối tượng xác định các tham số định nghĩa tone mapping cho ngữ cảnh, cách nội dung của các texture liên quan sẽ được hiển thị. Điều này cho phép WebGPU vẽ màu sáng hơn white (#FFFFFF). Các thuộc tính có thể là:

mode Optional

Giá trị được liệt kê xác định chế độ tone mapping cho canvas. Các giá trị có thể bao gồm:

standard: Giá trị mặc định. Hạn chế nội dung được kết xuất trong Dải Động Tiêu Chuẩn (SDR) của màn hình.
extended: Cho phép nội dung được kết xuất trong Dải Động Cao (HDR) đầy đủ của màn hình, khi có. Chế độ HDR cho phép hiển thị nhiều màu sắc và mức độ sáng hơn.

usage Optional

Bitwise flags xác định cách sử dụng cho phép cho các texture được trả về bởi getCurrentTexture().

viewFormats Optional

Mảng các định dạng mà các view được tạo từ các texture được trả về bởi getCurrentTexture() có thể sử dụng.

const canvas = document.querySelector("#gpuCanvas");
const context = canvas.getContext("webgpu");

context.configure({
  device,
  format: navigator.gpu.getPreferredCanvasFormat(),
  alphaMode: "premultiplied",
});