VideoColorSpace: matrix property
Baseline 2024Newly 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.
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 |