Struct EditorVideoStream 

pub struct EditorVideoStream {
    path: PathBuf,
    meta: VideoMetadata,
    stream: Option<GstreamerPipeStream>,
    next_index: u64,
    cache: FrameCache,
    spawn_count: u64,
}

A frame-indexed, seekable view over a video file, backed by the forward-only GstreamerPipeStream plus an LRU frame cache.

Construct with EditorVideoStream::open, then pull any frame by index with EditorVideoStream::frame (or seek by time with EditorVideoStream::seek_to_time). Out-of-range indices clamp to the last frame.

Fields

path: PathBuf

meta: VideoMetadata

stream: Option<GstreamerPipeStream>

next_index: u64

Index the underlying forward stream will produce next.

cache: FrameCache

spawn_count: u64

Implementations

impl EditorVideoStream

pub fn open(path: &Path) -> Result<Self>

Probe path and prepare a seekable stream with the default cache size. No decode pipe is spawned until the first frame call.

Errors

Returns the underlying probe error if gst-discoverer-1.0 can’t read the file (missing tool, unreadable media).

pub fn open_with_cache(path: &Path, cache_frames: usize) -> Result<Self>

As open with an explicit cache capacity (frames).

Errors

See open.

pub fn width(&self) -> u32

Frame width in pixels.

pub fn height(&self) -> u32

Frame height in pixels.

pub fn frame_rate(&self) -> f32

Source frame rate (fps).

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

Total frame count, if the container reported a duration.

pub fn spawn_count(&self) -> u64

How many times the underlying decode pipe has been (re)spawned. Diagnostic — used by tests to assert the cache avoids re-spawns.

fn last_index(&self) -> Option<u64>

pub fn frame(&mut self, index: u64) -> Option<VideoFrame>

Return the frame at index, decoding (and re-spawning) as needed. Out-of-range indices clamp to the last frame. Returns None only when the decode pipe can’t be spawned or the stream ends early.

pub fn seek_to_time(&mut self, time: Duration) -> Option<VideoFrame>

Seek to the frame nearest time and return it.

fn respawn(&mut self) -> Option<()>

Trait Implementations

impl Debug for EditorVideoStream

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

Formats the value using the given formatter.