GPUBuffer: mapState property

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.

Thuộc tính chỉ đọc mapState của giao diện GPUBuffer đại diện cho trạng thái được ánh xạ của GPUBuffer.

Giá trị

Giá trị được liệt kê. Các giá trị có thể là:

unmapped

Buffer không được ánh xạ. GPUBuffer.getMappedRange() không thể được sử dụng để truy cập nội dung của GPUBuffer trong JavaScript. Điều này có thể vì:

pending

Buffer chưa được ánh xạ. GPUBuffer.mapAsync() đã được gọi, nhưng Promise của nó hiện đang chờ xử lý. GPUBuffer.getMappedRange() hiện không thể được sử dụng để truy cập nội dung của GPUBuffer trong JavaScript.

mapped

Buffer đã được ánh xạ. Promise của GPUBuffer.mapAsync() đã được thực hiện và GPUBuffer.getMappedRange() hiện có thể được sử dụng để truy cập nội dung của GPUBuffer trong JavaScript.

Ví dụ

js
const stagingBuffer = device.createBuffer({
  size: BUFFER_SIZE,
  usage: GPUBufferUsage.MAP_READ | GPUBufferUsage.COPY_DST,
});

console.log(stagingBuffer.mapState); // "unmapped"

// …

await stagingBuffer.mapAsync(
  GPUMapMode.READ,
  0, // Offset
  BUFFER_SIZE, // Length
);

console.log(stagingBuffer.mapState); // "mapped"

Thông số kỹ thuật

Thông số kỹ thuật
WebGPU
# dom-gpubuffer-mapstate

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

Xem thêm