Unsharp

Video Single output Transform

Sharpen or blur the input video.

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

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

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

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_msize_x	int	5	3–23	set luma matrix horizontal size
luma_msize_y	int	5	3–23	set luma matrix vertical size
luma_amount	float	1	-2–5	set luma effect strength
chroma_msize_x	int	5	3–23	set chroma matrix horizontal size
chroma_msize_y	int	5	3–23	set chroma matrix vertical size
chroma_amount	float	0	-2–5	set chroma effect strength
alpha_msize_x	int	5	3–23	set alpha matrix horizontal size
alpha_msize_y	int	5	3–23	set alpha matrix vertical size
alpha_amount	float	0	-2–5	set alpha effect strength

FFmpeg also names these options (use the parameter shown above): lx → luma_msize_x, ly → luma_msize_y, la → luma_amount, cx → chroma_msize_x, cy → chroma_msize_y, ca → chroma_amount, ax → alpha_msize_x, ay → alpha_msize_y, aa → alpha_amount.

---

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