Colorspace

Video Single output Transform

Convert between colorspaces.

FFmpeg filter: colorspace — the official reference.

Add it to a graph. The explicit form works for every filter — bind it to its input and read the result from outputs():

$node   = $video->addFilter(new Colorspace(…));
$result = $node->outputs()[0];

Shorthand. Single-output filters can skip the node — apply() returns the result stream directly:

$result = $video->apply(new Colorspace(…));

When to use it

TODO — when this filter shines: what it’s the right tool for, what to reach for instead when it isn’t, and how it composes with neighbouring filters.

How to use it

TODO — prose: how the filter actually works and what its key parameters mean (the explanation FFmpeg’s terse option help omits).

Examples

TODO — runnable PHP, with the equivalent ffmpeg CLI alongside.

Gotchas

TODO

See also

TODO

Parameters

Parameter	Type	Default	Range / values	Description
all	ColorspaceAll	0	bt470m, bt470bg, bt601-6-525, bt601-6-625, bt709, smpte170m, smpte240m, bt2020	Set all color properties together
space	ColorspaceCsp	2	bt709, fcc, bt470bg, smpte170m, smpte240m, ycgco, gbr, bt2020ncl	Output colorspace
range	ColorspaceRng	0	mpeg, jpeg	Output color range
primaries	ColorspacePrm	2	bt709, bt470m, bt470bg, smpte170m, smpte240m, smpte428, film, smpte431, …	Output color primaries
trc	ColorspaceTrc	2	bt709, gamma22, bt470bg, smpte170m, smpte240m, linear, iec61966-2-1, iec61966-2-4, …	Output transfer characteristics
format	ColorspaceFmt	-1	yuv420p, yuv420p10, yuv420p12, yuv422p, yuv422p10, yuv422p12, yuv444p, yuv444p10, …	Output pixel format
fast	bool	false	—	Ignore primary chromaticity and gamma correction
dither	ColorspaceDither	none	none, fsb	Dithering mode
wpadapt	ColorspaceWpadapt	bradford	bradford, vonkries, identity	Whitepoint adaptation method
iall	ColorspaceAll	0	bt470m, bt470bg, bt601-6-525, bt601-6-625, bt709, smpte170m, smpte240m, bt2020	Set all input color properties together
ispace	ColorspaceCsp	2	bt709, fcc, bt470bg, smpte170m, smpte240m, ycgco, gbr, bt2020ncl	Input colorspace
irange	ColorspaceRng	0	mpeg, jpeg	Input color range
iprimaries	ColorspacePrm	2	bt709, bt470m, bt470bg, smpte170m, smpte240m, smpte428, film, smpte431, …	Input color primaries
itrc	ColorspaceTrc	2	bt709, gamma22, bt470bg, smpte170m, smpte240m, linear, iec61966-2-1, iec61966-2-4, …	Input transfer characteristics

---

Maps to FFmpeg’s colorspace filter. Verified against ffmpeg n7.1.1.