Add MIDIEvent

Author: fwcd

lighthouse-protocol/src/input/midi_event.rs

@@ -0,0 +1,30 @@
+use serde::{Deserialize, Serialize};
+
+/// A MIDI message event.
+#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, Clone)]
+pub struct MIDIEvent {
+    /// The binary MIDI message.
+    /// 
+    /// The first byte is a status byte (first/most significant bit = 1), the
+    /// remaining bytes are data bytes (first/most significant bit = 0).
+    /// 
+    /// To give a simple example, pressing C5 on a MIDI keyboard would generate the
+    /// following message:
+    /// 
+    /// ```plaintext
+    ///     [0x90,     0x48,     0x64]
+    ///      Ch.1    Note 72   Velocity 100
+    ///     NoteOn   i.e. C5
+    /// ```
+    /// 
+    /// The note values can be looked up online:
+    /// 
+    /// - https://www.phys.unsw.edu.au/jw/notes.html
+    /// 
+    /// Same goes for a full description of the packet structure:
+    /// 
+    /// - https://www.w3.org/TR/webmidi/#terminology
+    /// - http://www.opensound.com/pguide/midi/midi5.html
+    /// - https://www.songstuff.com/recording/article/midi-message-format/
+    data: Vec<u8>,
+}

lighthouse-protocol/src/input/mod.rs

@@ -8,6 +8,7 @@ mod input_event;
 mod key_event;
 mod key_modifiers;
 mod legacy_input_event;
+mod midi_event;
 mod mouse_button;
 mod mouse_event;
 mod unknown_event;
@@ -22,6 +23,7 @@ pub use input_event::*;
 pub use key_event::*;
 pub use key_modifiers::*;
 pub use legacy_input_event::*;
+pub use midi_event::*;
 pub use mouse_button::*;
 pub use mouse_event::*;
 pub use unknown_event::*;