VideoColorSpace: VideoColorSpace() constructor

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 VideoColorSpace() constructor creates a new VideoColorSpace object which represents a video color space.

Syntax

js
new VideoColorSpace()
new VideoColorSpace(options)

Parameters

All values default to null when they are not present.

options Optional

An object containing the following:

primaries Optional

One of the following strings:

  • "bt709"
  • "bt470bg"
  • "smpte170m"
transfer Optional

One of the following strings:

  • "bt709"
  • "smpte170m"
  • "iec61966-2-1"
matrix Optional

One of the following strings:

  • "rgb"
  • "bt709"
  • "bt470bg"
  • "smpte170m"
fullRange Optional

A Boolean, true if full-range color values are used in the video.

Examples

The following example creates a new VideoColorSpace object with VideoColorSpace.primaries set to "bt709", and VideoColorSpace.primaries set to true.

js
const options = {
  primaries: "bt709",
  fullRange: true,
};

const colorSpace = new VideoColorSpace(options);
console.log(colorSpace);

Specifications

Specification
WebCodecs
# dom-videocolorspace-videocolorspace

Browser compatibility

BCD tables only load in the browser