ImageData: pixelFormat property
Note: This feature is available in Web Workers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The read-only ImageData.pixelFormat property is a string indicating the pixel format of the image data.
The pixel format can be set during ImageData initialization using either the ImageData() constructor or the createImageData() method.
Value
This property can have the following values:
"rgba-unorm8"representing RGBA with 8 bit per component unsigned normalized format, using aUint8ClampedArray."rgba-float16"representing RGBA with 16 bits per component, using aFloat16Array. Floating-point pixel values allow representing colors in arbitrarily wide gamuts and high dynamic range (HDR).
Examples
Floating-point pixel data for wide gamuts and high dynamic range (HDR)
Floating-point pixel values allow representing colors in arbitrarily wide gamuts and high dynamic range (HDR). You can set the pixelFormat setting to "rgba-float16" to use RGBA values with 16 bits per component. This requires the dataArray to be a Float16Array.
let floatArray = new Float16Array(4 * 200 * 200);
let imageData = new ImageData(floatArray, 200, 200, {
pixelFormat: "rgba-float16",
});
console.log(imageData.pixelFormat); // "rgba-float16"
Specifications
| Specification |
|---|
| HTML # dom-imagedata-pixelformat |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
pixelFormat
|
|
|
|
|
|
|
|
|
|
|
|
|
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.