synthie 0.7.0

Chiptune-focused synthesizer engine: dual OSC, ring mod, filters, envelopes, LFO, arpeggiator, and FX (reverb, delay, chorus, bitcrusher)
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

//! A short chiptune song written in the pattern notation and played by a
//! [`SongPlayer`]: bass, lead, a chip-arpeggio chord lane and drums.
//!
//! ```sh
//! cargo run -p synthie --example pattern --release
//! ```

use std::time::Duration;

use anyhow::{Context, Result};
use synthie::audio::engine::setup_audio_silenced_with_sequencer;
use synthie::params::{ChannelNo, SynthParams};
use synthie::pattern::{Song, SongPlayer, Tempo};
use synthie::presets::sid::default_patches;

fn preset(name: &str) -> Result<SynthParams> {
    default_patches()
        .into_iter()
        .find(|p| p.name == name)
        .map(|p| p.params)
        .with_context(|| format!("preset {name:?} not found"))
}

fn song() -> Result<Song> {
    // Chords on a single channel: the arpeggiator cycles the cell's notes
    // fast enough to blur into a chord, the classic chip trick.
    let mut chords = preset("Tri Pad")?;
    chords.arp.rate = 50.0;
    chords.arp.gate = 1.0;
    chords.global.volume = 0.5;

    // One row per eighth note at 152 bpm; 8 bars of E minor.
    let song = Song::new(Tempo::bpm(152.0, 2))
        .one_shot()
        .patch(preset("C64 Bass")?) // @0
        .patch(preset("PWM Lead")?) // @1
        .patch(chords) // @2
        .lane(
            ChannelNo(0),
            "E2@0 E2 E2 E2 E2 E2 G2 A2 | E2 E2 E2 E2 E2 E2 D2 C2 |
             E2 E2 E2 E2 E2 E2 G2 A2 | Bb2 . A2 . G2 . D2 . |
             C2 . C2 C2 C2 . C2 C2   | D2 . D2 D2 D2 . D2 D2 |
             B1 . B1 B1 B1 . B1 B1   | E2 . . . . . - .",
        )?
        .lane(
            ChannelNo(1),
            "@1 . . . . . . . | - . . . . . . . |
             - . . . . . . .  | B4 . . . . . . . |
             G4 . E4 . G4 . A4 . | B4 . . . A4 . G4 . |
             A4 . . . G4 . F#4 . | E4 . . . . . - .",
        )?
        .lane(
            ChannelNo(2),
            "E4^037@2 . . . . . . . | E4^037 . . . . . . . |
             E4^037 . . . . . . .   | D4^047 . . . G4^047 . . . |
             C4^047 . . . . . . .   | D4^047 . . . . . . . |
             B3^047 . . . . . . .   | E4^037c . . . . . - .",
        )?
        .lane(
            ChannelNo(3),
            "k+c h s h k k s h | k h s h k k s h |
             k h s h k k s h   | k h s h k ht mt lt |
             k+c h s h k k s h | k h s+x h k k s o |
             k+c h s h k k s h | k+c . . . . . . .",
        )?;
    Ok(song)
}

fn main() -> Result<()> {
    let song = song()?;
    let seconds = song.duration_secs() + 2.0;
    let (_stream, _events, _scope) =
        setup_audio_silenced_with_sequencer(SongPlayer::new(song), |_| {})?;
    std::thread::sleep(Duration::from_secs_f32(seconds));
    Ok(())
}

#[cfg(test)]
mod tests {
    #[test]
    fn the_song_parses_and_every_lane_is_eight_bars() {
        let song = super::song().unwrap();
        for lane in &song.lanes {
            assert_eq!(lane.rows.len(), 64, "lane on {:?}", lane.channel);
        }
    }
}