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

//! Functions for converting from one unit of measurement to another.

#![allow(dead_code)]

use std::time::Duration;

#[inline]
pub fn frames_to_samples(num_frames: usize, num_channels: u16) -> usize {
    num_frames * (num_channels as usize)
}

#[inline]
pub fn samples_to_frames(num_samples: usize, num_channels: u16) -> usize {
    num_samples / (num_channels as usize)
}

#[inline]
pub fn milliseconds_to_frames(duration_milliseconds: usize, frame_rate_hz: u32) -> usize {
    (duration_milliseconds * frame_rate_hz as usize) / 1000
}

#[inline]
pub fn milliseconds_to_duration(duration_milliseconds: usize) -> Duration {
    Duration::from_millis(duration_milliseconds as u64)
}

#[inline]
pub fn frames_to_duration(num_frames: usize, frame_rate_hz: u32) -> Duration {
    let ms = frames_to_milliseconds(num_frames, frame_rate_hz);
    milliseconds_to_duration(ms)
}

#[inline]
pub fn milliseconds_to_samples(
    duration_milliseconds: usize,
    frame_rate_hz: u32,
    num_channels: u16,
) -> usize {
    let num_frames = milliseconds_to_frames(duration_milliseconds, frame_rate_hz);
    frames_to_samples(num_frames, num_channels)
}

///
/// # Examples
/// ```
/// use babycat::units::frames_to_milliseconds;
///
/// let num_frames = 1323000;
/// let frame_rate_hz = 44100;
/// let thirty_seconds_as_ms = 30 * 1000;
/// assert_eq!(
///     frames_to_milliseconds(num_frames, frame_rate_hz),
///     thirty_seconds_as_ms
/// );
/// ```
#[inline]
pub fn frames_to_milliseconds(num_frames: usize, frame_rate_hz: u32) -> usize {
    num_frames * 1000 / frame_rate_hz as usize
}

#[inline]
pub fn samples_to_milliseconds(num_samples: usize, frame_rate_hz: u32, num_channels: u16) -> usize {
    let num_frames = samples_to_frames(num_samples, num_channels);
    frames_to_milliseconds(num_frames, frame_rate_hz)
}