Struct VorbisDecoder 

pub struct VorbisDecoder {
    pub sample_rate: u32,
    pub channels: u8,
    pub state: DecoderState,
    pub packets_decoded: u64,
    /* private fields */
}

Vorbis audio decoder.

Fields

sample_rate: u32

Sample rate (filled from ID header).

channels: u8

Channel count (filled from ID header).

state: DecoderState

Current decoder state.

packets_decoded: u64

Number of audio packets decoded.

Implementations

impl VorbisDecoder

pub fn new() -> Self

Create a new, uninitialised decoder.

Feed the three header packets via decode_packet before audio.

pub fn decode_packet(&mut self, data: &[u8]) -> CodecResult<Option<Vec<f32>>>

Decode one Vorbis packet.

• Header packets are parsed for configuration.
• Audio packets are decoded to interleaved f32 PCM.

Returns None for header packets, Some(Vec<f32>) for audio.

Errors

Returns CodecError if the packet is malformed.

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

Process a Vorbis header packet and return which header type was parsed.

This is an alternative entry-point to decode_packet for callers that only need the structured header information without PCM output.

Errors

Returns CodecError if the packet is malformed or received out of order.

pub fn id_header(&self) -> Option<&VorbisIdHeader>

Return a reference to the parsed identification header, if available.

pub fn comment_header(&self) -> Option<&VorbisCommentHeader>

Return a reference to the parsed comment header, if available.

pub fn is_ready(&self) -> bool

Returns true once all three Vorbis header packets have been processed and the decoder is ready for audio packets.

pub fn decode_audio_packet(&self, data: &[u8]) -> CodecResult<Vec<f32>>

Validate and structurally decode a Vorbis audio packet.

This checks that the decoder is ready and that the packet starts with the audio-packet type byte (0x00). A full Vorbis II floor/residue decode is performed by decode_packet; this entry-point is provided for callers that only need structural validation.

Errors

Returns CodecError if the decoder is not yet ready, the packet is empty, or the packet-type byte is not 0x00.