xsynth_core/channel/
event.rs

1use std::sync::Arc;
2
3use crate::soundfont::SoundfontBase;
4
5/// MIDI events for a single key in a channel.
6#[derive(Clone, Copy, Debug, PartialEq)]
7#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
8pub enum KeyNoteEvent {
9    /// Starts a new note voice with a velocity
10    On(u8),
11
12    /// Signals off to a note voice
13    Off,
14
15    /// Signals off to all note voices
16    AllOff,
17
18    /// Kills all note voices without decay
19    AllKilled,
20}
21
22/// Events to modify parameters of a channel.
23#[derive(Clone, Debug)]
24#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
25pub enum ChannelConfigEvent {
26    /// Sets the soundfonts for the channel
27    #[cfg_attr(feature = "serde", serde(skip))]
28    SetSoundfonts(Vec<Arc<dyn SoundfontBase>>),
29
30    /// Sets the layer count for the soundfont
31    SetLayerCount(Option<usize>),
32
33    /// Controls whether the channel will be standard or percussion.
34    /// Setting to `true` will make the channel only use percussion patches.
35    SetPercussionMode(bool),
36}
37
38/// MIDI events for a channel.
39#[derive(Clone, Copy, Debug, PartialEq)]
40#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
41pub enum ChannelAudioEvent {
42    /// Starts a new note voice
43    NoteOn { key: u8, vel: u8 },
44
45    /// Signals off to a note voice
46    NoteOff { key: u8 },
47
48    /// Signal off to all voices
49    AllNotesOff,
50
51    /// Kill all voices without decay
52    AllNotesKilled,
53
54    /// Resets all CC to their default values
55    ResetControl,
56
57    /// Control event for the channel
58    Control(ControlEvent),
59
60    /// Program change event
61    ProgramChange(u8),
62
63    /// System reset
64    SystemReset,
65}
66
67/// Wrapper enum for various events for a channel.
68#[derive(Clone, Debug)]
69#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
70pub enum ChannelEvent {
71    /// Audio event
72    Audio(ChannelAudioEvent),
73
74    /// Configuration event for the channel
75    Config(ChannelConfigEvent),
76}
77
78/// MIDI control events for a channel.
79#[derive(Clone, Copy, Debug, PartialEq)]
80#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
81pub enum ControlEvent {
82    /// A raw control change event
83    Raw(u8, u8),
84
85    /// The pitch bend strength, in tones
86    PitchBendSensitivity(f32),
87
88    /// The pitch bend value, between -1 and 1
89    PitchBendValue(f32),
90
91    /// The pitch bend, product of value * sensitivity
92    PitchBend(f32),
93
94    /// Fine tune value in cents
95    FineTune(f32),
96
97    /// Coarse tune value in semitones
98    CoarseTune(f32),
99}
xsynth_core/channel/event.rs

xsynth_core/channel/
event.rs
