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 只读
无符号长整型(unsigned long),使用像素描述 ImageData 的实际高度。
ImageData.width 只读
无符号长整型(unsigned long),使用像素描述 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) ? ? ?

参见

文档标签和贡献者

此页面的贡献者: Zhang-Junzhi, vigrodong, ice-i-snow, teoli, ziyunfei
最后编辑者: Zhang-Junzhi,