qualia_audio/midi/mpe/
note_allocation.rs1use crate::types::AudioError;
12
13use super::zone::MpeZone;
14
15#[derive(Debug, Clone)]
17pub struct MpeNoteAllocator {
18 zone: MpeZone,
19 active: [Option<u8>; 16],
21 cursor: u8,
23}
24
25impl MpeNoteAllocator {
26 pub fn new(zone: MpeZone) -> Self {
28 Self {
29 zone,
30 active: [None; 16],
31 cursor: zone.member_low,
32 }
33 }
34
35 pub fn allocate(&mut self, note: u8) -> Result<u8, AudioError> {
40 let count = self.zone.member_count();
41 let low = self.zone.member_low;
42 for step in 0..count {
44 let ch = low + ((self.cursor - low + step) % count);
45 if self.active[ch as usize].is_none() {
46 self.active[ch as usize] = Some(note);
47 self.cursor = low + ((ch - low + 1) % count);
49 return Ok(ch);
50 }
51 }
52 Err(AudioError::BackendUnavailable)
53 }
54
55 pub fn release(&mut self, note: u8) -> Option<u8> {
58 let low = self.zone.member_low as usize;
59 let high = self.zone.member_high as usize;
60 for ch in low..=high {
61 if self.active[ch] == Some(note) {
62 self.active[ch] = None;
63 return Some(ch as u8);
64 }
65 }
66 None
67 }
68
69 #[inline]
71 pub fn note_on_channel(&self, channel: u8) -> Option<u8> {
72 self.active.get(channel as usize).copied().flatten()
73 }
74
75 pub fn active_count(&self) -> usize {
77 let low = self.zone.member_low as usize;
78 let high = self.zone.member_high as usize;
79 self.active[low..=high]
80 .iter()
81 .filter(|c| c.is_some())
82 .count()
83 }
84}
85
86#[cfg(test)]
87mod tests {
88 use super::*;
89
90 #[test]
91 fn golden_three_notes_three_distinct_channels() {
92 let mut alloc = MpeNoteAllocator::new(MpeZone::lower(7).unwrap());
93 let c0 = alloc.allocate(60).unwrap();
94 let c1 = alloc.allocate(64).unwrap();
95 let c2 = alloc.allocate(67).unwrap();
96 assert_ne!(c0, c1);
97 assert_ne!(c1, c2);
98 assert_ne!(c0, c2);
99 for &c in &[c0, c1, c2] {
101 assert!((1..=7).contains(&c));
102 }
103 }
104
105 #[test]
106 fn rotates_and_reuses_after_release() {
107 let mut alloc = MpeNoteAllocator::new(MpeZone::lower(3).unwrap()); let a = alloc.allocate(60).unwrap();
109 let b = alloc.allocate(61).unwrap();
110 let c = alloc.allocate(62).unwrap();
111 assert_eq!([a, b, c], [1, 2, 3]);
112 assert!(alloc.allocate(63).is_err()); assert_eq!(alloc.release(61), Some(2));
114 assert_eq!(alloc.allocate(63).unwrap(), 2); }
116
117 #[test]
118 fn tracks_active_notes() {
119 let mut alloc = MpeNoteAllocator::new(MpeZone::lower(5).unwrap());
120 let ch = alloc.allocate(72).unwrap();
121 assert_eq!(alloc.note_on_channel(ch), Some(72));
122 assert_eq!(alloc.active_count(), 1);
123 alloc.release(72);
124 assert_eq!(alloc.active_count(), 0);
125 assert_eq!(alloc.note_on_channel(ch), None);
126 }
127}