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の実際の高さをピクセル数で表すunsignedlongです。ImageData.width読取専用ImageDataの実際の幅をピクセル数で表すunsignedlongです。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| 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) | ? | ? | ? | (有) |
関連情報
CanvasRenderingContext2D<canvas>要素と、関連付けられたインターフェイスであるHTMLCanvasElement。