Expand description
HRTF — analytic + KemarLite embedded tables (zero-heap hot path).
Full measured KEMAR datasets are optional cold assets; default hot path uses KemarLite
(8-azimuth ITD/ILD samples) with analytic Woodworth/Rayleigh fallback delegated to
etalon_signal::audio.
Structs§
- Binaural
Gains - Binaural staging gains + ITD for stereo worklet.
Enums§
- Hrtf
Profile - HRTF synthesis profile (hot path).
Constants§
- DEFAULT_
HEAD_ RADIUS_ M - Standard anthropometric spherical-head radius in meters (8.75 cm).
- DEFAULT_
SPEED_ OF_ SOUND_ M_ S - Standard speed of sound in dry air at 20 °C in m/s.
Functions§
- binaural_
analytic - Analytic binaural gains — azimuth ∈ [-π, π], elevation ∈ [-π/2, π/2].
- binaural_
from_ position - Dispatch binaural model from active
HrtfProfile. - binaural_
kemar_ lite - KemarLite binaural — interpolated embedded ITD/ILD tables.
- binaural_
render - Render a
monosource atsource(world space) into a binaural pair. - convolve_
fir - Direct linear (FIR) convolution:
y[i] = Σ_j signal[j]·h[i-j]. - head_
relative_ position - Rotate source position into head frame (listener at origin, yaw around Y),
delegated to
etalon_signal::audio::head_relative_position. - hrtf_
profile - The currently selected process-global HRTF profile.
- pinna_
elevation_ notch_ hz - Anthropometric pinna concha primary spectral notch center frequency in Hz
for vertical
elevation_rad$\in [-\pi/2, \pi/2]$ (Hebrank & Wright / Lopez-Poveda model). - room_
damp_ from_ manifold - Manifold
wbiases room absorption (higher w → softer highs). - set_
hrtf_ profile - Select the process-global HRTF profile used by the hot path
(
AnalyticorKemarLite; defaultKemarLite). - spherical_
ild_ db - Spherical-head Rayleigh / Brown-Duda diffraction Interaural Level Difference (ILD) in dB
as a function of horizontal
azimuth_radandfrequency_hz. - synthesize_
hrir - Synthesize left/right HRIRs from
gains, delegated toetalon_signal::audio::synthesize_hrir_into. - woodworth_
itd_ seconds - Woodworth / Rayleigh spherical-head Interaural Time Difference (ITD) in seconds:
$$\text{ITD}(\theta) = \operatorname{sign}(\theta) \cdot \frac{a}{c}\left(\phi + \sin\phi\right)$$
where $\phi = \arcsin(\sin|\theta|) \in [0, \pi/2]$ is the lateral angle from the median plane,
$a$ is
head_radius_m($> 0$), and $c$ isspeed_of_sound_m_s($> 0$).