ImageData

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

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

メモ: この機能はウェブワーカー内で利用可能です。

コンストラクター

ImageData()

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

インスタンスプロパティ

ImageData.data 読取専用

RGBA の順で 0 から 255 の間の整数 (両端の値を含む) を並べたデータを持つ 1 次元配列を表す Uint8ClampedArray です。データは行単位で、左上のピクセルから右下のピクセルに向かう順で格納されます。

ImageData.colorSpace 読取専用

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

ImageData.height 読取専用

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

ImageData.width 読取専用

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

仕様書

Specification
HTML
# imagedata

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
ImageData
ImageData() constructor
colorSpace
data
height
width
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

関連情報