Struct AudioSource 

pub struct AudioSource {
    pub id: u32,
    pub position: Position3D,
    pub source_type: SourceType,
    pub active: bool,
    pub directivity: f32,
    pub injection_radius: f32,
}

A 3D audio source in the simulation.

Fields

id: u32

Unique identifier

position: Position3D

Position in 3D space (meters)

source_type: SourceType

Source signal type

active: bool

Whether the source is active

directivity: f32

Directivity pattern (1.0 = omnidirectional)

injection_radius: f32

Source radius for injection (cells)

Implementations

impl AudioSource

pub fn impulse(id: u32, position: Position3D, amplitude: f32) -> Self

Create a new impulse source.

pub fn tone( id: u32, position: Position3D, frequency_hz: f32, amplitude: f32, ) -> Self

Create a new tone source.

pub fn noise(id: u32, position: Position3D, amplitude: f32, pink: bool) -> Self

Create a noise source.

pub fn chirp( id: u32, position: Position3D, start_freq: f32, end_freq: f32, duration_s: f32, amplitude: f32, ) -> Self

Create a chirp (frequency sweep) source.

pub fn gaussian_pulse( id: u32, position: Position3D, center_time: f32, sigma: f32, amplitude: f32, ) -> Self

Create a Gaussian pulse source.

pub fn from_samples( id: u32, position: Position3D, samples: Vec<f32>, sample_rate: u32, looping: bool, ) -> Self

Create an audio file source.

pub fn with_radius(self, radius: f32) -> Self

Set the injection radius (in grid cells).

pub fn with_directivity(self, directivity: f32) -> Self

Set directivity (1.0 = omnidirectional).

pub fn set_position(&mut self, pos: Position3D)

Move the source to a new position.

pub fn next_sample(&mut self, time_step: f32) -> f32

Get the next sample value and advance the source state.

Returns the pressure value to inject at this time step.

pub fn reset(&mut self)

Reset the source to its initial state.

pub fn is_finished(&self) -> bool

Check if the source has finished (for one-shot sources).

Trait Implementations

impl Clone for AudioSource

fn clone(&self) -> AudioSource

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AudioSource

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.