HTML canvas getImageData() 方法

实例

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

  1. var c=document.getElementById("myCanvas");
  2. var ctx=c.getContext("2d");
  3. ctx.fillStyle="red";
  4. ctx.fillRect(10,10,50,50);
  5. function copy()
  6. {
  7. var imgData=ctx.getImageData(10,10,50,50);
  8. ctx.putImageData(imgData,10,70);
  9. }

浏览器支持

Internet Explorer 9、Firefox、Opera、Chrome 以及 Safari 支持 getImageData() 方法。

注释:Internet Explorer 8 或更早的浏览器不支持 <canvas> 元素。

定义和用法

getImageData() 方法返回 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 信息:

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

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

使用该公式遍历所有的像素,并改变其颜色值:

  1. red=255-old_red;
  2. green=255-old_green;
  3. blue=255-old_blue;

JavaScript 语法

  1. var imgData=context.getImageData(x,y,width,height);

参数值

参数 描述
x 开始复制的左上角位置的 x 坐标。
y 开始复制的左上角位置的 y 坐标。
width 将要复制的矩形区域的宽度。
height 将要复制的矩形区域的高度。

更多实例

要使用的图像:

The Tulip.jpg

使用 getImageData() 来反转画布上的图像的每个像素的颜色。

使用 getImageData() 来反转画布上的图像的每个像素的颜色.png

JavaScript:

  1. var c=document.getElementById("myCanvas");
  2. var ctx=c.getContext("2d");
  3. var img=document.getElementById("tulip");
  4. ctx.drawImage(img,0,0);
  5. var imgData=ctx.getImageData(0,0,c.width,c.height);
  6. // 反转颜色
  7. for (var i=0;i<imgData.data.length;i+=4)
  8. {
  9. imgData.data[i]=255-imgData.data[i];
  10. imgData.data[i+1]=255-imgData.data[i+1];
  11. imgData.data[i+2]=255-imgData.data[i+2];
  12. imgData.data[i+3]=255;
  13. }
  14. ctx.putImageData(imgData,0,0);