Struct FlacDecoder 

pub struct FlacDecoder {
    pub stream_info: Option<FlacStreamInfo>,
    pub comment: Option<FlacVorbisComment>,
    /* private fields */
}

FLAC audio decoder.

Fields

stream_info: Option<FlacStreamInfo>

Stream info parsed from the stream header.

comment: Option<FlacVorbisComment>

Vorbis comment block (if present in the stream).

Implementations

impl FlacDecoder

pub fn new() -> Self

Create a new FLAC decoder.

pub fn stream_info(&self) -> Option<&FlacStreamInfo>

Return a reference to the parsed stream info, if available.

pub fn comment_block(&self) -> Option<&FlacVorbisComment>

Return a reference to the parsed Vorbis comment block, if available.

pub fn parse_metadata(&mut self, data: &[u8]) -> Result<(), CodecError>

Parse all FLAC metadata blocks from the beginning of a FLAC byte stream.

Reads and parses:

• The fLaC stream marker
• All metadata blocks until the last-block flag is set
• STREAMINFO (block type 0) — mandatory first block
• VORBIS_COMMENT (block type 4) — optional

Errors

Returns CodecError::InvalidData if the magic bytes are missing, STREAMINFO is absent or malformed, or any block header is truncated.

pub fn probe(data: &[u8]) -> Result<FlacStreamInfo, CodecError>

Quick-probe a FLAC byte stream: validates the magic bytes and parses the mandatory STREAMINFO block, returning the stream info without retaining state.

Errors

Returns CodecError::InvalidData if the magic is missing or STREAMINFO is malformed.

pub fn parse_stream_header(&mut self, data: &[u8]) -> CodecResult<usize>

Parse the FLAC stream header from the beginning of a FLAC byte stream.

Must be called once before decode_frame.

Errors

Returns CodecError::InvalidData if the magic bytes or STREAMINFO are malformed.

pub fn decode_frame(&self, data: &[u8]) -> CodecResult<(DecodedBlock, usize)>

Decode a single FLAC frame from the given byte slice.

Returns (decoded_block, bytes_consumed).

Errors

Returns CodecError::InvalidData on malformed frame data.

pub fn decode_stream(&mut self, data: &[u8]) -> CodecResult<Vec<i32>>

Decode all frames from a complete FLAC byte stream (header + frames).

Returns interleaved i32 PCM samples for the entire stream.

Errors

Returns CodecError::InvalidData if the stream is malformed.