Headphone

Audio Single output Transform

Apply headphone binaural spatialization with HRTFs in additional streams.

FFmpeg filter: headphone — the official reference.

Add it to a graph. The explicit form works for every filter — bind it to its inputs and read the result from outputs():

$node   = $audio->addFilter(new Headphone(…), [$other]);
$result = $node->outputs()[0];

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

$result = $audio->apply(new Headphone(…), $other);

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
map	string	—	—	set channels convolution mappings
gain	float	0	-20–40	set gain in dB
lfe	float	0	-20–40	set lfe gain in dB
type	HeadphoneType	freq	time, freq	set processing
size	int	1024	1024–96000	set frame size
hrir	HeadphoneHrir	stereo	stereo, multich	set hrir format

---

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