GPU: метод getPreferredCanvasFormat()

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

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

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

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

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

Метод getPreferredCanvasFormat() интерфейса GPU возвращает оптимальный формат текстуры холста для отображения контента с глубиной 8 бит и стандартным динамическим диапазоном на текущей системе.

Это обычно используется для вызова GPUCanvasContext.configure() со значением format , оптимальным для текущей системы. Это рекомендуется — если вы не используете предпочтительный формат при конфигурировании контекста холста, вы можете столкнуться с дополнительными затратами, такими как дополнительные копии текстур, в зависимости от платформы.

Синтаксис

getPreferredCanvasFormat()

Параметры

Нет.

Возвращаемое значение

Строка, указывающая формат текстуры холста. Значение может быть rgba8unorm или bgra8unorm.

Исключения

Нет.

Примеры

const canvas = document.querySelector("#gpuCanvas");
const context = canvas.getContext("webgpu");

context.configure({
  device: device,
  format: navigator.gpu.getPreferredCanvasFormat(),
  alphaMode: "premultiplied",
});

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

Спецификация
WebGPU # dom-gpu-getpreferredcanvasformat

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

	Рабочий стол					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`getPreferredCanvasFormat`	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/GPU/getPreferredCanvasFormat