Struct FramePool 

pub struct FramePool { /* private fields */ }

Frame pool for reusing frame allocations.

Supports both typed VideoFrame/AudioFrame recycling and a raw byte-buffer free-list that can be pre-allocated via FramePoolConfig.

Implementations

impl FramePool

pub fn new(capacity: usize) -> Self

Create a new frame pool with the given capacity for typed frames.

pub fn with_config(config: FramePoolConfig) -> Self

Create a pool pre-populated according to config.

config.pre_allocate zeroed buffers of config.frame_bytes bytes are placed in the internal free-list immediately, so the first pre_allocate calls to Self::acquire_raw return without any heap allocation.

pub fn acquire_raw(&mut self) -> Vec<u8>

Acquire a raw byte buffer from the free-list, or allocate a new one.

If frame_bytes was set in the config, the returned buffer is exactly that size. Otherwise a zero-length buffer is returned for newly allocated entries — callers should resize as needed.

pub fn release_raw(&mut self, buf: Vec<u8>)

Return a raw byte buffer to the free-list for reuse.

Silently drops the buffer when the free-list is at capacity.

pub fn pre_allocated_count(&self) -> usize

Number of raw buffers currently available in the free-list.

pub fn get_video_frame( &mut self, format: PixelFormat, width: u32, height: u32, ) -> VideoFrame

Get a video frame from the pool or create a new one.

pub fn return_video_frame(&mut self, frame: VideoFrame)

Return a video frame to the pool.

pub fn get_audio_frame( &mut self, format: SampleFormat, sample_rate: u32, channels: ChannelLayout, ) -> AudioFrame

Get an audio frame from the pool or create a new one.

pub fn return_audio_frame(&mut self, frame: AudioFrame)

Return an audio frame to the pool.

pub fn clear(&mut self)

Clear all pooled frames.

pub fn video_frame_count(&self) -> usize

Get the number of video frames in the pool.

pub fn audio_frame_count(&self) -> usize

Get the number of audio frames in the pool.

Trait Implementations

impl Default for FramePool

fn default() -> Self

Returns the “default value” for a type.