tunes 1.1.0

A music composition, synthesis, and audio generation library
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

//! Pad instrument presets

use super::Instrument;
use crate::synthesis::effects::{Delay, Reverb};
use crate::synthesis::envelope::Envelope;
use crate::synthesis::filter::Filter;
use crate::synthesis::lfo::{LFO, ModRoute, ModTarget};
use crate::synthesis::waveform::Waveform;

impl Instrument {
    /// Warm pad - slow attack, long release
    pub fn warm_pad() -> Self {
        let filter_lfo = LFO::new(Waveform::Sine, 0.2, 0.5);
        Self {
            name: "Warm Pad".to_string(),
            waveform: Waveform::Sawtooth,
            envelope: Envelope::pad(),
            filter: Filter::low_pass(1500.0, 0.3),
            modulation: vec![ModRoute::new(filter_lfo, ModTarget::FilterCutoff, 0.2)],
            delay: None,
            reverb: Some(Reverb::new(0.8, 0.6, 0.5)),
            distortion: None,
            volume: 1.0,
            pan: 0.0,
        }
    }

    /// Ambient pad - very slow, atmospheric
    pub fn ambient_pad() -> Self {
        let filter_lfo = LFO::new(Waveform::Sine, 0.15, 0.7);
        let tremolo = LFO::new(Waveform::Sine, 0.3, 0.3);
        Self {
            name: "Ambient Pad".to_string(),
            waveform: Waveform::Triangle,
            envelope: Envelope::new(1.0, 0.5, 0.8, 1.5),
            filter: Filter::low_pass(2000.0, 0.2),
            modulation: vec![
                ModRoute::new(filter_lfo, ModTarget::FilterCutoff, 0.3),
                ModRoute::new(tremolo, ModTarget::Volume, 0.2),
            ],
            delay: Some(Delay::new(0.5, 0.5, 0.3)),
            reverb: Some(Reverb::new(0.9, 0.7, 0.6)),
            distortion: None,
            volume: 1.0,
            pan: 0.0,
        }
    }

    /// Vocal pad - choir/vocal-like synth pad
    pub fn vocal_pad() -> Self {
        let formant_sweep = LFO::new(Waveform::Sine, 0.25, 0.4); // Slow formant-like sweep
        Self {
            name: "Vocal Pad".to_string(),
            waveform: Waveform::Sawtooth,
            envelope: Envelope::new(0.5, 0.4, 0.9, 1.0), // Very slow attack
            filter: Filter::low_pass(2500.0, 0.6),       // Vocal formant range
            modulation: vec![ModRoute::new(formant_sweep, ModTarget::FilterCutoff, 0.35)],
            delay: None,
            reverb: Some(Reverb::new(0.8, 0.7, 0.6)), // Cathedral-like
            distortion: None,
            volume: 1.0,
            pan: 0.0,
        }
    }

    /// Dark pad - brooding, atmospheric pad with low frequency content
    pub fn dark_pad() -> Self {
        let dark_lfo = LFO::new(Waveform::Sine, 0.12, 0.3); // Very slow movement
        Self {
            name: "Dark Pad".to_string(),
            waveform: Waveform::Sawtooth,
            envelope: Envelope::new(1.2, 0.6, 0.85, 1.8), // Extremely slow attack
            filter: Filter::low_pass(800.0, 0.4),          // Dark, muted
            modulation: vec![ModRoute::new(dark_lfo, ModTarget::FilterCutoff, 0.2)],
            delay: Some(Delay::new(0.6, 0.4, 0.25)),
            reverb: Some(Reverb::new(0.95, 0.8, 0.7)), // Massive space
            distortion: None,
            volume: 1.0,
            pan: 0.0,
        }
    }

    /// Shimmer pad - bright, evolving pad with high-frequency sparkle
    pub fn shimmer_pad() -> Self {
        let shimmer_lfo = LFO::new(Waveform::Sine, 0.18, 0.5);
        let tremolo = LFO::new(Waveform::Sine, 0.25, 0.15);
        Self {
            name: "Shimmer Pad".to_string(),
            waveform: Waveform::Triangle,
            envelope: Envelope::new(0.8, 0.5, 0.9, 1.2), // Slow, gentle attack
            filter: Filter::low_pass(6000.0, 0.3),        // Bright but not harsh
            modulation: vec![
                ModRoute::new(shimmer_lfo, ModTarget::FilterCutoff, 0.25),
                ModRoute::new(tremolo, ModTarget::Volume, 0.12),
            ],
            delay: Some(Delay::new(0.45, 0.5, 0.35)),
            reverb: Some(Reverb::new(0.85, 0.75, 0.65)),
            distortion: None,
            volume: 1.0,
            pan: 0.0,
        }
    }

    /// String pad - lush string ensemble pad
    pub fn string_pad() -> Self {
        let vibrato = LFO::new(Waveform::Sine, 5.2, 0.25); // String-like vibrato
        Self {
            name: "String Pad".to_string(),
            waveform: Waveform::Sawtooth,
            envelope: Envelope::new(0.4, 0.35, 0.88, 0.9), // Slower than normal strings
            filter: Filter::low_pass(3500.0, 0.28),         // Warm, orchestral
            modulation: vec![ModRoute::new(vibrato, ModTarget::FilterCutoff, 0.12)],
            delay: None,
            reverb: Some(Reverb::new(0.7, 0.65, 0.5)), // Hall reverb
            distortion: None,
            volume: 1.0,
            pan: 0.0,
        }
    }
}