colorspace

Convert colorspace, transfer characteristics or color primaries. Input video needs to have an even size.

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

'ycgco'

YCgCo

'bt2020ncl'

BT.2020 with non-constant luminance

'trc'

Specify output transfer characteristics.

The accepted values are:

'bt709'

BT.709

'bt470m'

BT.470M

'bt470bg'

BT.470BG

'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

'srgb'

SRGB

'iec61966-2-1'

iec61966-2-1

'iec61966-2-4'

iec61966-2-4

'xvycc'

xvycc

'bt2020-10'

BT.2020 for 10-bits content

'bt2020-12'

BT.2020 for 12-bits content

'primaries'

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

'film'

film

'smpte431'

SMPTE-431

'smpte432'

SMPTE-432

'bt2020'

BT.2020

'jedec-p22'

JEDEC P22 phosphors

'range'

Specify output color range.

The accepted values are:

'tv'

TV (restricted) range

'mpeg'

MPEG (restricted) range

'pc'

PC (full) 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)

'iall'

Override all input properties at once. Same accepted values as all.

'ispace'

Override input colorspace. Same accepted values as space.

'iprimaries'

Override input color primaries. Same accepted values as primaries.

'itrc'

Override input transfer characteristics. Same accepted values as trc.

'irange'

Override input color range. Same accepted values as range.

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