Waveform

Video Single output Transform

Video waveform monitor.

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

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

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

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
mode	WaveformMode	column	row, column	set mode
intensity	float	0.04	0–1	set intensity
mirror	bool	true	—	set mirroring
display	WaveformDisplay	stack	overlay, stack, parade	set display mode
components	int	1	1–15	set components to display
envelope	WaveformEnvelope	none	none, instant, peak, peak+instant	set envelope to display
filter	WaveformFilter	lowpass	lowpass, flat, aflat, chroma, color, acolor, xflat, yflat	set filter
graticule	WaveformGraticule	none	none, green, orange, invert	set graticule
opacity	float	0.75	0–1	set graticule opacity
flags	int|string	1	—	set graticule flags
scale	WaveformScale	digital	digital, millivolts, ire	set scale
bgopacity	float	0.75	0–1	set background opacity
tint0	float	0	-1–1	set 1st tint
tint1	float	0	-1–1	set 2nd tint
fitmode	WaveformFitmode	none	none, size	set fit mode
input	WaveformInput	first	all, first	set input formats selection

FFmpeg also names these options (use the parameter shown above): m → mode, i → intensity, r → mirror, d → display, c → components, e → envelope, f → filter, g → graticule, o → opacity, fl → flags, s → scale, b → bgopacity, t0 → tint0, t1 → tint1, fm → fitmode.

---

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