ImageData

ImageData インターフェイスは、<canvas> 要素の領域の基礎をなすピクセルデータを表します。

ImageData() コンストラクターや、キャンバスに関連付けられた CanvasRenderingContext2D オブジェクトの createImageData() メソッドおよび getImageData() メソッドによって生成されます。ImageData は putImageData() メソッドによってキャンバスの一部を設定するのにも利用可能です。

コンストラクター

ImageData()

ImageData オブジェクトを、指定した Uint8ClampedArray または Float16Array と、それに含まれる画像のサイズから生成します。配列を指定しない場合は、透明な黒色の長方形の画像を生成します。ワーカーでは createImageData() が使用できませんので、ワーカーでこのようなオブジェクトを生成するためのもっとも一般的な手段です。

インスタンスプロパティ

ImageData.data 読取専用

Uint8ClampedArray または Float16Array で、RGBA の順でデータが格納された一次元配列を表します。データは行単位で、左上のピクセルから右下のピクセルに向かう順で格納されます。

ImageData.colorSpace 読取専用

画像データの色空間を表す文字列です。

ImageData.height 読取専用

この ImageData の実際の高さをピクセル数で表す unsigned long です。

ImageData.width 読取専用

この ImageData の実際の幅をピクセル数で表す unsigned long です。

ImageData.pixelFormat 読取専用

文字列で、ImageData で使用する形式を示します。

仕様書

ブラウザーの互換性

関連情報

• CanvasRenderingContext2D
• <canvas> 要素と、関連付けられたインターフェイスである HTMLCanvasElement。