GPUQuerySet
Limited availability
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.
Giao diện GPUQuerySet của WebGPU API được sử dụng để ghi lại kết quả các truy vấn trong các lượt xử lý, chẳng hạn như truy vấn che khuất hoặc truy vấn dấu thời gian.
-
Truy vấn che khuất có sẵn trong các lượt kết xuất để truy vấn xem có mẫu phân mảnh nào vượt qua tất cả các bài kiểm tra theo phân mảnh cho một tập hợp các lệnh vẽ hay không. Để chạy truy vấn che khuất, cần cung cấp
GPUQuerySetthích hợp làm giá trị của thuộc tính mô tảocclusionQuerySetkhi gọiGPUCommandEncoder.beginRenderPass()để chạy lượt kết xuất. -
Truy vấn dấu thời gian cho phép ứng dụng ghi dấu thời gian vào
GPUQuerySet. Để chạy truy vấn dấu thời gian, cần cung cấp cácGPUQuerySetthích hợp bên trong giá trị của thuộc tính mô tảtimestampWriteskhi gọiGPUCommandEncoder.beginRenderPass()để chạy lượt kết xuất, hoặcGPUCommandEncoder.beginComputePass()để chạy lượt tính toán.
Note:
Tính năng timestamp-query cần được bật để sử dụng truy vấn dấu thời gian.
Đối tượng GPUQuerySet được tạo bằng phương thức GPUDevice.createQuerySet().
Thuộc tính phiên bản
countRead only-
Một số chỉ định số lượng truy vấn được quản lý bởi
GPUQuerySet. label-
Một chuỗi cung cấp nhãn có thể được sử dụng để xác định đối tượng, ví dụ trong thông báo
GPUErrorhoặc cảnh báo bảng điều khiển. typeRead only-
Một giá trị liệt kê chỉ định loại truy vấn được quản lý bởi
GPUQuerySet.
Phương thức phiên bản
destroy()-
Hủy
GPUQuerySet.
Ví dụ
Đoạn mã sau tạo một GPUQuerySet chứa 32 kết quả truy vấn che khuất, rồi trả về type và count:
const querySet = device.createQuerySet({
type: "occlusion",
count: 32,
});
console.log(querySet.count); // 32
console.log(querySet.type); // "occlusion"
Thông số kỹ thuật
| Specification |
|---|
| WebGPU # gpuqueryset |