HTML canvas getImageData()メソッド

Canvas 对象参考手册Canvas オブジェクト

例

次のコードは、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);
}

試してみる »

ブラウザサポート

Internet ExplorerFirefoxOperaGoogle ChromeSafari

Internet Explorer 9、Firefox、Opera、Chrome、Safari は getImageData() メソッドをサポートしています。

注意:Internet Explorer 8 以前のバージョンは <canvas> 要素をサポートしていません。


定義と使い方

getImageData() メソッドは、キャンバスの指定した矩形のピクセルデータをコピーした ImageData オブジェクトを返します。

注意:ImageData オブジェクトは画像ではなく、キャンバス上の一部(矩形)を指定し、その矩形内の各ピクセルの情報を保持します。

ImageData オブジェクトの各ピクセルには、RGBA 値という4つの情報があります:

R - 赤色(0-255)
G - 緑色(0-255)
B - 青色(0-255)
A - アルファチャンネル(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 コピーする矩形領域の高さ。


实例

その他の例

使用する画像:

The Scream

例

getImageData() を使用して、キャンバス上の画像の各ピクセルの色を反転させます:

YourbrowserdoesnotsupporttheHTML5canvastag.

JavaScript:

var c=document.getElementById("myCanvas");
var ctx=c.getContext("2d");
var img=document.getElementById("scream");
ctx.drawImage(img,0,0);
var imgData=ctx.getImageData(0,0,c.width,c.height);
// invert colors
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);

試してみる »


Canvas 对象参考手册Canvas オブジェクト

その他の拡張