Showwaves

Audio Video Single output Transform

Convert input audio to a video output.

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

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

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

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
size	string	600x240	—	set video size
mode	ShowwavesMode	point	point, line, p2p, cline	select display mode
n	string	—	—	set how many samples to show in the same point
rate	string	25	—	set video rate
split_channels	bool	false	—	draw channels separately
colors	string	red|green|blue|yellow|orange|lime|pink|magenta|brown	—	set channels colors
scale	ShowwavesScale	lin	lin, log, sqrt, cbrt	set amplitude scale
draw	ShowwavesDraw	scale	scale, full	set draw mode

FFmpeg also names these options (use the parameter shown above): s → size, r → rate.

---

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