Struct PlayerRunner 

pub struct PlayerRunner { /* private fields */ }

Exclusive owner of the decode pipeline. Move to a background thread and call run.

Configure with set_sink, use_proxy_if_available, and set_hardware_accel before calling run.

Implementations

impl PlayerRunner

pub fn set_sink(&mut self, sink: Box<dyn FrameSink>)

Register the frame sink. Call before run.

pub fn set_hardware_accel(&mut self, accel: HardwareAccel) -> &mut Self

Configure hardware acceleration. Call before run.

The setting takes effect at the start of run(). HardwareAccel::Auto (the default) probes available backends and falls back to software. HardwareAccel::None forces CPU-only decoding.

pub fn active_source(&self) -> &Path

Returns the path currently being decoded (original or active proxy).

pub fn with_frame_cache_budget(self, bytes: usize) -> Self

Enable an in-memory RGBA frame cache with the given byte budget.

When the budget is set, frames decoded during playback are stored and served on cache hit without re-decoding, enabling instant scrubbing. The cache is invalidated automatically whenever a seek targets a PTS outside the currently cached range.

Example: runner.with_frame_cache_budget(512 * 1024 * 1024) for 512 MB.

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

Container-reported duration, or None for live / streaming sources.

pub fn use_proxy_if_available(&mut self, proxy_dir: &Path) -> bool

Activate a lower-resolution proxy if one exists in proxy_dir.

Must be called before run. Returns true if a proxy was found and activated; false if no proxy exists or activation failed.

Proxy lookup order: half → quarter → eighth; first match wins.

pub fn run(self) -> Result<(), PreviewError>

A/V sync presentation loop.

Blocks until a PlayerCommand::Stop is received, the end of file is reached, or an unrecoverable decode error occurs.

At the top of each frame, all pending commands are drained from the channel. Consecutive PlayerCommand::Seek commands are coalesced — only the last one executes.

Emits PlayerEvent::SeekCompleted after each successful seek, PlayerEvent::PositionUpdate after each presented video frame, PlayerEvent::Error on non-fatal decode errors, and PlayerEvent::Eof before returning.

Errors

Returns PreviewError if a seek fails.

Trait Implementations

impl Drop for PlayerRunner

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.