Boxblur

Video Single output Transform

Blur the input.

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

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

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

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
luma_radius	string	2	—	Radius of the luma blurring box
luma_power	int	2	≥ 0	How many times should the boxblur be applied to luma
chroma_radius	string	—	—	Radius of the chroma blurring box
chroma_power	int	-1	≥ -1	How many times should the boxblur be applied to chroma
alpha_radius	string	—	—	Radius of the alpha blurring box
alpha_power	int	-1	≥ -1	How many times should the boxblur be applied to alpha

FFmpeg also names these options (use the parameter shown above): lr → luma_radius, lp → luma_power, cr → chroma_radius, cp → chroma_power, ar → alpha_radius, ap → alpha_power.

---

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