bevy_midix 4.0.0-alpha.2

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

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

use crate::assets::SoundFontAsset;

/// Component that specifies which soundfont to use for a MIDI synth
#[derive(Component)]
pub struct SynthPlayer {
    pub(crate) handle: Handle<SoundFontAsset>,
    pub(crate) midi_input_enabled: bool,
}

impl SynthPlayer {
    pub fn new(handle: Handle<SoundFontAsset>, midi_input_enabled: bool) -> Self {
        Self {
            handle,
            midi_input_enabled,
        }
    }

    pub fn handle(&self) -> &Handle<SoundFontAsset> {
        &self.handle
    }
}

/// Component for sending MIDI commands to a synthesizer node via ECS.
///
/// It is not required to have this (i.e. you are using a SynthPlayer<Channel>)
#[derive(Component, Default)]
pub struct SynthCommands {
    /// Queue of MIDI commands to send
    pub queue: Vec<ChannelVoiceMessage>,
}

impl SynthCommands {
    /// Add a MIDI command to the queue
    pub fn send(&mut self, command: ChannelVoiceMessage) {
        self.queue.push(command);
    }

    /// Add multiple MIDI commands to the queue
    pub fn send_batch(&mut self, commands: impl IntoIterator<Item = ChannelVoiceMessage>) {
        self.queue.extend(commands);
    }

    /// Take all commands, leaving the queue empty
    pub fn take(&mut self) -> Vec<ChannelVoiceMessage> {
        std::mem::take(&mut self.queue)
    }
}