22 stable releases (4 major)
Uses old Rust 2015
4.0.10 | Dec 20, 2023 |
---|---|
4.0.8 | Aug 30, 2023 |
4.0.6 | May 14, 2021 |
4.0.4 | Feb 18, 2021 |
0.2.0 | Jan 22, 2018 |
#22 in Audio
771 downloads per month
Used in 2 crates
(via lv2-midi)
80KB
1.5K
SLoC
WMIDI
Midi encoding and decoding library.
Usage
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
}
Features
- Supports
no_std
environments. - No memory allocations (therefore realtime safe) for parsing and encoding.
- No memory allocations for creating
MidiMessage
, except forMidiMessage::OwnedSysEx
.
Testing & Benchmarking
- Build with
cargo build
. - Test with
cargo test
. - Benchmark with
cargo bench
. The results will be under./target/criterion/report/index.html
.
Changelog
4.0.0
- New ControlFunction type which simply wraps a U7.
- Constants and documentation for all ControlFunction values.
- Renumber Note enums/consts to be more consistent with midi; for example, C0 is now C1.
3.1.0
- Rename
MidiMessage::wire_size()
toMidiMessage::bytes_size()
. - Introduce
MidiMessage::copy_to_slice()
method.
3.0.0
- Instances of U7 and U14 now have bounds checking.
- Note is now an enum instead of a u8. Can be converted with
Note::try_from
andu8::from
.