Интерфейс ImageData
представляет лежащие в основе пиксельные данные области элемента <canvas>
. Он создан используя конструктор ImageData()
или метод создания объекта CanvasRenderingContext2D
ассоциированного с canvas: createImageData()
и getImageData()
. Он также может быть использован для установки части canvas используя метод putImageData()
.
Конструкторы
ImageData()
- Создаёт ImageData из указанного
Uint8ClampedArray
и из размера изображения которого он содержит. Если массив не указан, то он создаёт изображение чёрного прямоугольника. Обратите внимание, что такой довольно распространённый путь создания подобного объекта в worker'ах какcreateImageData()
там не доступен.
Свойства
ImageData.data
Только для чтения- Возвращает
Uint8ClampedArray
представляющий собой одномерный массив, содержащий данные цветовой модели RGBA, с целыми значениями от 0 до 255 (включительно). ImageData.height
Только для чтения- Фактическая высота в пикселях объекта
ImageData
. ImageData.width
Только для чтения- Фактическая ширина в пикселях объекта
ImageData
.
Спецификации
Спецификация | Статус | Комментарий |
---|---|---|
HTML Living Standard Определение 'ImageData' в этой спецификации. |
Живой стандарт |
Совместимость с браузерами
We're converting our compatibility data into a machine-readable JSON format.
This compatibility table still uses the old format,
because we haven't yet converted the data it contains.
Find out how you can help!
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 4.0 | 14 (14) | 9.0 | 9.0 | 3.1 |
Support in workers | (Да) | 25 (25) | ? | ? | ? |
ImageData() constructor |
43 | 29 (29) | Нет | 30 | ? |
Feature | Android | Android Webview | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile | Chrome for Android |
---|---|---|---|---|---|---|---|
Basic support | 2.1 | (Да) | 14.0 (14) | ? | 10.0 | 3.2 | (Да) |
Support in workers | ? | (Да) | 25.0 (25) | ? | ? | ? | (Да) |
ImageData() constructor |
? | (Да) | 29.0 (29) | ? | ? | ? | (Да) |
См. также
CanvasRenderingContext2D
- The
<canvas>
element and its associated interface,HTMLCanvasElement
.