music-timer 0.1.6

music-timer is a crate with music time and counting utilities featuring a callback performance engine to help with triggering events in music time. Written in Rust.
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
74
75
76
77
78
79
80
81
82
83
84

use music_timer::{music_time::MusicTime, music_timer_engine::MusicTimerState};

struct PerformanceState {
    current_time: MusicTime,
    count_bars: u8,
    count_beats: u8,
    count_beat_intervals: u8,
}

impl PerformanceState {
    fn new() -> Self {
        PerformanceState {
            current_time: MusicTime::default(),
            count_bars: 0,
            count_beats: 0,
            count_beat_intervals: 0,
        }
    }
}

impl MusicTimerState for PerformanceState {
    fn on_beat_interval(&mut self, now_time: &MusicTime) {
        self.current_time = now_time.clone();
        self.count_beat_intervals += 1;
    }
    fn on_beat(&mut self, now_time: &MusicTime) {
        self.current_time = now_time.clone();
        self.count_beats += 1;
    }
    fn on_bar(&mut self, now_time: &MusicTime) {
        self.current_time = now_time.clone();
        self.count_bars += 1;
    }
}

fn performance_runner(
    time_bpm: (u8, u8, u8),
    performer_state: &mut PerformanceState,
    end_time: MusicTime,
) {
    use std::thread;

    let mut performer =
        music_timer::create_performance_engine(time_bpm.0, time_bpm.1, time_bpm.2 as f32);
    let sleep_duration = performer.get_beat_interval_duration() / 2;
    while performer_state.current_time < end_time {
        performer.pulse(performer_state);
        thread::sleep(sleep_duration);
    }
}

#[test]
fn test_performance_example() {
    let mut performer_state = PerformanceState::new();
    let end_time = MusicTime::new(4, 3, 8);
    performance_runner((3, 4, 155), &mut performer_state, end_time);

    assert_eq!(performer_state.current_time, end_time);
    assert_eq!(performer_state.count_beat_intervals, 8 * 3 * 4);
    assert_eq!(performer_state.count_beats, 3 * 4);
    assert_eq!(performer_state.count_bars, 4);
}
#[test]
fn test_standard() {
    let mut performer_state = PerformanceState::new();
    let end_time = MusicTime::new(4, 4, 8);
    performance_runner((4, 4, 120), &mut performer_state, end_time);

    assert_eq!(performer_state.current_time, end_time);
    assert_eq!(performer_state.count_beat_intervals, 8 * 4 * 4);
    assert_eq!(performer_state.count_beats, 4 * 4);
    assert_eq!(performer_state.count_bars, 4);
}
#[test]
fn test_odd() {
    let mut performer_state = PerformanceState::new();
    let end_time = MusicTime::new(4, 7, 8);
    performance_runner((7, 8, 120), &mut performer_state, end_time);

    assert_eq!(performer_state.current_time, end_time);
    assert_eq!(performer_state.count_beat_intervals, 8 * 7 * 4);
    assert_eq!(performer_state.count_beats, 7 * 4);
    assert_eq!(performer_state.count_bars, 4);
}