Convert colorspace, transfer characteristics or color primaries.
The filter accepts the following options:
- all
-
Specify all color properties at once.
The accepted values are:
- bt470m
-
BT.470M
- bt470bg
-
BT.470BG
- bt601-6-525
-
BT.601-6 525
- bt601-6-625
-
BT.601-6 625
- bt709
-
BT.709
- smpte170m
-
SMPTE-170M
- smpte240m
-
SMPTE-240M
- bt2020
-
BT.2020
- space
-
Specify output colorspace.
The accepted values are:
- bt709
-
BT.709
- fcc
-
FCC
- bt470bg
-
BT.470BG or BT.601-6 625
- smpte170m
-
SMPTE-170M or BT.601-6 525
- smpte240m
-
SMPTE-240M
- bt2020ncl
-
BT.2020 with non-constant luminance
- trc
-
Specify output transfer characteristics.
The accepted values are:
- bt709
-
BT.709
- gamma22
-
Constant gamma of 2.2
- gamma28
-
Constant gamma of 2.8
- smpte170m
-
SMPTE-170M, BT.601-6 625 or BT.601-6 525
- smpte240m
-
SMPTE-240M
- bt2020-10
-
BT.2020 for 10-bits content
- bt2020-12
-
BT.2020 for 12-bits content
- prm
-
Specify output color primaries.
The accepted values are:
- bt709
-
BT.709
- bt470m
-
BT.470M
- bt470bg
-
BT.470BG or BT.601-6 625
- smpte170m
-
SMPTE-170M or BT.601-6 525
- smpte240m
-
SMPTE-240M
- bt2020
-
BT.2020
- rng
-
Specify output color range.
The accepted values are:
- mpeg
-
MPEG (restricted) range
- jpeg
-
JPEG (full) range
- format
-
Specify output color format.
The accepted values are:
- yuv420p
-
YUV 4:2:0 planar 8-bits
- yuv420p10
-
YUV 4:2:0 planar 10-bits
- yuv420p12
-
YUV 4:2:0 planar 12-bits
- yuv422p
-
YUV 4:2:2 planar 8-bits
- yuv422p10
-
YUV 4:2:2 planar 10-bits
- yuv422p12
-
YUV 4:2:2 planar 12-bits
- yuv444p
-
YUV 4:4:4 planar 8-bits
- yuv444p10
-
YUV 4:4:4 planar 10-bits
- yuv444p12
-
YUV 4:4:4 planar 12-bits
- fast
-
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 colormatrix filter, use fast=1.
- dither
-
Specify dithering mode.
The accepted values are:
- none
-
No dithering
- fsb
-
Floyd-Steinberg dithering
- wpadapt
-
Whitepoint adaptation mode.
The accepted values are:
- bradford
-
Bradford whitepoint adaptation
- vonkries
-
von Kries whitepoint adaptation
- identity
-
identity whitepoint adaptation (i.e. no whitepoint adaptation)
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 "all" 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.
For example to convert the input to SMPTE-240M, use the command:
colorspace=smpte240m