VideoColorSpace: matrix property

Baseline 2024
Newly available

Since ⁨September 2024⁩, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Note: This feature is available in Dedicated Web Workers.

The matrix read-only property of the VideoColorSpace interface returns the matrix coefficient of the video. Matrix coefficients describe the relationship between sample component values and color coordinates.

Value

A string containing one of the following values:

"rgb"

Matrix coefficients used by sRGB.

"bt709"

Matrix coefficients used by BT.709.

"bt470bg"

Matrix coefficients used by BT.601 PAL.

"smpte170m"

Matrix coefficients used by BT.601 NTSC.

"bt2020-ncl"

Matrix coefficients used by BT.2020 NCL.

Examples

In the following example, colorSpace is a VideoColorSpace object returned from VideoFrame. The value of matrix is printed to the console.

js
let colorSpace = VideoFrame.colorSpace;
console.log(colorSpace.matrix);

Specifications

Specification
WebCodecs
# dom-videocolorspace-matrix

Browser compatibility