Boomie 0.1.1

Music synthesizer module for, ideal for on the fly composition.
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

use std::sync::Arc;
use crate::waveform::WaveformType;
use crate::effects::EffectsChain;

#[derive(Debug, Clone)]
pub struct SampleData {
    pub samples: Arc<Vec<f32>>,
    pub sample_rate: u32,
}

#[derive(Debug, Clone)]
pub enum InstrumentSource {
    Synthesized(WaveformType),
    Sample(SampleData),
}

#[derive(Debug, Clone)]
pub struct Instrument {
    pub name: String,
    pub source: InstrumentSource,
    pub attack: f32, // ADSR envelope parameters
    pub decay: f32,
    pub sustain: f32,
    pub release: f32,
    pub volume: f32,
    pub pitch: f32,
    pub pan: f32, // -1.0 left, 1.0 right
    pub detune: f32, // Pitch offset in cents for detuning 
    pub effects: EffectsChain,
}

impl Default for Instrument {
    fn default() -> Self {
        Instrument {
            name: "Boomie".to_string(),
            source: InstrumentSource::Synthesized(WaveformType::Sine),
            attack: 0.01,
            decay: 0.1,
            sustain: 0.8,
            release: 0.2,
            volume: 0.5,
            pitch: 1.0,
            pan: 0.0,
            detune: 0.0,
            effects: EffectsChain::default(),
        }
    }
}

#[derive(Debug, Clone)] // overrides
pub struct Note {
    pub pitch: f32,
    pub duration: f32,
    pub velocity: f32,
    pub pan: Option<f32>,
    pub slide_to: Option<f32>,
}

// Chord struc for playing multiple notes
#[derive(Debug, Clone)]
pub struct Chord {
    pub pitches: Vec<f32>,
    pub duration: f32,
    pub velocity: f32,
}

// Sequence element enum to support notes, chords, and rests
#[derive(Debug, Clone)]
pub enum SequenceElement {
    Note(Note),
    Chord(Chord),
    Rest(f32),
}