pointillism 0.4.3

A compositional library for musical 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
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
121
122
123
124
125
126
127
128
129

//! Creates a basic electric piano synth, plays a major chord.
//!
//! Adapted from <https://docs.rs/twang/latest/twang/index.html#a3-220-hz-minor-piano-example>.

use pointillism::prelude::*;
use rand::Rng;

/// Project sample rate.
const SAMPLE_RATE: unt::SampleRate = unt::SampleRate::CD;

/// First ten harmonic volumes of a piano sample.
const HARMONICS: [f64; 10] = [
    0.700, 0.243, 0.229, 0.095, 0.139, 0.087, 0.288, 0.199, 0.124, 0.090,
];

/// A custom electric piano signal, created from a bunch of sine wave oscillators.
#[derive(Default)]
pub struct EPiano {
    /// Oscillators at the fundamental frequency, twice that, etc.
    oscs: [gen::Loop<smp::Mono, crv::Sin>; 10],
}

impl EPiano {
    /// Randomize the phases of the oscillators.
    fn rand_phases(&mut self) {
        for osc in &mut self.oscs {
            *osc.val_mut() = rand::thread_rng().gen();
        }
    }

    /// Create a new electric piano with the given frequency.
    fn new(freq: unt::Freq) -> Self {
        let mut epiano = Self::default();
        epiano.rand_phases();

        for (i, osc) in epiano.oscs.iter_mut().enumerate() {
            *osc.freq_mut() = freq * (i + 1) as f64;
        }

        epiano
    }
}

impl Signal for EPiano {
    type Sample = smp::Mono;

    /// Adds up the values from the inner oscillators, rescaled by the harmonic volumes.
    fn get(&self) -> smp::Mono {
        self.oscs
            .iter()
            .enumerate()
            .map(|(i, osc)| osc.get() * HARMONICS[i])
            .sum::<smp::Mono>()
            / 10.0
    }
}

impl SignalMut for EPiano {
    /// Advance the inner oscillators.
    fn advance(&mut self) {
        for osc in &mut self.oscs {
            osc.advance();
        }
    }

    /// Retrigger the inner oscillators, randomize phases.
    fn retrigger(&mut self) {
        self.rand_phases();
        for osc in &mut self.oscs {
            osc.retrigger();
        }
    }
}

/// An electric piano with a slight tremolo effect applied.
fn trem_piano(freq: unt::Freq, vib_freq: unt::Freq) -> impl Stop<Sample = smp::Mono> {
    // The volume follows a rescaled sine wave curve.
    let env = gen::Loop::new(
        map::Comp::new(crv::Sin, map::Linear::rescale_sgn(0.8, 1.0)),
        vib_freq,
    );

    // Some subtle ADSR.
    let adsr = eff::env::Adsr::new(
        unt::Time::from_sec(0.1, SAMPLE_RATE),
        unt::Time::from_sec(0.2, SAMPLE_RATE),
        unt::Vol::new(0.7),
        unt::Time::from_sec(0.1, SAMPLE_RATE),
    );

    eff::env::AdsrEnv::new_adsr(eff::Tremolo::new(EPiano::new(freq), env), adsr)
}

fn main() {
    let c3 = unt::Freq::from_raw(unt::RawFreq::C3, SAMPLE_RATE);
    let sec = unt::Time::from_raw(unt::RawTime::SEC, SAMPLE_RATE);

    // One piano for each note.
    let (mut p1, mut p2, mut p3) = (
        trem_piano(c3, unt::Freq::from_hz_default(4.0)),
        trem_piano(5.0 / 4.0 * c3, unt::Freq::from_hz_default(5.0)),
        trem_piano(3.0 / 2.0 * c3, unt::Freq::from_hz_default(6.0)),
    );

    let mut timer = ctr::Timer::new(5.0 * sec);
    Song::new(5.2 * sec, SAMPLE_RATE, |time| {
        let mut sgn = p1.next();

        // Play the second note after one second.
        if time > unt::Time::from_raw_default(unt::RawTime::SEC) {
            sgn += p2.next();
        }

        // Play the third note after two seconds.
        if time > 2u8 * sec {
            sgn += p3.next();
        }

        // Stops all notes after five seconds.
        if timer.tick(time) {
            p1.stop();
            p2.stop();
            p3.stop();
        }

        sgn / 3.0
    })
    .export("pointillism/examples/epiano.wav");
}