Expand description
Q05 Mode 0x0103: HRIR / RIR FIR taps (taps * 4 B) & legacy Q4AU v3 SOFA preservation.
Strictly separates impulse sample rate (Schema 204 keys 17/18) from measurement acquisition
cadence (Schema 3 keys 13/14), applies explicit per-receiver delays once relative to excitation
origin, and performs lossless Q4AU v3 -> QAC v1 migration retaining unparsed original bytes (Schema 209).
Structs§
- Hrir
Chunk View - Zero-heap borrowed view over verified
0x0103FIR tap records ([measurement][receiver][tap]). - Hrir
Document View - Hrir
Write Spec - Static or temporally indexed HRIR/RIR payload specification.
- Validated
Legacy Q4au V3 - Strictly validated
Q4AU v3legacy container parsed without assuming pointer alignment.
Functions§
- convolve_
hrir - Exact discrete FIR convolution for one receiver response (applying optional
delay_samplesonce). - migrate_
legacy_ q4au_ v3_ hrir - Losslessly migrates a
Q4AU v364-tap SOFA HRIR table to QAC v1 (mode 0x0103), preserving bit-exact original taps, per-ear ITD offsets, spherical directions, and exact unparsed original bytes (mode 0x0104+Schema 209). - parse_
legacy_ q4au_ v3 - Parses and validates a legacy
Q4AU v3file, rejecting truncation, overlap, tap count mismatch, non-finite floats, and WASM32 multiplication overflow. - read_
hrir_ qac - Opens and fully validates
mode 0x0103HRIR/RIR entry + optional delays & legacy origin. - sample_
delayed_ impulse - Exact fractional-delay impulse interpolation oracle (
y(t)at fractional sampleidx_f). - tap_
time_ seconds - Exact tap arrival time in seconds relative to excitation origin:
(delay_samples + tap_index) * (impulse_rate_den / impulse_rate_num). Applied ONCE. - write_
hrir_ qac - Writes canonical QAC v1
mode 0x0103HRIR/RIR container (plus optional delays & positions0x0107).