Expand description
.q4au v3 64-byte Spatial Acoustics container header, Higher-Order Ambisonics (HOA),
SOFA HRTF FIR table block, and v1/v2 -> v3 migration helper.
Structs§
- Q4Au
Header V3 - 64-byte cache-line-aligned spatial acoustic container header.
- Sofa
Hrir Entry - Compact SOFA HRIR measurement entry for one spherical direction.
Constants§
- NORMALIZATION_
N3D_ ACN - NORMALIZATION_
SN3D_ ACN - Channel normalization conventions stored in
Q4AuHeaderV3.channel_normalization. - Q4AU_
HOA_ MAX_ CHANNELS - Maximum channels for 3rd order ambisonics: (3 + 1)^2 = 16.
- Q4AU_
HOA_ MAX_ ORDER - Maximum supported ambisonic order (3rd order).
- Q4AU_
V3_ HEADER_ BYTES - Exact byte size of the v3 cache-line aligned header.
- Q4AU_
VERSION_ V3 - Format version for Q4AU-v3 spatial acoustic sheets.
- SOFA_
DEFAULT_ FIR_ TAPS - Default number of FIR filter taps per ear for embedded SOFA HRIR entries.
- TRANSFORM_
KIND_ CQT - TRANSFORM_
KIND_ HOA_ STFT - TRANSFORM_
KIND_ STFT - Transform kind tags stored in
Q4AuHeaderV3.transform_kind.
Functions§
- encode_
hoa_ acn_ sn3d - Zero-heap ACN / SN3D real spherical harmonics encoder for orders 0..=3.
- parse_
v3_ header - Parse v3 header from raw slice.
- sample_
sofa_ hrir_ zero_ heap - Nearest-direction lookup in a discrete SOFA HRIR table using unit-vector dot product.
- upgrade_
q4au_ v1_ or_ v2_ to_ v3 - Migrate existing Q4AU-v1 or Q4AU-v2 audio sidecar into Q4AU-v3 format.
- v3_
frame_ view - Zero-heap frame slice view for v3 sidecars.
- v3_
sofa_ table - Borrow the embedded SOFA HRIR table slice if present in the v3 container.