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
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

use midix::prelude::*;

use super::MidiSongBuilder;

/// A struct provided to play a bunch of commands for one channel.
///
/// All time is in microseconds.
pub struct ChannelBuilder<'a> {
    pub(crate) builder: &'a mut MidiSongBuilder,
    pub(crate) channel: Channel,
}

impl ChannelBuilder<'_> {
    /// Set a program change (new voice)
    pub fn program_change(&mut self, time: u64, program: Program) -> &mut Self {
        self.builder.add(Timed::new(
            time,
            ChannelVoiceMessage::new(self.channel, VoiceEvent::program_change(program)),
        ));
        self
    }
    /// Turn a note on
    pub fn note_on(&mut self, time: u64, note: Note, velocity: Velocity) -> &mut Self {
        self.builder.add(Timed::new(
            time,
            ChannelVoiceMessage::new(self.channel, VoiceEvent::note_on(note, velocity)),
        ));
        self
    }

    /// Turn a note off
    pub fn note_off(&mut self, time: u64, note: Note, velocity: Velocity) -> &mut Self {
        self.builder.add(Timed::new(
            time,
            ChannelVoiceMessage::new(self.channel, VoiceEvent::note_off(note, velocity)),
        ));
        self
    }
    /// Modify the velocity of a note after it's been played.
    pub fn after_touch(&mut self, time: u64, note: Note, velocity: Velocity) -> &mut Self {
        self.builder.add(Timed::new(
            time,
            ChannelVoiceMessage::new(self.channel, VoiceEvent::after_touch(note, velocity)),
        ));
        self
    }

    ///Modify the controller's presets
    pub fn control_change(&mut self, time: u64, controller: Controller) -> &mut Self {
        self.builder.add(Timed::new(
            time,
            ChannelVoiceMessage::new(self.channel, VoiceEvent::control_change(controller)),
        ));
        self
    }

    /// Change the note velocity of a whole channel at once without starting new notes
    pub fn channel_after_touch(&mut self, time: u64, velocity: Velocity) -> &mut Self {
        self.builder.add(Timed::new(
            time,
            ChannelVoiceMessage::new(self.channel, VoiceEvent::channel_after_touch(velocity)),
        ));
        self
    }
    /// Bend the pitch
    pub fn pitch_bend(&mut self, time: u64, pitch_bend: PitchBend) -> &mut Self {
        self.builder.add(Timed::new(
            time,
            ChannelVoiceMessage::new(self.channel, VoiceEvent::pitch_bend(pitch_bend)),
        ));
        self
    }
}