Struct GifPreview 

pub struct GifPreview { /* private fields */ }

Generates an animated GIF preview from a configurable time range.

Uses FFmpeg’s two-pass palettegen + paletteuse approach for high-quality colour fidelity within GIF’s 256-colour limit.

Examples

use ff_encode::GifPreview;
use std::time::Duration;

GifPreview::new("video.mp4")
    .start(Duration::from_secs(10))
    .duration(Duration::from_secs(3))
    .fps(15.0)
    .width(480)
    .output("preview.gif")
    .run()?;

Implementations

impl GifPreview

pub fn new(input: impl AsRef<Path>) -> Self

Creates a new GifPreview for the given input file.

Defaults: start=0s, duration=3s, fps=10.0, width=320, no output path set.

pub fn start(self, t: Duration) -> Self

Sets the start time within the video (default: 0s).

pub fn duration(self, d: Duration) -> Self

Sets the duration of the GIF clip (default: 3s).

pub fn fps(self, fps: f64) -> Self

Sets the output frame rate in frames per second (default: 10.0).

pub fn width(self, w: u32) -> Self

Sets the output width in pixels (default: 320). Height is scaled proportionally, rounded to an even number.

pub fn output(self, path: impl AsRef<Path>) -> Self

Sets the output path for the generated GIF file.

The path must have a .gif extension.

pub fn run(self) -> Result<(), EncodeError>

Runs the GIF generation.

Errors

• EncodeError::MediaOperationFailed — output path not set, output extension is not .gif, fps ≤ 0, or width is zero.
• EncodeError::Ffmpeg — any FFmpeg filter graph or encoding call fails.