launchy 0.1.0

Low-level bindings and high-level abstractions for the Novation Launchpad MIDI devices
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

pub(crate) mod double_buffering;

#[derive(Debug, Copy, Clone, Hash, Eq, PartialEq)]
/// The button type used for Launchpads with 80 buttons
pub enum Button80 {
	ControlButton { index: u8 },
	GridButton { x: u8, y: u8 },
}

impl Button80 {
	pub const UP: Self = Button80::ControlButton { index: 0 };
	pub const DOWN: Self = Button80::ControlButton { index: 1 };
	pub const LEFT: Self = Button80::ControlButton { index: 2 };
	pub const RIGHT: Self = Button80::ControlButton { index: 3 };
	pub const SESSION: Self = Button80::ControlButton { index: 4 };
	pub const USER_1: Self = Button80::ControlButton { index: 5 };
	pub const USER_2: Self = Button80::ControlButton { index: 6 };
	pub const MIXER: Self = Button80::ControlButton { index: 7 };
	pub const VOLUME: Self = Button80::GridButton { x: 8, y: 0 };
	pub const PAN: Self = Button80::GridButton { x: 8, y: 1 };
	pub const SEND_A: Self = Button80::GridButton { x: 8, y: 2 };
	pub const SEND_B: Self = Button80::GridButton { x: 8, y: 3 };
	pub const STOP: Self = Button80::GridButton { x: 8, y: 4 };
	pub const MUTE: Self = Button80::GridButton { x: 8, y: 5 };
	pub const SOLO: Self = Button80::GridButton { x: 8, y: 6 };
	pub const RECORD_ARM: Self = Button80::GridButton { x: 8, y: 7 };

	/// Creates a new button out of absolute coordinates, like the ones returned by `abs_x()` and
	/// `abs_y()`.
	pub fn from_abs(x: u8, y: u8) -> Button80 {
		match y {
			0 => {
				assert!(x <= 7);
				return Button80::ControlButton { index: x };
			},
			1..=8 => {
				assert!(x <= 8);
				return Button80::GridButton { x, y: y - 1 };
			},
			other => panic!("Unexpected y: {}", other),
		}
	}

	/// Returns x coordinate assuming coordinate origin in the leftmost control button
	pub fn abs_x(&self) -> u8 {
		match *self {
			Self::ControlButton { index } => return index,
			Self::GridButton { x, .. } => return x,
		}
	}

	/// Returns y coordinate assuming coordinate origin in the leftmost control button
	pub fn abs_y(&self) -> u8 {
		match *self {
			Self::ControlButton { .. } => return 0,
			Self::GridButton { y, .. } => y + 1,
		}
	}
}