WMIDI

MIDI编码和解码库。

用法

use std::convert::TryFrom;

// Decoding messages from bytes.
fn handle_midi_message(bytes: &[u8]) -> Result<(), wmidi::FromBytesError> {
    let message = wmidi::MidiMessage::try_from(bytes)?;
    if let wmidi::MidiMessage::NoteOn(_, note, val) = message {
        let volume = u8::from(val) as u8 / 127.0;
        println!("Singing {} at volume {}", note, volume);
    }
    Ok(())
}

// Encoding messages to bytes.
fn midi_to_bytes(message: wmidi::MidiMessage<'_>) -> Vec<u8> {
    let mut bytes = vec![0u8; message.bytes_size()];
    message.copy_to_slice(bytes.as_mut_slice()).unwrap();
    bytes
}

特性

• 支持 no_std 环境。
• 解析和编码过程中没有内存分配（因此实时安全）。
• 除了 MidiMessage::OwnedSysEx 之外，创建 MidiMessage 时没有内存分配。

测试和基准测试

• 使用 cargo build 构建。
• 使用 cargo test 进行测试。
• 使用 cargo bench 进行基准测试。结果将在 ./target/criterion/report/index.html 下。

变更日志

4.0.0

• 引入了新的 ControlFunction 类型，它简单地包装了一个U7。
• 为所有 ControlFunction 值提供了常量和文档。
• 重新编号Note枚举/常量，使其与midi更一致；例如，C0现在是C1。