VideoColorSpace: matrix property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used 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.

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

BCD tables only load in the browser