Struct RawFrameCache 

pub struct RawFrameCache { /* private fields */ }

A cache that stores raw pixel byte buffers (e.g. decoded video frames) keyed by frame number.

When the cache reaches RAW_FRAME_CACHE_CAPACITY entries the least-recently used frame is evicted before inserting the new one.

Example

use oximedia_edit::render::RawFrameCache;

let mut cache = RawFrameCache::new(4);
let data = cache.get_or_render(0, || vec![0u8; 1024]);
assert_eq!(data.len(), 1024);

Implementations

impl RawFrameCache

pub fn new(capacity: usize) -> Self

Create a new cache with the given capacity (clamped to at least 1).

pub fn get_or_render( &mut self, frame_num: u64, render_fn: impl FnOnce() -> Vec<u8>, ) -> &[u8]

Return a reference to the cached bytes for frame_num, rendering and inserting them via render_fn if not already present.

The rendered bytes are stored in the cache; on subsequent calls the same reference is returned without invoking render_fn.

When the cache is full the oldest frame is evicted first (LRU by insertion order).

pub fn get(&self, frame_num: u64) -> Option<&[u8]>

Return a reference to the cached bytes for frame_num without rendering.

Returns None if the frame is not in the cache.

pub fn insert(&mut self, frame_num: u64, data: Vec<u8>)

Explicitly insert pre-rendered bytes for frame_num.

If the frame already exists it is replaced. If the cache is full the oldest frame is evicted.

pub fn invalidate(&mut self, frame_num: u64)

Invalidate (remove) the cache entry for frame_num, if present.

pub fn clear(&mut self)

Clear all cached frames.

pub fn len(&self) -> usize

Return the number of frames currently in the cache.

pub fn is_empty(&self) -> bool

Return true if the cache contains no frames.

pub fn capacity(&self) -> usize

Return the maximum number of frames this cache holds.

pub fn contains(&self, frame_num: u64) -> bool

Return true if a frame for frame_num is present in the cache.

Trait Implementations

impl Debug for RawFrameCache

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

Formats the value using the given formatter.