Skip to main content

Module hoa

Module hoa 

Source
Expand description

Q05 Mode 0x0102: Higher-Order Ambisonics temporal samples (4 * (L + 1)^2 B, L = 0..=3).

Strictly distinguishes temporal HOA frames (mode 0x0102) from spectral HOA bins (mode 0x0101), supports ACN vs explicit FuMa ordering and SN3D/N3D/maxN normalization without silent relabeling, uses +X forward / +Y left / +Z up Cartesian conventions, and implements exact f64 order 0..=3 rotations.

Structs§

HoaChunkView
Zero-heap borrowed view over verified 0x0102 temporal HOA sample frames.
HoaProfileSpec
HOA stream descriptor metadata (Schema 204 + frame/rate bindings).
HoaTemporalView

Enums§

HoaDirectionConvention
HoaDomain
HoaNormalization
HoaOrdering

Constants§

HOA_MAX_CHANNELS
HOA_MAX_ORDER

Functions§

acn_sn3d_to_fuma_maxn
Exact ACN/SN3D -> FuMa (MaxN) channel reorder & normalization (order <= 3).
convert_sn3d_n3d
Converts ACN channel coefficients between SN3D and N3D normalization: N3D(l,m) = sqrt(2l+1) * SN3D(l,m).
evaluate_acn_sn3d_dir
Real Spherical Harmonic basis values for ACN / SN3D (L = 0..=3) using +X forward, +Y left, +Z up (dir must be finite unit vector in Cartesian XYZ).
hoa_channel_count
Validates order (0..=3) and returns (order + 1)^2 channel count and byte stride.
hoa_stride_bytes
read_hoa_temporal_qac
Admits and decodes mode 0x0102 temporal HOA stream; rejects spectral 0x0101 conflation.
rotate_acn_sn3d_frame
Computes exact (L+1)^2 x (L+1)^2 active rotation operator in ACN / SN3D for q.
write_hoa_temporal_qac
Writes canonical QAC v1 mode 0x0102 temporal HOA stream.