bevy_midix 4.0.0-alpha.5

The MIDI plugin for humans. Out-of-the-box soundfont synthesizer, commands, and input!
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

use super::SimpleMidiSong;
use midix::prelude::*;

/// A struct to define what goes on within a beat
pub struct Beat<'a> {
    pub(crate) song: &'a mut SimpleMidiSong,
    pub(crate) beat_no: u64,
}

impl<'s> Beat<'s> {
    /// Do something at for a particular channel on this beat
    pub fn channel<'b>(&'b mut self, channel: Channel) -> ChannelBeat<'b, 's> {
        ChannelBeat {
            beat: self,
            channel,
        }
    }
}

/// A struct that will tell a channel to do something at a particular beat
pub struct ChannelBeat<'b, 's> {
    beat: &'b mut Beat<'s>,
    channel: Channel,
}

impl<'b, 's> ChannelBeat<'b, 's> {
    /// play a note for this channel. Does not override other notes that will be played.
    pub fn play(self, note: Note) -> &'b mut Beat<'s> {
        let event =
            ChannelVoiceMessage::new(self.channel, VoiceEvent::note_on(note, Velocity::MAX));

        self.beat.song.add_event(self.beat.beat_no, event);
        self.beat
    }

    /// play some notes for this channel. Does not override other notes that will be played.
    pub fn play_notes<Notes>(self, notes: Notes) -> &'b mut Beat<'s>
    where
        Notes: IntoIterator<Item = Note>,
    {
        let events = notes.into_iter().map(|key| {
            ChannelVoiceMessage::new(self.channel, VoiceEvent::note_on(key, Velocity::MAX))
        });
        self.beat.song.add_events(self.beat.beat_no, events);
        self.beat
    }
}