Struct EntropyEncoder 

pub struct EntropyEncoder<S: EncoderVariantForS> { /* private fields */ }

High-level entropy encoder using PMF distributions with bypass support.

Generic over S: RansParams (RansByte or Rans64).

Example

use msrtc_rans::entropy::EntropyEncoder;
use msrtc_rans::RansByte;

let mut enc: EntropyEncoder<RansByte> = EntropyEncoder::new();
enc.initialize(
    &[4, 6],       // pmf_lengths
    &[1, 2],       // pmf_offsets
    &[1, 3, 1, 1, 1, 3, 5, 3, 1, 1],  // pmf_table
    16,            // symbol_bits
    4,             // bypass_bits
).unwrap();

let mut buffer = Vec::new();
enc.encode(&[0, 1], &[1, 1], &mut buffer).unwrap();

Implementations

impl<S: EncoderVariantForS> EntropyEncoder<S>

pub fn new() -> Self

Create a new uninitialized entropy encoder.

pub fn initialize( &mut self, pmf_lengths: &[i32], pmf_offsets: &[i32], pmf_table: &[i32], symbol_bits: u32, bypass_bits: u32, ) -> Result<(), EntropyError>

Initialize the encoder with PMF distribution data.

• pmf_lengths — number of symbols per distribution (including bypass sentinel)
• pmf_offsets — value offsets per distribution
• pmf_table — flat array of symbol frequencies for all distributions
• symbol_bits — number of bits for symbol encoding (e.g. 16)
• bypass_bits — number of bits for bypass encoding (e.g. 4)

pub fn encode( &self, indices: &[i32], values: &[i32], buffer: &mut Vec<u8>, ) -> Result<(), EntropyError>

One-shot encode: encode indices/values into buffer.

The encoded bytes are appended to buffer.

Trait Implementations

impl<S: EncoderVariantForS> Default for EntropyEncoder<S>

fn default() -> Self

Returns the “default value” for a type.