pub struct SceneAudioBusGraph {
pub listener: AudioListenerPose,
pub wavefield: HolosonicWavefield,
pub emitters: [HolosonicNode; 64],
pub occlusions: [AcousticOcclusionResult; 64],
pub emitter_count: usize,
pub direct_binaural_bus: DirectBinauralBus,
pub early_reflections_bus: EarlyReflectionsBus,
pub late_reverb_bus: LateReverbFreeverbBus,
pub telemetry_bus: HolosonicTelemetryBus,
}Expand description
Complete Scene-Synchronized 3D Holosonic Wavefield & Multi-Bus HRTF Audio Graph.
Fields§
§listener: AudioListenerPoseObserver listener pose synchronized from camera PGA Motor.
wavefield: HolosonicWavefieldPrimary Holosonic wavefield engine (preserved and synchronized with emitters).
emitters: [HolosonicNode; 64]Up to 64 active scene audio emitters (HolosonicNodes + point/ambient sources).
occlusions: [AcousticOcclusionResult; 64]Cached per-emitter acoustic occlusion state.
emitter_count: usizeNumber of active emitters in emitters.
direct_binaural_bus: DirectBinauralBusBus 1: Direct binaural FIR + DF2T biquad occlusion bus.
early_reflections_bus: EarlyReflectionsBusBus 2: 6-tap early reflections bus.
late_reverb_bus: LateReverbFreeverbBusBus 3: Stereo Freeverb late reverb bus.
telemetry_bus: HolosonicTelemetryBusBus 4: 48-byte SonicToken telemetry ring buffer.
Implementations§
Source§impl SceneAudioBusGraph
impl SceneAudioBusGraph
Sourcepub fn render_pcm_quantum_zero_heap(
&self,
state: &mut PcmRenderState,
voices: &[PcmVoiceBlock<'_>],
obstacles: &[AcousticObstacle],
budget: PcmRenderBudget,
out_l: &mut [f32],
out_r: &mut [f32],
) -> Result<PcmRenderReport, PcmRenderError>
pub fn render_pcm_quantum_zero_heap( &self, state: &mut PcmRenderState, voices: &[PcmVoiceBlock<'_>], obstacles: &[AcousticObstacle], budget: PcmRenderBudget, out_l: &mut [f32], out_r: &mut [f32], ) -> Result<PcmRenderReport, PcmRenderError>
Render authorized, caller-scheduled PCM voices through scene distance, occlusion, existing binaural, early-reflection and late-reverb buses. Validation errors leave outputs/state unchanged. Unexpected DSP failure clears the outputs and resets PCM state. Output is limited to ±1 and the report counts limited samples; this is not a mastering/normalization pass.
The shared early bus uses gain-weighted geometry from active voices. This is an explicit room approximation, not per-source path tracing. Doppler, propagation time and authored clip scheduling remain host work.
Source§impl SceneAudioBusGraph
impl SceneAudioBusGraph
Sourcepub fn render_scheduled_pcm_quantum_zero_heap(
&self,
state: &mut ClipScheduleState<'_>,
work: &mut ClipScheduleWorkspace<'_>,
clips: &[PcmClip<'_>],
block_start: u64,
transport_generation: u64,
obstacles: &[AcousticObstacle],
budget: ClipScheduleBudget,
out_l: &mut [f32],
out_r: &mut [f32],
) -> Result<ClipScheduleReport, ClipScheduleError>
pub fn render_scheduled_pcm_quantum_zero_heap( &self, state: &mut ClipScheduleState<'_>, work: &mut ClipScheduleWorkspace<'_>, clips: &[PcmClip<'_>], block_start: u64, transport_generation: u64, obstacles: &[AcousticObstacle], budget: ClipScheduleBudget, out_l: &mut [f32], out_r: &mut [f32], ) -> Result<ClipScheduleReport, ClipScheduleError>
Render exact event subspans privately, then commit a complete block. End is exclusive; simultaneous end/start events take effect together. Every permitted resident emitter receives PCM or silence, preserving direct/room tails at natural clip events. Rebind, permission/residency changes and transport discontinuity clear all histories. The host must additionally cancel queued/device output on revoked access. Resident count must fit the caller’s active budget (at most 64); dynamic emitter residency remains host work, independently of authored clip count.
Source§impl SceneAudioBusGraph
impl SceneAudioBusGraph
Sourcepub fn sync_listener_from_motor(
&mut self,
camera_motor: Motor,
velocity: [f32; 3],
manifold_w: f32,
)
pub fn sync_listener_from_motor( &mut self, camera_motor: Motor, velocity: [f32; 3], manifold_w: f32, )
Synchronizes the listener pose from the observer camera’s PGA Motor.
Sourcepub fn clear_emitters(&mut self)
pub fn clear_emitters(&mut self)
Clears all scene emitters for a new scene sync pass.
Sourcepub fn push_emitter(&mut self, node: HolosonicNode) -> bool
pub fn push_emitter(&mut self, node: HolosonicNode) -> bool
Registers a HolosonicNode emitter into the scene graph and syncs HolosonicWavefield.
Sourcepub fn update_occlusion_zero_heap(&mut self, obstacles: &[AcousticObstacle])
pub fn update_occlusion_zero_heap(&mut self, obstacles: &[AcousticObstacle])
Evaluates shared SDF + BVH acoustic occlusion for all active emitters in zero heap.
Sourcepub fn render_quantum_zero_heap(
&mut self,
start_time_s: f32,
sample_rate: f32,
obstacles: &[AcousticObstacle],
out_l: &mut [f32],
out_r: &mut [f32],
) -> HolosonicPointSample
pub fn render_quantum_zero_heap( &mut self, start_time_s: f32, sample_rate: f32, obstacles: &[AcousticObstacle], out_l: &mut [f32], out_r: &mut [f32], ) -> HolosonicPointSample
Synthesizes and mixes a stereo audio block (out_l, out_r) across all 4 buses in zero heap:
- Continuous Holosonic wave superposition ($P_{\text{total}} = \sum p_i(t, \mathbf{x}_L)$) with epistemic certainty $q$ harmonic purity modulation and Doppler pitch shift.
- Per-emitter DF2T biquad occlusion low-pass filtering +
hrtf.rsbinaural FIR convolution. - 6-tap early reflections + stereo Freeverb late reverb tail.
- Emits 48-byte
HolosonicSonicToken48telemetry tokens intoHolosonicTelemetryBus.
Trait Implementations§
Auto Trait Implementations§
impl Freeze for SceneAudioBusGraph
impl RefUnwindSafe for SceneAudioBusGraph
impl Send for SceneAudioBusGraph
impl Sync for SceneAudioBusGraph
impl Unpin for SceneAudioBusGraph
impl UnsafeUnpin for SceneAudioBusGraph
impl UnwindSafe for SceneAudioBusGraph
Blanket Implementations§
§impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
impl<S, A> Aggregate<Result<S, Error>> for Awhere
A: Aggregate<S>,
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
§impl<T> Instrument for T
impl<T> Instrument for T
§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more