Firefox Tomorrow

web api instance property

ImageData: colorSpace property

View on MDN ↗

Available in workers

The read-only ImageData.colorSpace property is a string indicating the color space of the image data.

The color space can be set during ImageData initialization using either the ImageData() constructor or the createImageData() method.

Value

This property can have the following values:

Examples

Getting the color space of canvas image data

The getImageData() method allows you to explicitly request a color space. If it doesn’t match the color space the canvas was initialized with, a conversion will be performed. Use the colorSpace property to know which color space your ImageData object is in.

const context = canvas.getContext("2d", { colorSpace: "display-p3" });
context.fillStyle = "color(display-p3 0.5 0 0)";
context.fillRect(0, 0, 10, 10);

const p3ImageData = context.getImageData(0, 0, 1, 1);
console.log(p3ImageData.colorSpace); // "display-p3"

const srgbImageData = context.getImageData(0, 0, 1, 1, { colorSpace: "srgb" });
console.log(srgbImageData.colorSpace); // "srgb"

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also