WorkerGlobalScope: метод createImageBitmap()

Примечание: Эта функция доступна только в Веб-воркерах.

Метод createImageBitmap() интерфейса WorkerGlobalScope создаёт растровое изображение из заданного источника, по желанию обрезая его до части исходного изображения. Он принимает различные источники изображений и возвращает Promise, который разрешается в ImageBitmap.

Синтаксис

createImageBitmap(image)
createImageBitmap(image, options)
createImageBitmap(image, sx, sy, sw, sh)
createImageBitmap(image, sx, sy, sw, sh, options)

Параметры

image

Источник изображения, который может быть одним из следующих:

sx

Координата x опорной точки прямоугольника, из которого будет извлечено ImageBitmap.

sy

Координата y опорной точки прямоугольника, из которого будет извлечено ImageBitmap.

sw

Ширина прямоугольника, из которого будет извлечено ImageBitmap. Значение может быть отрицательным.

sh

Высота прямоугольника, из которого будет извлечено ImageBitmap. Значение может быть отрицательным.

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

Объект, задающий параметры извлечения изображения. Доступные параметры:

imageOrientation

Определяет, как должно быть ориентировано растровое изображение.

from-image: Изображение ориентировано в соответствии с метаданными EXIF ориентации, если они присутствуют (по умолчанию).
flipY: Изображение ориентировано в соответствии с метаданными EXIF ориентации, если они присутствуют, а затем перевёрнуто по вертикали.
none: Изображение ориентировано в соответствии с кодированием изображения, игнорируя любые метаданные об ориентации (например, метаданные EXIF, которые могут быть добавлены к изображению для указания того, что камера была повернута боком для захвата изображения в портретном режиме).

premultiplyAlpha

Определяет, должны ли цветовые каналы растрового изображения быть умножены на альфа-канал. Одно из none, premultiply, или default (по умолчанию).

colorSpaceConversion

Определяет, должно ли изображение декодироваться с преобразованием цветового пространства. Либо none или default (по умолчанию). Значение default указывает, что используется поведение, зависящее от реализации.

resizeWidth

Целое число, указывающее выходную ширину.

resizeHeight

Целое число, указывающее выходную высоту.

resizeQuality

Определяет алгоритм, используемый для изменения размера ввода для соответствия выходным размерам. Одно из pixelated, low (по умолчанию), medium, или high.

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

A Promise, который разрешается в объект ImageBitmap содержащий данные растрового изображения из заданного прямоугольника.

Примеры

См. Window.createImageBitmap() для примеров.

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

Спецификация
HTML # dom-createimagebitmap-dev

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`createImageBitmap`	50	79	42	37	15	50	42	37	15	5.0	50
`options_colorSpaceConversion_parameter`	58	79	98	45	15	58	98	43	15	7.0	58
`options_imageOrientation_parameter`	52	79	93	39	15	52	93	41	15	6.0	52
`options_premultiplyAlpha_parameter`	52	79	93	39	17 15–17 Если исходное изображение — объект `ImageData`, то параметр `premultiplyAlpha` ничего не делает. См. ошибку 237082.	52	93	41	17 15–17 Если исходное изображение — объект `ImageData`, то параметр `premultiplyAlpha` ничего не делает. См. ошибку 237082.	6.0	52
`options_resizeHeight_parameter`	54	79	98	41	15	54	98	41	15	6.0	54
`options_resizeQuality_parameter`	54	79	Нет	41	15	54	Нет	41	15	6.0	54
`options_resizeWidth_parameter`	54	79	98	41	15	54	98	41	15	6.0	54
`svgimageelement_as_source_image`	59	79	65	46	17.2	59	65	43	17.2	7.0	59

См. также

© 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/WorkerGlobalScope/createImageBitmap