Struct BitReader 

pub struct BitReader<'a> { /* private fields */ }

Bit-level reader for parsing JPEG-XL bitstreams.

Reads bits from a byte buffer in LSB-first order, which is the convention used by JPEG-XL codestreams (and ANS entropy coding).

Implementations

impl<'a> BitReader<'a>

pub fn new(data: &'a [u8]) -> Self

Create a new bit reader over a byte slice.

pub fn read_bits(&mut self, n: u8) -> CodecResult<u32>

Read up to 32 bits from the stream (LSB first).

Errors

Returns CodecError::InvalidBitstream if not enough bits remain.

pub fn read_bool(&mut self) -> CodecResult<bool>

Read a single boolean bit.

pub fn read_u8(&mut self, n: u8) -> CodecResult<u8>

Read up to 8 bits as a u8.

pub fn read_u16(&mut self, n: u8) -> CodecResult<u16>

Read up to 16 bits as a u16.

pub fn read_u32(&mut self, n: u8) -> CodecResult<u32>

Read up to 32 bits as a u32.

pub fn read_u64(&mut self) -> CodecResult<u64>

Read a u64 value using JPEG-XL’s U64 encoding.

The JXL U64 encoding uses a selector to determine how many bits follow:

• 0: value = 0
• 1: value = 1 + read(4)
• 2: value = 17 + read(8)
• 3: value = read(12) + (read variable chunks until done)

pub fn remaining_bits(&self) -> usize

Number of bits remaining in the stream.

pub fn align_to_byte(&mut self)

Align the reader to the next byte boundary.

If already at a byte boundary, this is a no-op.

pub fn byte_position(&self) -> usize

Get current byte position.

pub fn is_empty(&self) -> bool

Check if the reader has been exhausted.