soxr 0.6.0

Safe, comprehensive Rust bindings for libsoxr resampler
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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150

use core::ffi::c_void;
use core::marker::PhantomData;
use core::ptr::null_mut;

use bytemuck::Pod;
use libsoxr_sys as sys;

pub enum SampleFormat {
    Int16,
    Int32,
    Float32,
    Float64,
}

pub unsafe trait Sample: Pod {
    const FORMAT: SampleFormat;
}

unsafe impl Sample for i16 {
    const FORMAT: SampleFormat = SampleFormat::Int16;
}

unsafe impl Sample for i32 {
    const FORMAT: SampleFormat = SampleFormat::Int32;
}

unsafe impl Sample for f32 {
    const FORMAT: SampleFormat = SampleFormat::Float32;
}

unsafe impl Sample for f64 {
    const FORMAT: SampleFormat = SampleFormat::Float64;
}

pub unsafe trait IoFormat {
    type Sample: Sample;
    type Buffer: ?Sized;

    fn channels() -> usize;
    fn io_spec(scale: f64) -> sys::soxr_io_spec;

    fn frame_count(buffer: &Self::Buffer) -> usize;
    fn buffer_ptr(buffer: &Self::Buffer) -> *const c_void;
    fn buffer_mut_ptr(buffer: &mut Self::Buffer) -> *mut c_void;
}

/// Mono audio samples
pub struct Mono<S: Sample>(PhantomData<S>);

unsafe impl<S: Sample> IoFormat for Mono<S> {
    type Sample = S;
    type Buffer = [S];

    fn channels() -> usize { 1 }

    fn io_spec(scale: f64) -> sys::soxr_io_spec {
        sys::soxr_io_spec {
            itype: interleaved::<S>(),
            otype: interleaved::<S>(),
            scale,
            e: null_mut(),
            flags: 0,
        }
    }

    fn frame_count(buffer: &Self::Buffer) -> usize {
        buffer.len()
    }

    fn buffer_ptr(buffer: &Self::Buffer) -> *const c_void {
        buffer.as_ptr().cast()
    }

    fn buffer_mut_ptr(buffer: &mut Self::Buffer) -> *mut c_void {
        buffer.as_mut_ptr().cast()
    }
}

/// Stereo interleaved audio samples
pub struct Stereo<S: Sample>(PhantomData<S>);

unsafe impl<S: Sample> IoFormat for Stereo<S> {
    type Sample = S;
    type Buffer = [[S; 2]];

    fn channels() -> usize { 2 }

    fn io_spec(scale: f64) -> sys::soxr_io_spec {
        sys::soxr_io_spec {
            itype: interleaved::<S>(),
            otype: interleaved::<S>(),
            scale,
            e: null_mut(),
            flags: 0,
        }
    }

    fn frame_count(buffer: &Self::Buffer) -> usize {
        buffer.len()
    }

    fn buffer_ptr(buffer: &Self::Buffer) -> *const c_void {
        buffer.as_ptr().cast()
    }

    fn buffer_mut_ptr(buffer: &mut Self::Buffer) -> *mut c_void {
        buffer.as_mut_ptr().cast()
    }
}

/// N-channel interleaved audio samples
pub struct Interleaved<S: Sample, const CHANNELS: usize>(PhantomData<S>);

unsafe impl<S: Sample, const CHANNELS: usize> IoFormat for Interleaved<S, CHANNELS> {
    type Sample = S;
    type Buffer = [[S; CHANNELS]];

    fn channels() -> usize { CHANNELS }

    fn io_spec(scale: f64) -> sys::soxr_io_spec {
        sys::soxr_io_spec {
            itype: interleaved::<S>(),
            otype: interleaved::<S>(),
            scale,
            e: null_mut(),
            flags: 0,
        }
    }

    fn frame_count(buffer: &Self::Buffer) -> usize {
        buffer.len()
    }

    fn buffer_ptr(buffer: &Self::Buffer) -> *const c_void {
        buffer.as_ptr().cast()
    }

    fn buffer_mut_ptr(buffer: &mut Self::Buffer) -> *mut c_void {
        buffer.as_mut_ptr().cast()
    }
}

fn interleaved<S: Sample>() -> sys::soxr_datatype_t {
    match S::FORMAT {
        SampleFormat::Int16 => sys::SOXR_INT16_I,
        SampleFormat::Int32 => sys::SOXR_INT32_I,
        SampleFormat::Float32 => sys::SOXR_FLOAT32_I,
        SampleFormat::Float64 => sys::SOXR_FLOAT64_I,
    }
}