andelf / tinygif

A no_std GIF library for embedded applications(embedded-graphics)

tinygif

A tiny gif decoder written in no_std Rust. This crate requires about 20kB of memory to decode a gif.

• basic decoding
• frame iterator
• interlace support
• fails on some highly compressed gifs: Change table size in DecodingDict

Usage

Instant and Timer are from Embassy framework, you can replace them with your own delay implementation.

let image = tinygif::Gif::<Rgb565>::from_slice(include_bytes!("../Ferris-240x240.gif")).unwrap();
loop {
    for frame in image.frames() {
        let start = Instant::now();

        frame.draw(&mut display).unwrap();

        let remain_delay = ((frame.delay_centis as u64) * 10).saturating_sub(start.elapsed().as_millis());
        Timer::after_millis(remain_delay).await;

        // Or, draw at given offset
        // use embedded_graphics::prelude::DrawTargetExt;
        // frame.draw(&mut display.translated(Point::new(30, 50))).unwrap();
    }
}

License

MIT or Apache-2.0 at your option.

License of the gif files used in test

Animated Ferris in Action Happy as a Rustacean at Rust Fest Berlin 2016 (www.rustfest.eu)

• CC BY 4.0 Animated Ferris for Rust Fest Berlin by A. L. Palmer
• Resized by ezgif