rusty_mp3 0.1.0

Pure-Rust MP3 (MPEG-1/2/2.5 Layer III) decoder + encoder, no C/FFI. Decoder bit-exact vs FFmpeg; the first pure-Rust MP3 encoder (CBR/VBR, joint stereo, bit reservoir).
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

//! The bit reservoir.
//!
//! MP3 main data is not aligned to frame boundaries: a frame's `main_data_begin`
//! points *backwards* by up to 511 bytes into bytes carried over from previous
//! frames. The reservoir holds that tail so each frame's main data can be
//! reassembled into one contiguous bitstream for the Huffman/scalefactor stages.

/// Rolling buffer of recent main-data bytes.
#[derive(Default)]
pub struct Reservoir {
    /// Bytes available from previous frames (the most this needs is 511).
    buf: Vec<u8>,
}

impl Reservoir {
    /// Reassemble this frame's main data: take `main_data_begin` bytes from the
    /// reservoir tail, append the current frame's main data, and refresh the
    /// reservoir for the next frame.
    pub fn assemble(&mut self, main_data_begin: u16, frame_main_data: &[u8]) -> Vec<u8> {
        let begin = main_data_begin as usize;
        let mut out = Vec::with_capacity(begin + frame_main_data.len());
        let tail = self.buf.len().saturating_sub(begin);
        out.extend_from_slice(&self.buf[tail..]);
        out.extend_from_slice(frame_main_data);
        // Keep the last ~511 bytes for the next frame's back-reference.
        self.buf = out.iter().rev().take(512).rev().copied().collect();
        out
    }

    /// Drop carried-over state (seek / discontinuity).
    pub fn reset(&mut self) {
        self.buf.clear();
    }
}