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.
Note: This feature is available in Web Workers.
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
ImageDataobject from a givenUint8ClampedArrayorFloat16Arrayand the size of the image it contains. If no array is given, it creates an image of a transparent black rectangle. Note that this is the most common way to create such an object in workers ascreateImageData()is not available there.
Instance properties
ImageData.dataRead only-
A
Uint8ClampedArrayorFloat16Arrayrepresenting a one-dimensional array containing the data in the RGBA order. The order goes by rows from the top-left pixel to the bottom-right. ImageData.colorSpaceRead only-
A string indicating the color space of the image data.
ImageData.heightRead only-
An
unsigned longrepresenting the actual height, in pixels, of theImageData. ImageData.widthRead only-
An
unsigned longrepresenting the actual width, in pixels, of theImageData. ImageData.pixelFormatRead only-
A string indicating the format to use for the
ImageData.
Specifications
| Specification |
|---|
| HTML # imagedata |
Browser compatibility
| desktop | mobile | server | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ImageData
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ImageData() constructor
|
|
|
|
|
|
|
|
|
|
|
|
|
|
ImageData.settings_parameter
|
|
|
|
|
|
|
|
|
|
|
|
|
|
settings_parameter.colorSpace_option
|
|
|
|
|
|
|
|
|
|
|
|
|
|
pixelFormat option
|
|
|
|
|
|
|
|
|
|
|
|
|
|
colorSpace
|
|
|
|
|
|
|
|
|
|
|
|
|
|
data
|
|
|
|
|
|
|
|
|
|
|
|
|
|
height
|
|
|
|
|
|
|
|
|
|
|
|
|
|
pixelFormat
|
|
|
|
|
|
|
|
|
|
|
|
|
|
width
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Available in workers
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
See also
CanvasRenderingContext2D- The
<canvas>element and its associated interface,HTMLCanvasElement.