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
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)
Not supported
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
Contributors to this page:
jpmedley ,
pci ,
hbloomer ,
PikadudeNo1 ,
pjbaron ,
fscholz ,
svr93 ,
teoli ,
spleen387 ,
KarlGl ,
nehasharma ,
Bobo ,
Sheppy ,
tolki ,
ethertank ,
ziyunfei ,
Brettz9
Last updated by:
jpmedley ,
Dec 2, 2015, 11:02:53 AM