Perspective

Video Single output Transform

Correct the perspective of video.

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

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

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

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
x0	string	0	—	set top left x coordinate
y0	string	0	—	set top left y coordinate
x1	string	W	—	set top right x coordinate
y1	string	0	—	set top right y coordinate
x2	string	0	—	set bottom left x coordinate
y2	string	H	—	set bottom left y coordinate
x3	string	W	—	set bottom right x coordinate
y3	string	H	—	set bottom right y coordinate
interpolation	PerspectiveInterpolation	linear	linear, cubic	set interpolation
sense	PerspectiveSense	source	source, destination	specify the sense of the coordinates
eval	PerspectiveEval	init	init, frame	specify when to evaluate expressions

---

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