rawdio 0.14.0

An Audio Engine, inspired by the Web Audio API
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

use crate::{
    commands::Id, graph::GraphNode, parameter::*, prelude::*, utility::create_parameters, DspNode,
};

use super::gain_processor::GainProcessor;

/// A node that applies gain to the input
///
/// A gain node must be used in the graph with the same number of input to
/// output channels
///
/// # Parameters
/// - gain
pub struct Gain {
    /// The node to connect into the audio graph
    pub node: GraphNode,

    params: Parameters,
}

const MIN_GAIN: f64 = f64::NEG_INFINITY;
const MAX_GAIN: f64 = f64::INFINITY;
const DEFAULT_GAIN: f64 = 1.0;

impl DspNode for Gain {
    fn get_parameters_mut(&mut self) -> &mut Parameters {
        &mut self.params
    }
}

impl Gain {
    /// Create a new gain node with a given channel count
    pub fn new(context: &dyn Context, channel_count: usize) -> Self {
        let id = Id::generate();

        let (params, realtime_params) = create_parameters(
            id,
            context,
            [(
                "gain",
                ParameterRange::new(DEFAULT_GAIN, MIN_GAIN, MAX_GAIN),
            )],
        );

        let processor = Box::new(GainProcessor::new());

        Self {
            node: GraphNode::new(
                id,
                context,
                channel_count,
                channel_count,
                processor,
                realtime_params,
            ),
            params,
        }
    }

    /// Get the gain parameter
    pub fn gain(&mut self) -> &mut AudioParameter {
        self.get_parameter_mut("gain")
    }
}