awedio 0.6.0

A low-overhead and adaptable audio playback library
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
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use crate::{
    sounds::wrappers::{SetPaused, SetSpeed},
    tests::Sawtooth,
    NextSample, Sound,
};

use super::*;

#[test]
fn test_no_conversion() {
    let sound = Sawtooth::new(2, 1000).pausable();
    let mut converted = SampleRateConverter::new(sound, 1000);
    assert_eq!(converted.channel_count(), 2);
    assert_eq!(converted.sample_rate(), 1000);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    converted.inner_mut().set_paused(true);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Paused);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Paused);
    converted.inner_mut().set_paused(false);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(3));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(3));
}

#[test]
fn test_four_times() {
    let sound = Sawtooth::new(2, 1000).pausable();
    let mut converted = SampleRateConverter::new(sound, 250);
    assert_eq!(converted.channel_count(), 2);
    assert_eq!(converted.sample_rate(), 250);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(8));
    converted.inner_mut().set_paused(true);
    // Takes time to flush the buffer. That is okay.
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(8));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Paused);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Paused);
    converted.inner_mut().set_paused(false);
    // The pause interrupted our conversion so we come back in
    // a different offset
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(10));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(10));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(14));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(14));
}

#[test]
fn test_div_4() {
    let sound = Sawtooth::new(2, 1000).pausable();
    let mut converted = SampleRateConverter::new(sound, 4000);
    assert_eq!(converted.channel_count(), 2);
    assert_eq!(converted.sample_rate(), 4000);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    converted.inner_mut().set_paused(true);
    // It can take some time for us to flush buffers before we
    // see the pause from the inner item. This is fine.
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(3));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(3));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Paused);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Paused);
    converted.inner_mut().set_paused(false);
    // Coming back from being paused we can lose samples
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(5));
}

#[test]
fn catch_metadata_changed_when_passing_through() {
    let sound = Sawtooth::new(1, 1000).with_adjustable_speed();
    let mut converted = SampleRateConverter::new(sound, 1000);
    assert_eq!(converted.channel_count(), 1);
    assert_eq!(converted.sample_rate(), 1000);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(0));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(1));
    converted.inner_mut().set_speed(2.0);
    assert_eq!(
        converted.next_sample().unwrap(),
        NextSample::MetadataChanged
    );
    assert_eq!(converted.sample_rate(), 1000);
    assert_eq!(converted.inner_mut().sample_rate(), 2000);
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(2));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(4));
    assert_eq!(converted.next_sample().unwrap(), NextSample::Sample(6));
    assert_eq!(converted.channel_count(), 1);
}