ImageData 接口描述 <canvas> 元素的一个隐含像素数据的区域。使用 ImageData() 构造函数创建或者使用和 canvas 在一起的 CanvasRenderingContext2D 对象的创建方法: createImageData() 和 getImageData()。也可以使用 putImageData() 设置 canvas 的一部分。
构造函数
ImageData()- 三个参数,第一个 是
Uint8ClampedArray的实例,第二个和第三个表示的是width和height,必须保证Uint8ClampedArray的length = 4*width*height才不会报错,如果第一个参数Uint8ClampedArray没有的话,自动按照width和height的大小,以0填充整个像素矩阵。 - 使用给定的
Uint8ClampedArray创建一个ImageData对象,并包含图像的大小。如果不给定数组,会创建一个黑色矩形图像。注意,这是最常见的方式去创建这样一个对象,在createImageData()不可用时。
属性
ImageData.data只读Uint8ClampedArray描述了一个一维数组,包含以 RGBA 顺序的数据,数据使用0至255(包含)的整数表示。ImageData.height只读- 无符号长整型(
unsignedlong),使用像素描述 ImageData 的实际高度。 ImageData.width只读- 无符号长整型(
unsignedlong),使用像素描述 ImageData 的实际宽度。
规范描述
| Specification | Status | Comment |
|---|---|---|
| HTML Living Standard ImageData |
Living Standard |
浏览器兼容性
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 |
? | 29 (29) | 未实现 | ? | ? |
| Feature | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| Basic support | 2.1 | 14.0 (14) | ? | 10.0 | 3.2 |
| Support in workers | ? | 25.0 (25) | ? | ? | ? |
ImageData()constructor |
? | 29.0 (29) | ? | ? | ? |
参见
CanvasRenderingContext2D<canvas>元素及其相关的接口HTMLCanvasElement。
文档标签和贡献者
最后编辑者:
mdnwebdocs-bot,