Struct FrameTrimConfig 

pub struct FrameTrimConfig {
    pub fps_num: u32,
    pub fps_den: u32,
    pub total_source_frames: Option<u64>,
    pub ranges: Vec<TrimRange>,
}

Complete frame-accurate trim / multi-cut configuration for a transcode job.

Multiple TrimRange entries create a cut list — the pipeline concatenates only the segments that correspond to each range.

Fields

fps_num: u32

Source frame rate numerator.

fps_den: u32

Source frame rate denominator.

total_source_frames: Option<u64>

Total frame count of the source (used for bounds checking).

ranges: Vec<TrimRange>

Ordered list of ranges to include in the output.

Implementations

impl FrameTrimConfig

pub fn new(fps_num: u32, fps_den: u32) -> Self

Creates a new trim config for the given frame rate.

pub fn total_frames(self, n: u64) -> Self

Sets the total frame count for bounds checking.

pub fn add_range(self, range: TrimRange) -> Self

Adds a trim range.

pub fn validate_and_resolve(&self) -> Result<Vec<ResolvedTrimRange>>

Validates all ranges and returns resolved ranges sorted by in-point.

Errors

Returns an error if any range is invalid or if ranges overlap.

pub fn total_output_frames(&self) -> Result<u64>

Returns the total output frame count across all ranges.

Errors

Returns an error if validation fails.

pub fn total_output_duration_ms(&self) -> Result<u64>

Returns the total output duration in milliseconds.

Errors

Returns an error if validation fails.

pub fn should_include_frame(&self, frame: u64) -> bool

Returns true if the given source frame should be included in the output.

Pre-resolves ranges lazily; panics-safe (returns false on error).

Trait Implementations

impl Clone for FrameTrimConfig

fn clone(&self) -> FrameTrimConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrameTrimConfig

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

Formats the value using the given formatter.