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) | ? | ? | ? | (有) |
関連情報
CanvasRenderingContext2D
<canvas>
要素と、関連付けられたインターフェイスであるHTMLCanvasElement
。