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

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

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

        let delay_ms = frame.delay_centis * 10;
        info!("delay {}", delay_ms);
        // Delay here
        // Timer::after(Duration::from_millis(delay_ms as u64)).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

tinygif's Issues

Nyan Cat Demo

running_cat.mp4

let image = tinygif::Gif::<Rgb565>::from_slice(include_bytes!("../../cat.gif")).unwrap();
loop {
    for frame in image.frames() {
        let start = Instant::now();
        frame.draw(&mut display.translated(Point::new(10, 80))).unwrap();
        let elapsed = start.elapsed().as_millis();
        info!("draw {}ms", elapsed);

        let delay_ms = (frame.delay_centis * 10) as u64;
        info!("delay {}", delay_ms);
        if delay_ms > elapsed {
            Timer::after(Duration::from_millis((delay_ms - elapsed) as u64)).await;
        }
    }
}

[feature request] `from_iter` constructor

Hi,

I'll probably take a look at this myself, creating an issue first incase you can point out it's impossible or any pitfalls.

What I'm after is a from_iter, similar to from_slice but it'd get given an iter which returns u8s instead of a u8 array.
(I'm reading GIF files off of an SD card & the GIFs can be too large for a full one to fit in memory).

It'd pull the headers etc from the input iter, store them same as what happens with the from_slice.
I think it it'd need to return frames as an iterator over frame & would only be able to do 1 loop (since the input iter will get consumed), but other than that I'm not seeing any major issues