Color Space¶

Description

This effect/filter converts color space, transfer characteristics or color primaries. Input video needs to have an even size.

The filter converts the transfer characteristics, color space and color primaries to the specified user values. The output value, if not specified, is set to a default value based on the Color properties property. If that property is also not specified, the filter will log an error. The output color range and format default to the same value as the input color range and format. The input transfer characteristics, color space, color primaries and color range should be set on the input data. If any of these are missing, the filter will log an error and no conversion will take place.

Parameters

Parameter	Value	Description
Color properties	Selection	Specify all color properties at once
Output Color Space	Selection	Specifies output color space
Output transfer characteristics	Selection	Specifies output transfer characteristics
Output Color Primaries	Selection	Specifies output color primaries
Output Color Range	Selection	Specifies output color range
Output Color Format	Selection	Specifies output color format
Fast Conversion	Switch	Do a fast conversion, which skips gamma/primary correction. This will take significantly less CPU, but will be mathematically incorrect. To get output compatible with that produced by the Color Matrix filter, switch it on.
Dithering Mode	Selection	Specifies dithering mode
Whitepoint adaption mode	Selection	Specifies whitepoint adaptation mode
Override all input properties at once	Selection
Override input colorspace	Selection
Override input color primaries	Selection
Override input transfer characteristics	Selection
Override input color range	Selection

The following selection items are available:

Color properties Override all input properties at once

BT.709	Default
BT.470M
BT.470BG
BT601-6 525
BT601-6 625
SMPTE-170M
SMPTE-240M
BT.2020

Output Color Space Override input colorspace

BT.709	Default
FCC
BT.470BG (BT.470BG or BT.601-6 625)
SMPTE-170M (SMPTE-170M or BT.601-6 525)
SMPTE-240M
YCgCo
BT.2020 non-constant luma

Output transfer characteristics Override input transfer characteristics

BT.709	Default
BT.470M
BT.470BG
Constant Gamma of 2.2
Constant Gamma of 2.8
SMPTE-170M (SMPTE-170M, BT.601-6 525 or BT.601-6 525)
SMPTE-240M
SRGB
iec61966-2-1
iec61966-2-4
xvycc
BT.2020 for 10-bits constant
BT.2020 for 12-bits constant

Output Color Primaries Override input color primaries

BT.709	Default
BT.470M
BT.470BG (BT.470BG or BT.601-6 625)
SMPTE-170M (SMPTE-170M or BT.601-6 525)
SMPTE-240M
Film
BT.2020
SMPTE-431
SMPTE-432
JEDEC-PT22 phosphors

Output Color Range

TV (restricted range)
MPEG (restricted range)
PC (FULLrange)	Default
JPEG (FULL range)

Output Color Format

YUV 4:2:0 planar 8-bits / 10-bits / 12-bits	Default is 8-bits
YUV 4:2:2 planar 8-bits / 10-bits / 12-bits
YUV 4:4:4 planar 8-bits / 10-bits / 12-bits

Dithering Mode

No dithering	Default
Floyd-Steinberg dithering

Whitepoint adaption mode

Identity whitepoint adaptation (no whitepoint adaptation)	Default
Bradford whitepoint adaptation
von Kries whitepoint adaptation

For the technical inclined there is a list of detailed Color Space Descriptions available in the Linux Kernel documentation.