Struct PlaybackTimeline 

pub struct PlaybackTimeline {
    pub samples_played: Arc<AtomicU64>,
    /* private fields */
}

Shared timeline that the decode thread writes and the UI reads. The decode thread appends boundaries; the UI reads them + samples_played to derive current track and position.

Fields

samples_played: Arc<AtomicU64>

Total interleaved samples consumed (played) by the audio engine. Written by the audio render callback, read by UI.

Implementations

impl PlaybackTimeline

pub fn new() -> Arc<Self>

pub fn on_queued(&self, f: impl Fn() + Send + Sync + 'static)

Call f whenever the decoder queues another track.

pub fn playhead(&self) -> Option<(QueueItemId, u64)>

The track under the playhead and how far into it, without the clones current_playback makes.

pub fn position_of(&self, id: QueueItemId) -> Option<u64>

How far into id playback has got, stopping at its end once the playhead has moved on to the next track.

pub fn until_next_track(&self) -> Option<Duration>

How long until the playhead reaches the track queued after the one playing, at the rate this one plays. None with nothing queued.

pub fn generation(&self) -> u64

The current session’s generation, to be handed to writer.

Read on the player thread between reset() and spawning the decode thread, so a session can never capture a generation newer than its own.

pub fn writer(&self, generation: u64) -> TimelineWriter<'_>

Open a write handle for the session identified by generation.

pub fn reset(&self)

Reset for a new playback session.

pub fn samples_played_counter(&self) -> Arc<AtomicU64>

Get a clone of the samples_played Arc for the audio engine.

pub fn current_playback( &self, ) -> Option<(QueueItemId, PathBuf, StreamInfo, u64)>

Derive current track info and position from the playback head. Returns (id, path, stream_info, position_ms).

Acquires the boundaries read lock BEFORE reading samples_played so channels/sample_rate/boundaries are all from a consistent snapshot. Without this ordering, a track transition could update the atomics after we read samples_played but before we read the boundary list.

Trait Implementations

impl Debug for PlaybackTimeline

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

Formats the value using the given formatter.