HTML canvas putImageData()メソッド

HTML canvas 参考手册HTML 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 は putImageData() メソッドをサポートしています。

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


定義と使用方法

putImageData() メソッドは、指定された ImageData オブジェクトからの画像データをキャンバスに戻します。

ヒント:参照:getImageData()メソッド。キャンバス上の指定した矩形のピクセルデータをコピーします。

ヒント:参照:createImageData()メソッド。新しい空白の ImageData オブジェクトを作成します。


JavaScript 構文

JavaScript 構文: context.putImageData(imgData,x,y,dirtyX,dirtyY,dirtyWidth,dirtyHeight);

パラメータ値

パラメータ 説明
imgData キャンバスに戻す ImageData オブジェクトを指定します。
x ImageData オブジェクトの左上隅の x 座標(ピクセル単位)。
y ImageData オブジェクトの左上隅の y 座標(ピクセル単位)。
dirtyX 任意。画像をキャンバス上に配置する位置の水平値(x)(ピクセル単位)。
dirtyY 任意。画像をキャンバス上に配置する位置の垂直値(y)(ピクセル単位)。
dirtyWidth 任意。キャンバス上に画像を描画する際に使用する幅。
dirtyHeight 任意。キャンバス上に画像を描画する際に使用する高さ。


HTML canvas 参考手册HTML canvas リファレンスマニュアル その他の拡張