大网数据广告活动
Web 标准与前端开发

ImageData

· 52CE 我爱测

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

Canvas API

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

构造函数

  • ImageData.ImageData
    • : 三个参数,第一个 是Uint8ClampedArray的实例,第二个和第三个表示的是 width 和 height,必须保证 Uint8ClampedArray 的 length = 4*width*height 才不会报错,如果第一个参数 Uint8ClampedArray 没有的话,自动按照 width 和 height 的大小,以 0 填充整个像素矩阵。 使用给定的Uint8ClampedArray创建一个 ImageData 对象,并包含图像的大小。如果不给定数组,会创建一个“完全透明”(因为透明度值为 0) 的黑色矩形图像。注意,这是最常见的方式去创建这样一个对象,在 CanvasRenderingContext2D.createImageData 不可用时。

属性

  • ImageData.data
    • : Uint8ClampedArray 描述了一个一维数组,包含以 RGBA 顺序的数据,数据使用 0 至 255(包含)的整数表示。
  • ImageData.height
    • : 无符号长整型(unsigned long),使用像素描述 ImageData 的实际高度。
  • ImageData.width
    • : 无符号长整型(unsigned long),使用像素描述 ImageData 的实际宽度。

规范

浏览器兼容性

参见

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

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。