bevy_midix 4.0.0-alpha.6

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
48
49
50
51
52
53
54

use bevy::prelude::*;
use midix::prelude::*;

mod channel;
pub use channel::*;

use super::MidiSong;

/// A struct to build a [`MidiSong`] programatically.
///
/// This struct does not consider beats per minute or anything of that sort.
///
/// Straight micros, delta seconds.
#[derive(Default, Clone, Debug)]
pub struct MidiSongBuilder {
    accumulated_time: u64,
    events: Vec<Timed<ChannelVoiceMessage>>,
}

impl MidiSongBuilder {
    /// Send a lot of events to one channel efficiently
    pub fn channel(&mut self, channel: Channel) -> ChannelBuilder<'_> {
        ChannelBuilder {
            builder: self,
            channel,
        }
    }

    /// Add a timed channel voice message. event should be in DELTA micros.
    pub fn add(&mut self, mut event: Timed<ChannelVoiceMessage>) -> &mut Self {
        self.accumulated_time += event.timestamp;
        event.timestamp = self.accumulated_time;

        self.events.push(event);
        self
    }
    /// Add many timed channel voice messages
    pub fn add_many(
        &mut self,
        events: impl IntoIterator<Item = Timed<ChannelVoiceMessage>>,
    ) -> &mut Self {
        self.events.extend(events.into_iter().map(|mut event| {
            self.accumulated_time += event.timestamp;
            event.timestamp = self.accumulated_time;
            event
        }));
        self
    }

    /// Build a midi song from the provided events
    pub fn build(self) -> MidiSong {
        MidiSong::new(self.events)
    }
}