Oscilloscope

Video Single output Transform

2D Video Oscilloscope.

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

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

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

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	float	0.5	0–1	set scope x position
y	float	0.5	0–1	set scope y position
s	float	0.8	0–1	set scope size
t	float	0.5	0–1	set scope tilt
o	float	0.8	0–1	set trace opacity
tx	float	0.5	0–1	set trace x position
ty	float	0.9	0–1	set trace y position
tw	float	0.8	0.1–1	set trace width
th	float	0.3	0.1–1	set trace height
c	int	7	0–15	set components to trace
g	bool	true	—	draw trace grid
st	bool	true	—	draw statistics
sc	bool	true	—	draw scope

---

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