HTML canvas getImageData()メソッド

HTML canvas 参考手册HTML canvas リファレンス

例

次のコードは、getImageData() を使用してキャンバス上の指定された矩形のピクセルデータをコピーし、次に putImageData() を使用して画像データをキャンバスに戻します:

const canvas = document.getElementById("myCanvas"); const ctx = canvas.getContext("2d"); ctx.fillStyle = "red"; ctx.fillRect(10, 10, 50, 50); function copy() { const 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);

試してみる »


HTML canvas 参考手册HTML canvas リファレンス その他の拡張