Struct Timestamp 

pub struct Timestamp { /* private fields */ }

A timestamp representing a point in time within a media stream.

Timestamps are represented as a presentation timestamp (PTS) value combined with a time base that defines the unit of measurement.

Time Base

The time base is a rational number that represents the duration of one timestamp unit. For example:

• 1/90000: Each PTS unit is 1/90000 of a second (MPEG-TS)
• 1/1000: Each PTS unit is 1 millisecond
• 1/48000: Each PTS unit is one audio sample at 48kHz

Examples

use ff_format::{Rational, Timestamp};
use std::time::Duration;

// Create a timestamp at 1 second using 90kHz time base
let time_base = Rational::new(1, 90000);
let ts = Timestamp::new(90000, time_base);

assert!((ts.as_secs_f64() - 1.0).abs() < 0.0001);
assert_eq!(ts.as_millis(), 1000);

// Convert from Duration
let ts2 = Timestamp::from_duration(Duration::from_secs(1), time_base);
assert_eq!(ts2.pts(), 90000);

Implementations

impl Timestamp

pub const fn new(pts: i64, time_base: Rational) -> Self

Creates a new timestamp with the given PTS value and time base.

Arguments

• pts - The presentation timestamp value
• time_base - The time base (duration of one PTS unit)

Examples

use ff_format::{Rational, Timestamp};

let time_base = Rational::new(1, 1000);  // milliseconds
let ts = Timestamp::new(500, time_base);  // 500ms
assert_eq!(ts.as_millis(), 500);

pub const fn zero(time_base: Rational) -> Self

Creates a timestamp representing zero (0 PTS).

Examples

use ff_format::{Rational, Timestamp};

let time_base = Rational::new(1, 90000);
let zero = Timestamp::zero(time_base);
assert_eq!(zero.pts(), 0);
assert_eq!(zero.as_secs_f64(), 0.0);

pub fn from_duration(duration: Duration, time_base: Rational) -> Self

Creates a timestamp from a Duration value.

Arguments

• duration - The duration to convert
• time_base - The target time base for the resulting timestamp

Examples

use ff_format::{Rational, Timestamp};
use std::time::Duration;

let time_base = Rational::new(1, 90000);
let ts = Timestamp::from_duration(Duration::from_millis(1000), time_base);
assert_eq!(ts.pts(), 90000);

pub fn from_secs_f64(secs: f64, time_base: Rational) -> Self

Creates a timestamp from a seconds value.

Examples

use ff_format::{Rational, Timestamp};

let time_base = Rational::new(1, 1000);
let ts = Timestamp::from_secs_f64(1.5, time_base);
assert_eq!(ts.pts(), 1500);

pub fn from_millis(millis: i64, time_base: Rational) -> Self

Creates a timestamp from milliseconds.

Examples

use ff_format::{Rational, Timestamp};

let time_base = Rational::new(1, 90000);
let ts = Timestamp::from_millis(1000, time_base);
assert_eq!(ts.pts(), 90000);

pub const fn pts(&self) -> i64

Returns the presentation timestamp value.

Examples

use ff_format::{Rational, Timestamp};

let ts = Timestamp::new(12345, Rational::new(1, 90000));
assert_eq!(ts.pts(), 12345);

pub const fn time_base(&self) -> Rational

Returns the time base.

Examples

use ff_format::{Rational, Timestamp};

let time_base = Rational::new(1, 90000);
let ts = Timestamp::new(100, time_base);
assert_eq!(ts.time_base(), time_base);

pub fn as_duration(&self) -> Duration

Converts the timestamp to a Duration.

Note: Negative timestamps will be clamped to zero Duration.

Examples

use ff_format::{Rational, Timestamp};
use std::time::Duration;

let ts = Timestamp::new(90000, Rational::new(1, 90000));
let duration = ts.as_duration();
assert_eq!(duration, Duration::from_secs(1));

pub fn as_secs_f64(&self) -> f64

Converts the timestamp to seconds as a floating-point value.

Examples

use ff_format::{Rational, Timestamp};

let ts = Timestamp::new(45000, Rational::new(1, 90000));
assert!((ts.as_secs_f64() - 0.5).abs() < 0.0001);

pub fn as_millis(&self) -> i64

Converts the timestamp to milliseconds.

Examples

use ff_format::{Rational, Timestamp};

let ts = Timestamp::new(90000, Rational::new(1, 90000));
assert_eq!(ts.as_millis(), 1000);

pub fn as_micros(&self) -> i64

Converts the timestamp to microseconds.

Examples

use ff_format::{Rational, Timestamp};

let ts = Timestamp::new(90, Rational::new(1, 90000));
assert_eq!(ts.as_micros(), 1000);  // 90/90000 = 0.001 sec = 1000 microseconds

pub fn as_frame_number(&self, fps: f64) -> u64

Converts the timestamp to a frame number at the given frame rate.

Arguments

• fps - The frame rate (frames per second)

Examples

use ff_format::{Rational, Timestamp};

let ts = Timestamp::new(90000, Rational::new(1, 90000));  // 1 second
assert_eq!(ts.as_frame_number(30.0), 30);  // 30 fps
assert_eq!(ts.as_frame_number(60.0), 60);  // 60 fps

pub fn as_frame_number_rational(&self, fps: Rational) -> u64

Converts the timestamp to a frame number using a rational frame rate.

Arguments

• fps - The frame rate as a rational number

Examples

use ff_format::{Rational, Timestamp};

let ts = Timestamp::new(90000, Rational::new(1, 90000));  // 1 second
let fps = Rational::new(30000, 1001);  // 29.97 fps
let frame = ts.as_frame_number_rational(fps);
assert!(frame == 29 || frame == 30);  // Should be approximately 30

pub fn rescale(&self, new_time_base: Rational) -> Self

Rescales this timestamp to a different time base.

Arguments

• new_time_base - The target time base

Examples

use ff_format::{Rational, Timestamp};

let ts = Timestamp::new(1000, Rational::new(1, 1000));  // 1 second
let rescaled = ts.rescale(Rational::new(1, 90000));
assert_eq!(rescaled.pts(), 90000);

pub const fn is_zero(&self) -> bool

Returns true if this timestamp is zero.

Examples

use ff_format::{Rational, Timestamp};

let zero = Timestamp::zero(Rational::new(1, 90000));
assert!(zero.is_zero());

let non_zero = Timestamp::new(100, Rational::new(1, 90000));
assert!(!non_zero.is_zero());

pub const fn is_negative(&self) -> bool

Returns true if this timestamp is negative.

Examples

use ff_format::{Rational, Timestamp};

let negative = Timestamp::new(-100, Rational::new(1, 90000));
assert!(negative.is_negative());

Trait Implementations

impl Add<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, rhs: Duration) -> Self::Output

Performs the + operation.

impl Add for Timestamp

type Output = Timestamp

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

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 Debug for Timestamp

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

Formats the value using the given formatter.

impl Default for Timestamp

fn default() -> Self

Returns a default timestamp (0 with 1/90000 time base).

impl Display for Timestamp

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

Formats the value using the given formatter.

impl Ord for Timestamp

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Timestamp

fn eq(&self, other: &Self) -> 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 PartialOrd for Timestamp

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Sub<Duration> for Timestamp

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, rhs: Duration) -> Self::Output

Performs the - operation.

impl Sub for Timestamp

type Output = Timestamp

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.

impl Copy for Timestamp

impl Eq for Timestamp