Crate ff_preview 

ff-preview

Real-time video/audio preview and proxy workflow for the avio crate family.

This crate provides single-file playback (PreviewPlayer) with frame-accurate seek, A/V sync, and an optional proxy generation workflow.

Feature Flags

Feature	Description	Default
tokio	Async AsyncPreviewPlayer backed by spawn_blocking	no
proxy	ProxyGenerator for lower-resolution proxy files	no

Usage

use ff_preview::{PreviewPlayer, RgbaSink};

let mut player = PreviewPlayer::open("clip.mp4")?;
player.set_sink(Box::new(RgbaSink::new()));
player.play();
player.run()?;

Re-exports

pub use audio::AudioMixer;

pub use audio::AudioTrackHandle;

pub use error::PreviewError;

pub use event::PlayerEvent;

pub use playback::DecodeBuffer;

pub use playback::DecodeBufferBuilder;

pub use playback::FrameResult;

pub use playback::FrameSink;

pub use playback::PlaybackClock;

pub use playback::PlayerCommand;

pub use playback::PlayerHandle;

pub use playback::PlayerRunner;

pub use playback::PreviewPlayer;

pub use playback::RgbaFrame;

pub use playback::RgbaSink;

pub use playback::SeekEvent;

pub use playback::AsyncPreviewPlayer;

pub use proxy::ProxyGenerator;

pub use proxy::ProxyJob;

pub use proxy::ProxyResolution;

pub use scene::Scene;

pub use scene::SceneAudioPlacement;

pub use scene::SceneAudioTrack;

pub use scene::ScenePlacement;

pub use scene::ScenePlayer;

pub use scene::SceneRunner;

pub use scene::SceneVideoTrack;

Modules

audio

Multi-track audio mixer for real-time preview.

error

Error types for ff-preview.

event

Player event types emitted by PlayerRunner.

playback

Real-time playback types for ff-preview.

proxy

Proxy file generation for ff-preview.

scene

Real-time playback of a Scene.

Enums

ErrorSeverity

Severity class of a media error: whether the failing operation can be retried without rebuilding the component that raised it.

HardwareAccel

Hardware acceleration configuration.

Traits

MediaError

Shared classification for the ff-* crate error types.