HTML canvas getImageData() 方法

HTML5 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 信息：

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;

（請見下面的“親自試一試”實例。）

實例

例子 1

下面的代碼通過 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);
}

親自試一試

提示：頁面底部提供更多實例。

語法

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

參數值

參數 描述
x 開始復制的左上角位置的 x 坐標。
y 開始復制的左上角位置的 y 坐標。
width 將要復制的矩形區域的寬度。
height 將要復制的矩形區域的高度。

更多實例

例子 2

要使用的圖像：

The Tulip

使用 getImageData() 來反轉畫布上的圖像的每個像素的顏色。

Your browser does not support the HTML5 canvas tag.

JavaScript:

var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var img=document.getElementById("tulip");
ctx.drawImage(img,0,0);
var imgData=ctx.getImageData(0,0,c.width,c.height);
// 反轉顏色
for (var i=0;i<imgData.data.length;i+=4)
  {
  imgData.data[i]=255-imgData.data[i];
  imgData.data[i+1]=255-imgData.data[i+1];
  imgData.data[i+2]=255-imgData.data[i+2];
  imgData.data[i+3]=255;
  }
ctx.putImageData(imgData,0,0);

親自試一試

瀏覽器支持

表中的數字注明了首個完全支持該屬性的瀏覽器版本。

Chrome Edge Firefox Safari Opera
Chrome Edge Firefox Safari Opera
4.0 9.0 3.6 4.0 10.1

注釋：Internet Explorer 8 以及更早的版本不支持 <canvas> 元素。

HTML5 Canvas 參考手冊