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

use tunes::prelude::*;

/// Demonstrate the 808 drum machine sounds
///
/// This example showcases the TR-808-inspired drum synthesis,
/// including authentic algorithms for kick, snare, hi-hat, and clap.
fn main() -> anyhow::Result<()> {
    println!("\n🥁 808 Drum Machine Demo\n");

    let engine = AudioEngine::new()?;
    let mut comp = Composition::new(Tempo::new(100.0));

    // Example 1: Individual 808 drum sounds
    println!("Part 1: Individual 808 Sounds");
    println!("  - Kick808: Long, pitched sub-bass kick");
    println!("  - Snare808: Dual triangle oscillators + noise burst");
    println!("  - HiHat808: 6 square wave oscillators (metallic)");
    println!("  - Clap808: Multiple tightly-timed noise bursts\n");

    comp.track("demo")
        .at(0.0)
        .drum(DrumType::Kick808, 0.6)
        .drum(DrumType::Snare808, 0.3)
        .drum(DrumType::HiHat808Closed, 0.1)
        .drum(DrumType::HiHat808Open, 0.3)
        .drum(DrumType::Clap808, 0.3);

    // Example 2: Classic 808 beat pattern
    println!("Part 2: Classic 808 Beat Pattern");
    comp.track("808_beat")
        .at(3.0)
        .drum_grid(16, 0.15, |g| g
        .sound(DrumType::Kick, &[0, 6, 10])
        .sound(DrumType::Snare, &[4, 12])
        .sound(DrumType::Snare808, &[4, 12])
        .sound(DrumType::HiHat808Closed, &[0, 2, 4, 6, 8, 10, 12, 14])
        .sound(DrumType::HiHat808Open, &[3, 11])
        .sound(DrumType::Clap808, &[4, 12]));

    // Example 3: 808-style hip-hop beat
    println!("Part 3: 808 Hip-Hop Pattern\n");
    comp.track("hiphop")
        .at(5.5)
        .drum_grid(16, 0.15, |g| g
        .sound(DrumType::Kick808, &[0, 3, 6, 10])
        .sound(DrumType::Snare808, &[4, 12])
        .sound(DrumType::HiHat808Closed, &[1, 2, 5, 7, 9, 11, 13, 14])
        .sound(DrumType::HiHat808Open, &[15])
        .sound(DrumType::Clap808, &[8]));

    println!("=== Playback ===");
    let mixer = comp.into_mixer();
    println!(
        "Playing {:.1}s composition with 808 drums...\n",
        mixer.total_duration()
    );

    engine.play_mixer(&mixer)?;

    println!("\n✅ 808 Demo complete!\n");
    println!("Technical details:");
    println!("  • Kick808: 200Hz → 30Hz pitch drop, pure sine wave");
    println!("  • Snare808: 180Hz + 240Hz triangle waves + short noise burst");
    println!("  • HiHat808: 6 square oscillators at 3.5-8.4kHz (authentic ratios)");
    println!("  • Clap808: 3 noise bursts at 0ms, 8ms, 16ms + band-pass filter");
    println!("\nThe TR-808 drum machine (1980) used analog synthesis.");
    println!("These algorithms recreate the classic sound using DSP.\n");

    Ok(())
}