Struct Player 

pub struct Player {
    pub(crate) stream: Box<dyn VideoStream + Send>,
    pub(crate) texture: VideoTexture,
    pub(crate) state: PlayState,
    pub(crate) elapsed: Duration,
    pub(crate) next_due: Duration,
    pub(crate) last_uploaded_pts: Option<f64>,
    pub(crate) last_uploaded_index: Option<u64>,
}

Player state machine. Owns the upstream stream and the GPU texture holding the current frame.

Fields

stream: Box<dyn VideoStream + Send>

texture: VideoTexture

state: PlayState

elapsed: Duration

next_due: Duration

Wallclock time at which the next frame in the stream becomes presentable. Initialised to zero so the first tick always pulls.

last_uploaded_pts: Option<f64>

last_uploaded_index: Option<u64>

Implementations

impl Player

pub fn new(app: &Application, stream: Box<dyn VideoStream + Send>) -> Self

Build a player around an arbitrary [VideoStream].

Allocates a VideoTexture matching the stream dimensions; that allocation is reused for every frame.

pub fn play(&mut self)

Transition to PlayState::Playing. No-op if already playing or the stream has ended.

pub fn pause(&mut self)

Transition to PlayState::Paused. No-op if not playing.

pub fn tick(&mut self, app: &Application, dt: Duration) -> u32

Advance playback by dt. Pulls and uploads as many frames as have come due — typically zero or one per render tick, but this handles burst catch-up (multiple frames due) cleanly.

No-op when paused / ended. Returns the number of frames uploaded so callers can drive a redraw signal off it.

pub(crate) fn upload(&mut self, app: &Application, frame: &VideoFrame)

pub fn texture(&self) -> &Texture

Borrow the current frame’s GPU texture for use as a Sprite source.

pub fn state(&self) -> PlayState

Current transport state.

pub fn elapsed(&self) -> Duration

Total wallclock time advanced since play() first fired.

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

Presentation timestamp of the last uploaded frame, if any.

pub fn last_uploaded_index(&self) -> Option<u64>

Frame index of the last uploaded frame, if any.

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

Duration hint, derived from the stream’s frame count + frame rate.