Struct TimeRange 

pub struct TimeRange { /* private fields */ }

A half-open time range [start, end) in a given Timebase.

Represents the extent of a detected event — for example, a fade-out → fade-in span. When start == end, the range is degenerate (an instant); see Self::instant.

Both endpoints share the same Timebase. To compare ranges across different timebases, rescale one of them first (e.g., by calling Timestamp::rescale_to on each endpoint).

Implementations

impl TimeRange

pub const fn new(start: i64, end: i64, timebase: Timebase) -> TimeRange

Creates a new TimeRange with the given start/end PTS and shared timebase.

Panics

• Panics if end < start (negative duration).

pub const fn try_new( start: i64, end: i64, timebase: Timebase, ) -> Option<TimeRange>

Fallible variant of Self::new: returns None if end < start instead of panicking. Accepts start == end (degenerate instant range).

pub const fn instant(ts: Timestamp) -> TimeRange

Creates a degenerate (instant) range where start == end == ts.pts().

pub const fn start_pts(&self) -> i64

Returns the start PTS in the range’s timebase units.

pub const fn end_pts(&self) -> i64

Returns the end PTS in the range’s timebase units.

pub const fn timebase(&self) -> Timebase

Returns the shared timebase.

pub const fn start(&self) -> Timestamp

Returns the start as a Timestamp.

pub const fn end(&self) -> Timestamp

Returns the end as a Timestamp.

pub const fn with_start(self, val: i64) -> TimeRange

Sets the start PTS.

pub const fn set_start(&mut self, val: i64) -> &mut TimeRange

Sets the start PTS in place.

pub const fn with_end(self, val: i64) -> TimeRange

Sets the end PTS.

pub const fn set_end(&mut self, val: i64) -> &mut TimeRange

Sets the end PTS in place.

pub const fn with_timebase(self, timebase: Timebase) -> TimeRange

Sets the shared timebase.

pub const fn set_timebase(&mut self, timebase: Timebase) -> &mut TimeRange

Sets the shared timebase in place.

pub const fn is_instant(&self) -> bool

Returns true if start == end (a degenerate instant range).

pub const fn total_pts(&self) -> i64

Returns the span in PTS units (end - start) in this timebase.

Always non-negative given the start <= end constructor invariant. Saturates at i64::MAX in the pathological case where end - start would overflow i64 (e.g., start = i64::MIN, end = i64::MAX).

pub const fn duration(&self) -> Duration

Returns the elapsed Duration from start to end, or None if end is before start.

pub const fn rescale_to(self, target: Timebase) -> TimeRange

Returns a new TimeRange representing the same span in a different timebase.

Rescales both endpoints via Timebase::rescale_pts (rounds toward zero); round-tripping through a coarser timebase can lose precision. Because rescaling is monotonic, the start <= end invariant is preserved.

pub const fn interpolate(&self, t: f64) -> Timestamp

Linearly interpolates between start and end: t = 0.0 returns start, t = 1.0 returns end, t = 0.5 the midpoint. t is clamped to [0.0, 1.0]. Rounds toward zero.

Use this to map an old-style bias value b ∈ [-1, 1] onto the range: range.interpolate((b + 1.0) * 0.5).

Trait Implementations

impl Arbitrary for TimeRange

fn arbitrary(g: &mut Gen) -> TimeRange

Return an arbitrary value.

fn shrink(&self) -> Box<dyn Iterator<Item = Self>>

Return an iterator of values that are smaller than itself.

impl<'a> Arbitrary<'a> for TimeRange

fn arbitrary(u: &mut Unstructured<'a>) -> Result<TimeRange, Error>

Generate an arbitrary value of Self from the given unstructured data.

fn arbitrary_take_rest(u: Unstructured<'a>) -> Result<Self, Error>

Generate an arbitrary value of Self from the entirety of the given unstructured data.

fn size_hint(depth: usize) -> (usize, Option<usize>)

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

fn try_size_hint( depth: usize, ) -> Result<(usize, Option<usize>), MaxRecursionReached>

Get a size hint for how many bytes out of an Unstructured this type needs to construct itself.

impl Clone for TimeRange

fn clone(&self) -> TimeRange

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for TimeRange

impl Debug for TimeRange

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

Formats the value using the given formatter.

impl Default for TimeRange

fn default() -> TimeRange

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for TimeRange

fn deserialize<__D>( __deserializer: __D, ) -> Result<TimeRange, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for TimeRange

impl Hash for TimeRange

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for TimeRange

fn eq(&self, other: &TimeRange) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for TimeRange

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TimeRange