Ahistogram

Audio Video Single output Transform

Convert input audio to histogram video output.

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

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

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

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
dmode	AhistogramDmode	single	single, separate	set method to display channels
rate	string	25	—	set video rate
size	string	hd720	—	set video size
scale	AhistogramScale	log	log, sqrt, cbrt, lin, rlog	set display scale
ascale	AhistogramAscale	log	log, lin	set amplitude scale
acount	int	1	-1–100	how much frames to accumulate
rheight	float	0.1	0–1	set histogram ratio of window height
slide	AhistogramSlide	replace	replace, scroll	set sonogram sliding
hmode	AhistogramHmode	abs	abs, sign	set histograms mode

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

---

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