Huesaturation

Video Single output Transform

Apply hue-saturation-intensity adjustments.

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

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

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

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
hue	float	0	-180–180	set the hue shift
saturation	float	0	-1–1	set the saturation shift
intensity	float	0	-1–1	set the intensity shift
colors	int|string	63	—	set colors range
strength	float	1	0–100	set the filtering strength
rw	float	0.333	0–1	set the red weight
gw	float	0.334	0–1	set the green weight
bw	float	0.333	0–1	set the blue weight
lightness	bool	false	—	set the preserve lightness

---

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