qualia_audio/midi/mpe/
zone.rs1use crate::types::AudioError;
12
13#[derive(Debug, Clone, Copy, PartialEq, Eq)]
15pub struct MpeZone {
16 pub master_channel: u8,
18 pub member_low: u8,
20 pub member_high: u8,
22}
23
24impl MpeZone {
25 pub fn lower(member_count: u8) -> Result<Self, AudioError> {
31 if member_count == 0 || member_count > 15 {
32 return Err(AudioError::InvalidParameter);
33 }
34 Ok(Self {
35 master_channel: 0,
36 member_low: 1,
37 member_high: member_count,
38 })
39 }
40
41 pub fn upper(member_count: u8) -> Result<Self, AudioError> {
47 if member_count == 0 || member_count > 15 {
48 return Err(AudioError::InvalidParameter);
49 }
50 Ok(Self {
51 master_channel: 15,
52 member_low: 15 - member_count,
53 member_high: 14,
54 })
55 }
56
57 #[inline]
59 pub fn member_count(&self) -> u8 {
60 self.member_high - self.member_low + 1
61 }
62
63 #[inline]
65 pub fn is_member(&self, channel: u8) -> bool {
66 channel >= self.member_low && channel <= self.member_high
67 }
68
69 #[inline]
71 pub fn is_master(&self, channel: u8) -> bool {
72 channel == self.master_channel
73 }
74}
75
76#[cfg(test)]
77mod tests {
78 use super::*;
79
80 #[test]
81 fn lower_zone_layout() {
82 let z = MpeZone::lower(7).unwrap();
83 assert_eq!(z.master_channel, 0);
84 assert_eq!(z.member_low, 1);
85 assert_eq!(z.member_high, 7);
86 assert_eq!(z.member_count(), 7);
87 assert!(z.is_master(0));
88 assert!(z.is_member(1) && z.is_member(7));
89 assert!(!z.is_member(0) && !z.is_member(8));
90 }
91
92 #[test]
93 fn upper_zone_layout() {
94 let z = MpeZone::upper(7).unwrap();
95 assert_eq!(z.master_channel, 15);
96 assert_eq!(z.member_low, 8);
97 assert_eq!(z.member_high, 14);
98 assert_eq!(z.member_count(), 7);
99 assert!(z.is_master(15));
100 assert!(z.is_member(8) && z.is_member(14));
101 assert!(!z.is_member(15));
102 }
103
104 #[test]
105 fn rejects_bad_counts() {
106 assert!(MpeZone::lower(0).is_err());
107 assert!(MpeZone::lower(16).is_err());
108 assert!(MpeZone::upper(0).is_err());
109 }
110}