Struct TwoPassStatistics 

pub struct TwoPassStatistics {

    pub frame_count: usize,
    pub mean_complexity: f64,
    pub peak_complexity: f64,
    pub min_complexity: f64,
    pub complexity_std_dev: f64,
    pub complex_region_fraction: f64,
    pub total_bit_budget: u64,
    pub avg_bits_per_frame: u64,
    pub max_bits_per_frame: u64,
    pub min_bits_per_frame: u64,
    pub target_bitrate_kbps: u32,
    pub duration_ms: u64,
    pub complexity_histogram: [u32; 10],
    pub scene_change_indices: Vec<usize>,
}

Comprehensive statistics collected from the two-pass encoding process.

This provides detailed information about the content complexity, bit allocation, and quality metrics gathered during the first pass that guides the second pass encoding.

Fields

frame_count: usize

Total number of frames analyzed.

mean_complexity: f64

Mean complexity score across all frames (0.0-1.0).

peak_complexity: f64

Peak (maximum) complexity observed.

min_complexity: f64

Minimum complexity observed.

complexity_std_dev: f64

Standard deviation of complexity scores.

complex_region_fraction: f64

Fraction of frames classified as complex regions (0.0-1.0).

total_bit_budget: u64

Total bit budget in bits.

avg_bits_per_frame: u64

Average bits per frame.

max_bits_per_frame: u64

Maximum bits allocated to any single frame.

min_bits_per_frame: u64

Minimum bits allocated to any single frame.

target_bitrate_kbps: u32

Target bitrate in kbps.

duration_ms: u64

Content duration in milliseconds.

complexity_histogram: [u32; 10]

Complexity histogram (10 bins covering 0.0-1.0).

scene_change_indices: Vec<usize>

Scene change indices (frames where complexity jumps significantly).

Implementations

impl TwoPassStatistics

pub fn content_uniformity(&self) -> f64

Returns the compression ratio (mean complexity / peak complexity).

Values close to 1.0 indicate uniform content; values close to 0.0 indicate highly variable content that benefits most from two-pass.

pub fn bit_allocation_ratio(&self) -> f64

Returns the bit allocation ratio (max bits / avg bits).

Higher values indicate more aggressive bit redistribution.

pub fn benefits_from_two_pass(&self) -> bool

Returns true if the content would significantly benefit from two-pass encoding (high complexity variance).

pub fn scene_change_count(&self) -> usize

Returns the number of detected scene changes.

pub fn summary(&self) -> String

Returns a human-readable summary of the statistics.

Trait Implementations

impl Clone for TwoPassStatistics

fn clone(&self) -> TwoPassStatistics

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TwoPassStatistics

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.