Expand description
Epic 8: Scene-synchronized 3D Holosonic Wavefield & Multi-Bus HRTF Audio Graph with SDF + BVH occlusion. Scene-Synchronized 3D Holosonic Wavefield & HRTF Audio Graph with Shared SDF + BVH Acoustic Occlusion.
Implements Epic 8 of the QualiaDB Superior Game Engine architecture:
- Synchronizes observer
AudioListenerPosedirectly from camera PGA [Motor] (r,d). - Manages up to
MAX_SCENE_AUDIO_EMITTERS= 64 active scene emitters (HolosonicNodes + point/ambient emitters) sharing analytical SDF geometry ([HolographicNodeGpu] /PROC1) and epistemic certainty $q$. - Evaluates zero-heap acoustic occlusion (
evaluate_acoustic_occlusion_zero_heap) against analytical SDF primitives (sphere, capsule, rounded box) and BVH AABB/triangle obstacles with material-specific absorption coefficients (rock/lithology, timber/trunk, foliage canopy, water surface). - Computes frequency-dependent RBJ low-pass biquad coefficients, direct-path transmission loss, Fresnel/grazing phase diffraction delay $\Delta\phi$, and 6-tap early reflection geometry delays.
- Executes a zero-heap 4-bus effect graph (
SceneAudioBusGraph):DirectBinauralBus: Continuous Holosonic wave superposition, per-emitter DF2T biquad occlusion low-pass filtering, and zero-heap HRIR FIR binaural convolution (ITD + ILD + head-shadow).EarlyReflectionsBus: 6-tap stereo early reflection delay line driven by obstacle geometry.LateReverbFreeverbBus: Zero-heap stereo Schroeder/Freeverb 4-comb + 2-allpass reverb network modulated by canyon/canopy enclosure density and manifold weight $w$.HolosonicTelemetryBus: Fixed ring buffer of 48-byteHolosonicSonicToken48records + SPSC publication into theQ42U3SonicTokenRing.
Modules§
- pcm
- Caller-buffered PCM rendering through the existing scene acoustic buses. Scheduling, decoding, resampling, authorization and device output belong to the host. The active graph capacity is not a limit on authored source count.
- pcm_
schedule - Transactional event-span PCM scheduling over existing scene acoustic buses. Host owners supply a complete immutable authorized clip view and exact 48 kHz frame clock. This is render state, not a persisted timeline.
- source_
coupling - Source/pose leases over the existing PCM scheduler. No clock, player, codec, device queue or new DSP is owned here. Host admission remains authoritative.
Structs§
- Acoustic
Obstacle - An acoustic obstacle in the shared SDF + BVH scene.
- Acoustic
Occlusion Result - Result of zero-heap acoustic occlusion evaluation between an emitter and the listener.
- Audio
Listener Pose - Observer audio listener pose synchronized from the camera’s 3D PGA
Motor. - Direct
Binaural Bus - Bus 1: Direct Binaural Bus — per-emitter DF2T occlusion low-pass filter + zero-heap HRIR FIR convolution (ITD fractional delay + ILD + contralateral head-shadow).
- Early
Reflections Bus - Bus 2: 6-Tap Early Reflections Bus — stereo multi-tap delay line driven by scene geometry.
- Holosonic
Node - Scene-synchronized Holosonic / point / ambient audio emitter node.
- Holosonic
Telemetry Bus - Bus 4: Fixed-capacity ring buffer of 48-byte
HolosonicSonicToken48telemetry tokens. - Late
Reverb Freeverb Bus - Bus 3: Zero-Heap Stereo Freeverb Bus (4 parallel comb filters + 2 series all-pass filters per ear) driven by local canyon/canopy enclosure metrics.
- Scene
Audio BusGraph - Complete Scene-Synchronized 3D Holosonic Wavefield & Multi-Bus HRTF Audio Graph.
- Zero
Heap Allpass Filter - Zero-heap Schroeder all-pass diffuser stage for Freeverb.
- Zero
Heap Comb Filter - Zero-heap Schroeder/Moorer low-pass feedback comb filter for Freeverb.
Enums§
- Acoustic
Material - Physical surface & volumetric material class governing acoustic absorption, transmission loss, and early reflection scattering.
- Acoustic
Obstacle Shape - Shared analytical SDF and BVH B-Rep obstacle shapes for zero-heap acoustic ray/cone queries.
Constants§
- EARLY_
REFLECTION_ TAPS - Number of early reflection geometry delay taps per acoustic occlusion evaluation.
- HOLOSONIC_
TELEMETRY_ RING_ CAP - Fixed capacity of the 48-byte
HolosonicSonicToken48telemetry ring buffer. - MAX_
SCENE_ AUDIO_ EMITTERS - Maximum active scene audio emitters processed in the zero-heap audio graph.
- ZERO_
HEAP_ HRIR_ TAPS - Zero-heap per-emitter short HRIR FIR tap count for real-time binaural convolution.
Functions§
- calc_
rbj_ lowpass_ coeffs - Computes normalized RBJ cookbook 2nd-order low-pass
BiquadCoeffsin zero heap. - evaluate_
acoustic_ occlusion_ zero_ heap - Evaluates zero-heap acoustic occlusion, Fresnel SDF grazing diffraction, low-pass biquad cutoff,
and 6-tap early reflection geometry delays between
listener_posandemitter_pos.