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

use tunes::prelude::*;

/// Demonstrate FLAC export
///
/// This example shows how to export compositions to FLAC format for lossless
/// compression. FLAC files are typically 50-60% smaller than WAV with no quality loss.
fn main() -> anyhow::Result<()> {
    println!("\n🎵 FLAC Export Demo\n");

    // Create a simple composition
    let mut comp = Composition::new(Tempo::new(120.0));

    // Add a melody
    comp.instrument("melody", &Instrument::synth_lead())
        .notes(&[C4, E4, G4, C5, G4, E4, C4, C4], 0.5);

    // Add bass
    comp.instrument("bass", &Instrument::sub_bass())
        .at(0.0)
        .notes(&[C2, C2, G2, G2], 1.0);

    // Add drums
    comp.track("drums")
        .at(0.0)
        .drum_grid(16, 0.125, |g| g
        .sound(DrumType::Kick, &[0, 4, 8, 12])
        .sound(DrumType::Snare, &[4, 12])
        .sound(DrumType::HiHatClosed, &[0, 2, 4, 6, 8, 10, 12, 14]));

    println!("=== Exporting to FLAC ===\n");

    let mut mixer = comp.into_mixer();

    // Export to FLAC (lossless compression)
    println!("Exporting to 'output.flac'...");
    mixer.export_flac("output.flac", 44100)?;

    println!("\n=== FLAC vs WAV Comparison ===\n");

    // Also export to WAV for comparison
    println!("Exporting to 'output.wav' for comparison...");
    mixer.export_wav("output.wav", 44100)?;

    // Compare file sizes
    use std::fs;
    let flac_size = fs::metadata("output.flac")?.len();
    let wav_size = fs::metadata("output.wav")?.len();

    let compression_ratio = 100.0 - (flac_size as f64 / wav_size as f64 * 100.0);

    println!("\nFile Size Comparison:");
    println!("  WAV:  {} bytes", wav_size);
    println!("  FLAC: {} bytes", flac_size);
    println!("  Space saved: {:.1}% ({} bytes)", compression_ratio, wav_size - flac_size);

    println!("\n=== FLAC Benefits ===\n");
    println!("✅ Lossless compression (~50-60% smaller than WAV)");
    println!("✅ Perfect audio quality (bit-perfect)");
    println!("✅ Widely supported by DAWs and audio tools");
    println!("✅ Great for archival and professional workflows");
    println!("✅ Faster uploads/downloads than WAV");
    println!("✅ Supports metadata (track info, album art, etc.)");

    println!("\n=== When to Use FLAC ===\n");
    println!("• Archiving compositions");
    println!("• Sharing high-quality audio online");
    println!("• Professional production workflows");
    println!("• When storage space matters");
    println!("• Final masters before distribution");

    println!("\n=== When to Use WAV Instead ===\n");
    println!("• Maximum compatibility (some old tools don't support FLAC)");
    println!("• Streaming applications (WAV has lower decode overhead)");
    println!("• Real-time processing (less CPU usage)");

    Ok(())
}