Rust Music —

用于程序化音乐操作和编曲的框架。

概述

它提供了所有必要的类型和值来描述或生成复杂音乐作品，包括多轨和乐器、旋律短语、和弦、复杂节奏等。

携带这些信息的Score类型可以被完全导出为可玩性文件。

用法

将 rust-music 添加到您的 Cargo.toml 依赖中。

rust-music = "0.1.6"

然后您就可以开始创建音乐了。

use std::error::Error;
use std::fs::File;
use std::result::Result;

use rust_music::{
    compute_pitch, dynamic::*, rhythm::*, Accidental, Instrument, Note, NoteName, Part, Phrase,
    Score, Tempo,
};

fn main() -> Result<(), Box<dyn Error>> {
    // Create a musical phrase that plays C-E-G (arpeggiated C Major chord)
    // with crotchets, at MezzoForte volume
    let mut phrase_to_repeat = Phrase::new();
    phrase_to_repeat.add_note(Note::new(
        compute_pitch(NoteName::C, Accidental::Natural, 4)?,
        CROTCHET,
        MF,
    )?);
    phrase_to_repeat.add_note(Note::new(
        compute_pitch(NoteName::E, Accidental::Natural, 4)?,
        CROTCHET,
        MF,
    )?);
    phrase_to_repeat.add_note(Note::new(
        compute_pitch(NoteName::G, Accidental::Natural, 4)?,
        CROTCHET,
        MF,
    )?);

    // Create a piano part that plays the phrase from beat 0
    let mut piano_part = Part::new(Instrument::AcousticGrandPiano);
    piano_part.add_phrase(phrase_to_repeat.clone(), 0.);

    // Create a Strings part that plays the phrase from beat 0.5
    // (at the same time as the piano but shifted half a beat)
    let mut violins_part = Part::new(Instrument::StringEnsemble1);
    violins_part.add_phrase(phrase_to_repeat, 0.5);

    // Create a score with a tempo of 60 (one beat per second) and add both parts
    let mut score = Score::new("my score", Tempo::new(60)?, None);
    score.add_part(piano_part);
    score.add_part(violins_part);

    // Write the score to a MIDI file for playback
    score.write_midi_file(File::create("readme_example.mid")?)?;
    Ok(())
}

聆听此示例的输出

更复杂的示例可以在 examples 目录中找到，位于 rust-music 的 GitHub 仓库中。

开发路线图

• 编写更多单元测试和示例
• 改进和重组库的API，以实现更简洁和更自然的体验
• 添加一个具有创作辅助工具的模块（音阶/和弦生成器、节奏构建系统等）
• 编写一个单独的音乐程序生成库？
• 读取MIDI文件？
• 导出到ABC文件？

许可证

rust-music 在MIT许可证下分发。

有关详细信息，请参阅 LICENSE.txt。