ff-common

Shared buffer-pooling abstractions for the ff-* crate family.

Project status (as of 2026-03-26): This crate is in an early phase. The high-level API is designed and reviewed by hand; AI is used as an accelerator to implement FFmpeg bindings efficiently. Code contributions are not expected at this time — questions, bug reports, and feature requests are welcome. See the main repository for full context.

Overview

ff-common provides the FramePool trait and PooledBuffer type used internally across the ff-* crates. It has no external dependencies and does not link against FFmpeg.

PooledBuffer wraps an allocated block of memory and returns it to the originating pool automatically when dropped — no manual free call is needed. If no pool is associated, the memory is simply deallocated. FramePool is Send + Sync, so pools can be shared across threads without additional locking.

Usage

ff-common is an internal workspace crate. It is not intended for direct use in application code. The following example shows the PooledBuffer::standalone constructor, which allocates a buffer without a backing pool:

use ff_common::PooledBuffer;

// Allocate a 4096-byte buffer with no pool backing.
// Memory is freed normally when `buf` is dropped.
let buf = PooledBuffer::standalone(4096);
assert_eq!(buf.len(), 4096);

MSRV

Rust 1.93.0 (edition 2024).

License

MIT OR Apache-2.0