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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
matrix

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support