audionimbus 0.14.0

A safe wrapper around Steam Audio that provides spatial audio capabilities with realistic occlusion, reverb, and HRTF effects, accounting for physical attributes and scene geometry.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

//! Simulation type configuration.

use crate::effect::reflections::{Convolution, ReflectionEffectType};
use crate::model::{AirAbsorptionModel, DistanceAttenuationModel};
use crate::ray_tracing::{DefaultRayTracer, RayTracer};
use crate::simulation::{
    ConvolutionParameters, Direct, DirectCompatible, DirectSimulationParameters, Occlusion,
    OcclusionAlgorithm, PathingCompatible, ReflectionEffectCompatible, Reflections,
    ReflectionsCompatible, SimulationFlagsProvider, SimulationParameters,
};
use bevy::reflect::TypePath;

/// Bundles the type parameters that define a simulation pipeline.
pub trait SimulationConfiguration: 'static + Send + Sync {
    type RayTracer: 'static + RayTracer + Send + Sync;
    type Direct: 'static
        + DirectCompatible<Self::Direct>
        + SimulationFlagsProvider
        + Send
        + Sync
        + Clone
        + Default;
    type Reflections: 'static
        + ReflectionsCompatible<Self::Reflections>
        + SimulationFlagsProvider
        + Send
        + Sync
        + Clone
        + Default;
    type Pathing: 'static
        + PathingCompatible<Self::Pathing>
        + SimulationFlagsProvider
        + Send
        + Sync
        + Clone
        + Default;
    type ReflectionEffect: 'static
        + ReflectionEffectCompatible<Self::Reflections, Self::ReflectionEffect>
        + ReflectionEffectType
        + Send
        + Sync
        + Clone
        + Default;

    /// Returns the implicit source parameters associated with this simulation configuration.
    fn implicit_source_parameters()
    -> SimulationParameters<Self::Direct, Self::Reflections, Self::Pathing> {
        SimulationParameters::default()
    }
}

/// Default simulation configuration: [`DefaultRayTracer`], direct, reflections via convolution, no
/// pathing.
#[derive(Copy, Clone, TypePath)]
pub struct DefaultSimulationConfiguration;

impl SimulationConfiguration for DefaultSimulationConfiguration {
    type RayTracer = DefaultRayTracer;
    type Direct = Direct;
    type Reflections = Reflections;
    type Pathing = ();
    type ReflectionEffect = Convolution;

    fn implicit_source_parameters() -> SimulationParameters<Direct, Reflections, ()> {
        SimulationParameters::new()
            .with_direct(
                DirectSimulationParameters::new()
                    .with_distance_attenuation(DistanceAttenuationModel::default())
                    .with_air_absorption(AirAbsorptionModel::default())
                    .with_occlusion(Occlusion::new(OcclusionAlgorithm::Raycast)),
            )
            .with_reflections(ConvolutionParameters {
                baked_data_identifier: None,
            })
    }
}