HTML canvas getImageData() 方法

实例

下面的代码用getImageData()复制画布上指定矩形的像素数据，然后用putImageData()把图像数据放回画布上:

var c = document.getElementById("myCanvas");
var ctx = c.getContext("2d");
ctx.fillStyle = "red";
ctx.fillRect(10, 10, 50, 50);

function copy() {
var imgData = ctx.getImageData(10, 10, 50, 50);
ctx.putImageData(imgData, 10, 70);
}

亲自试一试 »

浏览器支持

表中的数字表示支持该方法的第一个浏览器版本。

方法
getImageData()	4.0	9.0	3.6	4.0	10.1

定义和用法

getImageData() 方法返回一个 ImageData 对象，该对象复制画布上指定矩形的像素数据。

注释: ImageData 对象不是图片，它指定画布上的一个部分（矩形），并保存该矩形内每个像素的信息。

对于 ImageData 对象中的每个像素，都有四个信息，即 RGBA 值:

R - 红色（0-255）
G - 绿色（从 0-255）
B - 蓝色（从 0-255）
A - alpha 通道（从 0-255；0 是透明的，255 是完全可见的）

color/alpha 信息保存在一个数组中，并存储在 ImageData 对象的 data 属性中。

提示: 处理完数组中的 color/alpha 信息后，您可以使用 putImageData() 将图像数据复制回画布上方法。

示例:

获取返回的 ImageData 对象中第一个像素的 color/alpha 信息的代码:

red = imgData.data[0];
green = imgData.data[1];
blue = imgData.data[2];
alpha = imgData.data[3];

亲自试一试

提示: 您还可以使用 getImageData() 方法来反转画布上图像的每个像素的颜色。

遍历所有像素并使用以下公式更改颜色值:

red = 255-old_red;
green = 255-old_green;
blue = 255-old_blue;

提示: 下面有更多实例。

JavaScript 语法

JavaScript 语法:	context.getImageData(x, y, width, height);

参数值

参数	描述
x	从左上角开始复制的 x 坐标（以像素为单位）
y	从左上角开始复制的 y 坐标（以像素为单位）
width	您将复制的矩形区域的宽度
height	您将复制的矩形区域的高度