Deshake

Video Single output Transform

Stabilize shaky video.

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

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

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

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
x	int	-1	≥ -1	set x for the rectangular search area
y	int	-1	≥ -1	set y for the rectangular search area
w	int	-1	≥ -1	set width for the rectangular search area
h	int	-1	≥ -1	set height for the rectangular search area
rx	int	16	0–64	set x for the rectangular search area
ry	int	16	0–64	set y for the rectangular search area
edge	DeshakeEdge	mirror	blank, original, clamp, mirror	set edge mode
blocksize	int	8	4–128	set motion search blocksize
contrast	int	125	1–255	set contrast threshold for blocks
search	DeshakeSmode	exhaustive	exhaustive, less	set search strategy
filename	string	—	—	set motion search detailed log file name
opencl	bool	false	—	ignored

---

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