GPUBuffer: метод mapAsync()

Метод mapAsync() интерфейса GPUBuffer отображает указанный диапазон GPUBuffer. Он возвращает Promise, который разрешается, когда содержимое GPUBuffer готово для доступа. Пока GPUBuffer отображено, его нельзя использовать в каких-либо командах GPU.

После успешного отображения буфера (что можно проверить с помощью GPUBuffer.mapState), вызовы GPUBuffer.getMappedRange() вернут ArrayBuffer, содержащий текущие значения GPUBuffer, которые можно читать и обновлять с помощью JavaScript по мере необходимости.

После завершения работы со значениями GPUBuffer, вызовите GPUBuffer.unmap(), чтобы снять отображение, сделав его снова доступным для GPU.

mode

Флаг, определяющий, отображен ли GPUBuffer для чтения или записи. Возможные значения:

GPUMapMode.READ

GPUBuffer отображено для чтения. Значения могут быть прочитаны, но любые изменения, внесенные в ArrayBuffer, возвращаемый GPUBuffer.getMappedRange(), будут отброшены после вызова GPUBuffer.unmap().

Отображение в режиме чтения может использоваться только для GPUBuffer с установленным значением использования GPUBufferUsage.MAP_READ (например, при создании с помощью GPUDevice.createBuffer()).

GPUMapMode.WRITE

GPUBuffer отображено для записи. Значения могут быть прочитаны и обновлены — любые изменения, внесенные в ArrayBuffer, возвращаемый GPUBuffer.getMappedRange(), будут сохранены в GPUBuffer после вызова GPUBuffer.unmap().

Отображение в режиме записи может использоваться только для GPUBuffer с установленным значением использования GPUBufferUsage.MAP_WRITE (например, при создании с помощью GPUDevice.createBuffer()).

offset Необязательно

Число, представляющее смещение в байтах от начала буфера до начала отображаемого диапазона. Если offset опущено, оно по умолчанию равно 0.

size Необязательно

Число, представляющее размер в байтах отображаемого диапазона. Если size опущено, отображаемый диапазон простирается до конца GPUBuffer.

A Promise, который разрешается в Undefined, когда содержимое GPUBuffer готово для доступа.

При вызове mapSync() должны быть соблюдены следующие условия, в противном случае будет выброшено исключение OperationError DOMException, обещание отклонится, и будет сгенерировано значение GPUValidationError:

• offset должно быть кратно 8.
• Общий отображаемый диапазон (size если указано, или GPUBuffer.size - offset если нет) должен быть кратен 4.
• Общий отображаемый диапазон должен быть внутри границ GPUBuffer.
• Если режим равен GPUMapMode.READ, у GPUBuffer должно быть значение использования GPUBufferUsage.MAP_READ.
• Если режим равен GPUMapMode.WRITE, у GPUBuffer должно быть значение использования GPUBufferUsage.MAP_WRITE.

См. главную страницу GPUBuffer для примера.

• The WebGPU API