HTML canvas getImageData()メソッド
例
次のコードは、getImageData() を使用してキャンバス上の指定した矩形のピクセルデータをコピーし、putImageData() を使用して画像データをキャンバスに戻します:
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 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 情報を取得します:
green=imgData.data[1];
blue=imgData.data[2];
alpha=imgData.data[3];
ヒント:getImageData() メソッドを使用して、キャンバス上の画像の各ピクセルの色を反転させることもできます。
次の公式を使用してすべてのピクセルを走査し、その色の値を変更します:
green=255-old_green;
blue=255-old_blue;
下の「試してみる」の例をご覧ください!
JavaScript 構文
| JavaScript 構文: | context.getImageData(x,y,width,height); |
|---|
パラメータ値
| パラメータ | 説明 |
|---|---|
| x | コピーを開始する左上隅の x 座標(ピクセル単位)。 |
| y | コピーを開始する左上隅の y 座標(ピクセル単位)。 |
| width | コピーする矩形領域の幅。 |
| height | コピーする矩形領域の高さ。 |

その他の例
使用する画像:

例
getImageData() を使用して、キャンバス上の画像の各ピクセルの色を反転させます:
JavaScript:
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 オブジェクト