ImageData - Web API 接口参考 编辑

ImageData 接口描述 <canvas> 元素的一个隐含像素数据的区域。使用 ImageData() 构造函数创建或者使用和 canvas 在一起的 CanvasRenderingContext2D 对象的创建方法： createImageData() 和 getImageData()。也可以使用 putImageData() 设置 canvas 的一部分。

构造函数

ImageData()

三个参数，第一个 是Uint8ClampedArray的实例，第二个和第三个表示的是width和height，必须保证Uint8ClampedArray的length = 4*width*height才不会报错，如果第一个参数Uint8ClampedArray没有的话，自动按照width和height的大小，以0填充整个像素矩阵。

使用给定的Uint8ClampedArray创建一个 ImageData 对象，并包含图像的大小。如果不给定数组，会创建一个“完全透明”(因为透明度值为0)的黑色矩形图像。注意，这是最常见的方式去创建这样一个对象，在 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

浏览器兼容性

BCD tables only load in the browser

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!

• Desktop
• Mobile

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

参见

• CanvasRenderingContext2D
• <canvas> 元素及其相关的接口 HTMLCanvasElement。