ImageData

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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 顺序的数据,数据使用 0255(包含)的整数表示。

ImageData.height 只读

无符号长整型(unsigned long),使用像素描述 ImageData 的实际高度。

ImageData.width 只读

无符号长整型(unsigned long),使用像素描述 ImageData 的实际宽度。

规范

Specification
HTML
# imagedata

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
ImageData
ImageData() constructor
colorSpace
data
height
width
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

参见