Struct TimeSync 

pub struct TimeSync { /* private fields */ }

Maintains a sliding window of timestamp samples and computes a linear model mapping device ticks to host time.

Implementations

impl TimeSync

pub fn new(cap: usize) -> Self

Create a new synchroniser retaining up to cap samples.

pub fn update(&mut self, dev_ticks: u64, host: Instant)

Record a new (device_ticks, host_instant) sample.

pub fn len(&self) -> usize

Number of samples retained in the sliding window.

pub fn is_empty(&self) -> bool

Check if samples window is empty

pub fn samples(&self) -> impl Iterator<Item = (u64, Instant)> + '_

Iterator over the samples contained in the sliding window.

pub fn capacity(&self) -> usize

Maximum number of samples stored in the sliding window.

pub fn origin_instant(&self) -> Option<Instant>

Access the origin instant if at least one sample has been recorded.

pub fn origin_system(&self) -> Option<SystemTime>

Access the origin system time if available.

pub fn coefficients(&self) -> (f64, f64)

Retrieve the linear fit coefficients.

pub fn freq_hz(&self) -> Option<f64>

Retrieve the reported device tick frequency.

pub fn sample_bounds(&self) -> Option<((u64, Instant), (u64, Instant))>

Return the first and last sample retained in the window.

pub fn fit(&mut self, freq_hz: Option<f64>) -> Option<(f64, f64)>

Fit a linear model mapping device ticks to host seconds relative to the first recorded instant. Returns the updated (a, b) coefficients when enough samples are available.

pub fn to_host_time(&self, dev_ticks: u64) -> SystemTime

Convert device ticks into a SystemTime using the fitted model.

Trait Implementations

impl Clone for TimeSync

fn clone(&self) -> TimeSync

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TimeSync

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

Formats the value using the given formatter.