GPUBuffer: свойство mapState

Ограниченная доступность

Эта функция не является базовой, так как она не работает в некоторых из наиболее широко используемых браузеров.

Экспериментально: Это экспериментальная технология
Перед использованием в продакшене внимательно проверьте таблицу совместимости с браузерами.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS) в некоторых или во всех поддерживающих браузерах.

Примечание: Эта функция доступна в Web Workers.

Свойство mapState только для чтения интерфейса GPUBuffer представляет состояние отображения GPUBuffer.

Значение

Перечисление. Возможные значения:

unmapped

Буфер не отображён. GPUBuffer.getMappedRange() не может быть использован для доступа к содержимому GPUBuffer в JavaScript. Это может быть из-за:

GPUBuffer.mapAsync() ещё не был вызван.
Буфер был ранее отображён, а затем снова отображён с помощью GPUBuffer.unmap().

pending

Буфер ещё не отображён. GPUBuffer.mapAsync() был вызван, но его Promise в данный момент ожидает завершения. GPUBuffer.getMappedRange() в настоящее время не может быть использован для доступа к содержимому GPUBuffer в JavaScript.

mapped

Буфер отображён. GPUBuffer.mapAsync() Promise выполнен, и GPUBuffer.getMappedRange() теперь может быть использован для доступа к содержимому GPUBuffer в JavaScript.

Примеры

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"

Спецификации

Спецификация
WebGPU # dom-gpubuffer-mapstate

Совместимость с браузерами

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`mapState`	113 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	113 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	preview В настоящее время поддерживается только на Linux и Windows.	99 В настоящее время поддерживается только на ChromeOS, macOS и Windows.	preview	121	Нет	81	Нет	25.0	121

См. также

API WebGPU

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/GPUBuffer/mapState