Struct TranscodeBenchmark 

pub struct TranscodeBenchmark { /* private fields */ }

Utility for benchmarking and comparing multiple codec configurations.

TranscodeBenchmark accumulates BenchmarkResults and provides sorting / reporting helpers. The actual encoding is driven by the caller; this type manages the result lifecycle and report generation.

Implementations

impl TranscodeBenchmark

pub fn new(content_duration_secs: f64) -> Self

Creates a new benchmark for content with the given duration.

pub fn start_timing(&self) -> BenchmarkTimer

Starts timing for a candidate. Returns a BenchmarkTimer that records the elapsed time when dropped or when BenchmarkTimer::finish is called.

pub fn record_result(&mut self, result: BenchmarkResult)

Records a result from an already-completed encode.

pub fn record( &mut self, candidate: BenchmarkCandidate, elapsed: Duration, file_size_bytes: u64, psnr: Option<f64>, ssim: Option<f64>, )

Convenience: build a BenchmarkResult from timing and file-size data and record it.

pub fn result_count(&self) -> usize

Returns the number of recorded results.

pub fn by_speed(&self) -> Vec<&BenchmarkResult>

Returns results sorted by encoding speed (fastest first).

pub fn by_file_size(&self) -> Vec<&BenchmarkResult>

Returns results sorted by file size (smallest first).

pub fn by_psnr(&self) -> Vec<&BenchmarkResult>

Returns results sorted by PSNR (highest first).

Results without PSNR data are sorted to the end.

pub fn by_composite_score(&self) -> Vec<&BenchmarkResult>

Returns results sorted by composite score (best first).

pub fn best(&self) -> Option<&BenchmarkResult>

Returns the result with the best composite score, if any.

pub fn report(&self) -> Result<String>

Generates a human-readable Markdown report table.

Errors

Returns an error if there are no results to report.

pub fn results(&self) -> &[BenchmarkResult]

Returns all raw results.