ImageData()

This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The ImageData() constructor returns a newly instantiated ImageData object build from the typed array given and having the specified width and height.

This constructor is the preferred way of creating such an object in a worker.

Syntax

var imageData = new ImageData(array, width, height);
var imageData = new ImageData(width, height);

Parameters

array Optional
A Uint8ClampedArray containing the underlying pixel representation of the image. If no such array is given, an image with a black rectangle of the given dimension will be created.
width
An unsigned long representing the width of the represented image.
 height
An unsigned long representing the height of the represented image. This value is optional if an array is given: it will be inferred from its size and the given width.

Example

var imageData = new ImageData(100, 100); // Creates a 100x100 black rectangle
// ImageData { width: 100, height: 100, data: Uint8ClampedArray[40000] }

Specification

Specification Status Comment
HTML Living Standard
The definition of 'ImageData()' in that specification.
Living Standard Initial definition.

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support42 Yes29 No29 ?
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No42 ?29 ? ?4.0

See also

 

Document Tags and Contributors

 Contributors to this page: fscholz, jpmedley, zbjornson, DevelX, teoli
 Last updated by: fscholz,