ImageData

ImageData インターフェイスは、<canvas> 要素の領域の基礎をなすピクセルデータを表します。ImageData() コンストラクターや、canvas に関連付けられた CanvasRenderingContext2D オブジェクトの createImageData() メソッドおよび getImageData() メソッドによって生成されます。ImageData は putImageData() メソッドの第 1 引数として利用可能です。

コンストラクター

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

プロパティ

ImageData.data 読取専用
RGBA の順で 0 から 255 の間の整数 (両端の値を含む) を並べたデータを持つ 1 次元配列を表す Uint8ClampedArray です。
ImageData.height 読取専用
ImageData の実際の高さをピクセル数で表す unsigned long です。
ImageData.width 読取専用
ImageData の実際の幅をピクセル数で表す unsigned long です。

仕様

仕様書 策定状況 コメント
HTML Living Standard
ImageData の定義		 現行の標準  

ブラウザー実装状況

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから！
機能 Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 4.0 (有) 14 (14) 9.0 9.0 3.1
worker でサポート (有) ? 25 (25) ? ? ?
ImageData() constructor 43 (有) 29 (29) 未サポート 30 ?
機能 Android Android Webview Edge Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Android 版 Chrome
基本サポート 2.1 (有) (有) 14.0 (14) ? 10.0 3.2 (有)
worker でサポート ? (有) ? 25.0 (25) ? ? ? (有)
ImageData() constructor ? (有) (有) 29.0 (29) ? ? ? (有)

関連情報