Struct Timestamp 

pub struct Timestamp {
    pub value: i64,
    pub base: TimeBase,
}

A timestamp in a particular time base.

Fields

value: i64

Tick count in base units.

base: TimeBase

The time base the tick count is expressed in.

Implementations

impl Timestamp

pub const fn new(value: i64, base: TimeBase) -> Self

Construct a timestamp of value ticks in base.

pub fn from_seconds(seconds: f64, base: TimeBase) -> Self

Construct a timestamp at seconds in the given base, rounded to the nearest tick. Sugar over Timestamp::new(base.ticks_of(s), base).

pub fn seconds(&self) -> f64

The timestamp as fractional seconds (value × base).

pub fn rescale(&self, target: TimeBase) -> Self

Rescale onto target with half-away-from-zero rounding; the saturating/defaulting semantics of rescale.

pub fn rescale_rnd(&self, target: TimeBase, rounding: Rounding) -> Self

Rescale onto target with an explicit Rounding mode. Muxers that must never stamp a DTS later than the true instant use Rounding::Floor; Rounding::NearestAway reproduces rescale.

pub fn checked_rescale(&self, target: TimeBase) -> Option<Self>

Rescale onto target, returning None when the conversion is undefined (zero term in the factor) or the result doesn’t fit i64 — instead of the defaulting/saturating rescale.

pub fn checked_add_ticks(&self, ticks: i64) -> Option<Self>

Advance the timestamp by ticks units in its own base. Returns None on i64 overflow rather than wrapping silently — muxers that compute a packet-end timestamp at the edge of the representable range get a clean signal instead of a wrap.

pub fn checked_sub_ticks(&self, ticks: i64) -> Option<Self>

Move the timestamp backwards by ticks units in its own base. Returns None on i64 overflow.

pub fn checked_diff(&self, other: Timestamp) -> Option<i64>

Tick-difference self - other after rescaling other onto self’s base. Returns None when the subtraction would overflow i64 (rare in practice but easy to surface cleanly).

Use this to compute the duration between two Timestamps that may have been produced by different sources (e.g. a packet from a container demuxer minus a packet from a different demuxer in a remux pipeline).

Trait Implementations

impl Clone for Timestamp

fn clone(&self) -> Timestamp

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Timestamp

impl Debug for Timestamp

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

Formats the value using the given formatter.

impl Eq for Timestamp

impl Hash for Timestamp

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

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 Timestamp

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Timestamp