ImageData

Baseline 广泛可用 *

此特性已相当成熟，可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来，各浏览器均已提供此特性。

* 此特性的某些部分可能存在不同级别的支持。

注意：此功能在 Web Workers 中可用。

ImageData 接口代表了 <canvas> 元素区域的底层像素数据。

它可以通过 ImageData() 构造函数或与画布关联的 CanvasRenderingContext2D 对象上的创建方法 createImageData() 和 getImageData() 来创建。它还可以通过 putImageData() 来设置画布的一部分。

构造函数

ImageData(): 从给定的 Uint8ClampedArray 或 Float16Array 以及其中包含的图像大小创建 ImageData 对象。如果没有提供数组，它将创建一个透明的黑色矩形图像。请注意，这是在 worker 中创建此类对象的常用方法，因为 createImageData() 在那里不可用。

ImageData.data 只读: 一个 Uint8ClampedArray 或 Float16Array，表示一个包含 RGBA 顺序数据的的一维数组。顺序按行从左上角像素到右下角排列。
ImageData.colorSpace 只读: 一个字符串，指示图像数据的颜色空间。
ImageData.height 只读: 一个 unsigned long，表示 ImageData 的实际高度（以像素为单位）。
ImageData.width 只读: 一个 unsigned long，表示 ImageData 的实际宽度（以像素为单位）。
ImageData.pixelFormat 只读实验性的: 一个字符串，指示用于 ImageData 的格式。

规范
HTML # imagedata

本页面最后修改于 ⁨2025年8月19日⁩，由 MDN 贡献者修改。