Skip to main content

Module audio_spectral_sheet_v3

Module audio_spectral_sheet_v3 

Source
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§

Q4AuHeaderV3
64-byte cache-line-aligned spatial acoustic container header.
SofaHrirEntry
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.