Deband

Video Single output Transform

Debands video.

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

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

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

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
_1thr	float	0.02	3.0E-5–0.5	set 1st plane threshold
_2thr	float	0.02	3.0E-5–0.5	set 2nd plane threshold
_3thr	float	0.02	3.0E-5–0.5	set 3rd plane threshold
_4thr	float	0.02	3.0E-5–0.5	set 4th plane threshold
range	int	16	—	set range
direction	float	6.2831853071796	-6.2831853071796–6.2831853071796	set direction
blur	bool	true	—	set blur
coupling	bool	false	—	set plane coupling

FFmpeg also names these options (use the parameter shown above): r → range, d → direction, b → blur, c → coupling.

---

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