ImageData - 表示 <canvas> 元素区域的基础像素数据
ImageData 接口表示 <canvas> 元素区域的基础像素数据。它是通过 ImageData() 构造函数,或者是画布关联的 CanvasRenderingContext2D 对象的创建方法:createImageData() 和 getImageData() 来创建的。它还可以用于使用 putImageData() 来设置画布的一部分。
构造函数
ImageData()
从给定的 Uint8ClampedArray 及其包含的图像的大小,创建一个 ImageData 对象。如果没有给出数组,则会创建一个黑色矩形的图像。请注意,这是在 worker 中创建此类对象的最常用方法,因为 createImageData() 在 worker 中不可用。
属性
ImageData.data 只读
一个 Uint8ClampedArray,表示包含 RGBA 顺序数据的一维数组,整数值介于 0 和 255(包含)之间。
ImageData.height 只读
一个 unsigned long ,表示 ImageData 的实际高度(以像素为单位)。
ImageData.width 只读
一个 unsigned long ,表示 ImageData 的实际宽度(以像素为单位)。
规范
| 规范 | 状态 | 备注 |
|---|---|---|
| HTML Living Standard ImageData 的定义 |
现行的标准 | - |
桌面浏览器兼容性
| 特性 | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| 基础支持 | 4 | 支持 | 14 | 9 | 9 | 3.1 |
| Available in workers | 支持 | 未知 | 25 | 未知 | 未知 | 未知 |
ImageData() constructor | 42 | 支持 | 29 | 不支持 | 29 | 未知 |
data | 支持 | 12 | 14 | 9 | 9 | 3.1 |
height | 支持 | 12 | 14 | 9 | 9 | 3.1 |
width | 支持 | 12 | 14 | 9 | 9 | 3.1 |
移动浏览器兼容性
| 特性 | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
|---|---|---|---|---|---|---|---|
| 基础支持 | 支持 | 支持 | 未知 | 14 | 未知 | 10 | 3.2 |
| Available in workers | 支持 | 未知 | 未知 | 25 | 未知 | 未知 | 未知 |
ImageData() constructor | 不支持 | 42 | 未知 | 29 | 未知 | 未知 | 未知 |
data | 未知 | 支持 | 支持 | 14 | 未知 | 支持 | 支持 |
height | 支持 | 支持 | 支持 | 14 | 未知 | 支持 | 支持 |
width | 支持 | 支持 | 支持 | 14 | 未知 | 支持 | 支持 |
相关链接
CanvasRenderingContext2D<canvas>元素及其关联的接口HTMLCanvasElement。