Struct SegmentSelector 

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

A selector over a subset of segments, supporting filtering and operations.

Created via methods on Analysis like pauses(), motion(), etc. Filters can be chained, and terminal operations produce SegmentOps.

Implementations

impl<'a> SegmentSelector<'a>

pub fn count(&self) -> usize

Get the number of selected segments.

pub fn is_empty(&self) -> bool

Check if any segments are selected.

pub fn segments(&self) -> &[&'a Segment]

Get the selected segments.

pub fn total_duration_ms(&self) -> u64

Get total duration of selected segments in milliseconds.

pub fn total_frames(&self) -> usize

Get total frame count of selected segments.

pub fn longer_than(self, ms: u32) -> Self

Filter to segments longer than the specified duration.

pub fn shorter_than(self, ms: u32) -> Self

Filter to segments shorter than the specified duration.

pub fn duration_between(self, min_ms: u32, max_ms: u32) -> Self

Filter to segments with duration in the specified range (inclusive).

pub fn frames_gt(self, count: usize) -> Self

Filter to segments with more than N frames.

pub fn frames_lt(self, count: usize) -> Self

Filter to segments with fewer than N frames.

pub fn frames_eq(self, count: usize) -> Self

Filter to segments with exactly N frames.

pub fn filter<F>(self, predicate: F) -> Self

where F: Fn(&Segment) -> bool,

Filter using a custom predicate.

pub fn take(self, n: usize) -> Self

Take only the first N segments.

pub fn skip(self, n: usize) -> Self

Skip the first N segments.

pub fn first(self) -> Self

Take the first segment only.

pub fn last(self) -> Self

Take the last segment only.

pub fn cap(&self, max_ms: u32) -> SegmentOps

Cap duration to a maximum value.

Segments longer than max_ms are collapsed to a single frame with that duration. Shorter segments are unchanged.

pub fn collapse(&self, duration_ms: u32) -> SegmentOps

Collapse each segment to a single frame with the specified duration.

pub fn remove(&self) -> SegmentOps

Remove all selected segments entirely.

pub fn speed_up(&self, factor: f64) -> SegmentOps

Speed up selected segments by a factor.

A factor of 2.0 makes segments play 2x faster (half duration).

pub fn slow_down(&self, factor: f64) -> SegmentOps

Slow down selected segments by a factor.

A factor of 2.0 makes segments play 2x slower (double duration).

pub fn set_duration(&self, ms: u32) -> SegmentOps

Set the total duration for each selected segment.

The duration is distributed evenly across all frames in the segment.

pub fn set_frame_delay(&self, ms: u32) -> SegmentOps

Set a fixed delay for each frame in the selected segments.

pub fn keep(&self) -> SegmentOps

Explicitly keep selected segments unchanged.

This is useful when merging with other operations to ensure certain segments are not modified.

pub fn scale(&self, factor: f64) -> SegmentOps

Scale timing by a raw factor.

Factor < 1.0 speeds up, factor > 1.0 slows down.

Trait Implementations

impl<'a> Clone for SegmentSelector<'a>

fn clone(&self) -> SegmentSelector<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for SegmentSelector<'a>

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

Formats the value using the given formatter.