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.
Want more support for this feature? Tell us why.
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.
let colorSpace = VideoFrame.colorSpace;
console.log(colorSpace.matrix);
Specifications
| Specification |
|---|
| WebCodecs # dom-videocolorspace-matrix |