Curves

Video Single output Transform

Adjust components curves.

FFmpeg filter: curves — 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 Curves(…));
$result = $node->outputs()[0];

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

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

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
preset	CurvesPresetName	none	none, color_negative, cross_process, darker, increase_contrast, lighter, linear_contrast, medium_contrast, …	select a color curves preset
master	string	—	—	set master points coordinates
red	string	—	—	set red points coordinates
green	string	—	—	set green points coordinates
blue	string	—	—	set blue points coordinates
all	string	—	—	set points coordinates for all components
psfile	string	—	—	set Photoshop curves file name
plot	string	—	—	save Gnuplot script of the curves in specified file
interp	CurvesInterpName	natural	natural, pchip	specify the kind of interpolation

FFmpeg also names these options (use the parameter shown above): m → master, r → red, g → green, b → blue.

---

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