The ImageData interface represents the underlying pixel data of an area of a <canvas> element. It is created using the ImageData() constructor or creator methods on the CanvasRenderingContext2D object associated with a canvas: createImageData() and getImageData(). It can also be used to set a part of the canvas by using putImageData().

Constructors

ImageData()
Creates an ImageData object from a given Uint8ClampedArray and the size of the image it contains. If no array is given, it creates an image of a black rectangle. Note that this is the most common way to create such an object in workers as createImageData() is not available there.

Properties

ImageData.data Read only
Is a Uint8ClampedArray representing a one-dimensional array containing the data in the RGBA order, with integer values between 0 and 255 (included).
ImageData.height Read only
Is an unsigned long representing the actual height, in pixels, of the ImageData.
ImageData.width Read only
Is an unsigned long representing the actual width, in pixels, of the ImageData.

Specifications

Specification Status Comment
WHATWG HTML Living Standard
The definition of 'ImageData' in that specification.
Living Standard  

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 4.0 14 (14) 9.0 9.0 3.1
Support in workers (Yes) 25 (25) ? ? ?
ImageData() constructor 43 29 (29) No support 30 ?
Feature Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support 2.1 (Yes) 14.0 (14) ? 10.0 3.2 (Yes)
Support in workers ? (Yes) 25.0 (25) ? ? ? (Yes)
ImageData() constructor ? (Yes) 29.0 (29) ? ? ? (Yes)

See also

Document Tags and Contributors

 Last updated by: jpmedley,