GPUTexture: usage property
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.
Thuộc tính chỉ đọc usage của giao diện GPUTexture là các bitwise flags đại diện cho các cách sử dụng được phép của GPUTexture.
Giá trị này được đặt thông qua thuộc tính usage trong đối tượng descriptor truyền vào lời gọi GPUDevice.createTexture() ban đầu.
Giá trị
Các bitwise flag đại diện cho các cách sử dụng ban đầu được đặt khi GPUTexture được tạo lần đầu. Số trả về là tổng của các giá trị thập phân đại diện cho các cờ khác nhau, như trong bảng bên dưới.
| Cờ sử dụng | Mô tả sử dụng | Hex tương đương | Thập phân tương đương |
|---|---|---|---|
GPUTextureUsage.COPY_SRC |
Kết cấu có thể được dùng làm nguồn của thao tác sao chép, ví dụ đối số nguồn của lời gọi copyTextureToBuffer(). |
0x01 | 1 |
GPUTextureUsage.COPY_DST |
Kết cấu có thể được dùng làm đích của thao tác sao chép/ghi, ví dụ đối số đích của lời gọi copyBufferToTexture(). |
0x02 | 2 |
GPUTextureUsage.RENDER_ATTACHMENT |
Kết cấu có thể được dùng làm attachment màu sắc hoặc depth/stencil trong render pass, ví dụ thuộc tính view của đối tượng descriptor trong lời gọi beginRenderPass(). |
0x10 | 16 |
GPUTextureUsage.STORAGE_BINDING |
Kết cấu có thể được ràng buộc để dùng làm storage texture trong shader, ví dụ làm tài nguyên trong mục bind group khi tạo GPUBindGroup (qua createBindGroup()), tuân theo mục GPUBindGroupLayout với bố cục ràng buộc storage texture được chỉ định. |
0x08 | 8 |
GPUTextureUsage.TEXTURE_BINDING |
Kết cấu có thể được ràng buộc để dùng làm sampled texture trong shader, ví dụ làm tài nguyên trong mục bind group khi tạo GPUBindGroup (qua createBindGroup()), tuân theo mục GPUBindGroupLayout với bố cục ràng buộc texture được chỉ định. |
0x04 | 4 |
Ví dụ
js
// …
const depthTexture = device.createTexture({
size: [canvas.width, canvas.height],
format: "depth24plus",
usage: GPUTextureUsage.RENDER_ATTACHMENT,
});
console.log(depthTexture.usage); // 16
Thông số kỹ thuật
| Specification |
|---|
| WebGPU # dom-gputexture-usage |