engiffen

Generates gifs from image sequences.

Source frame, generated gif, and a gif from Photoshop

usage

as binary

```bash

Read a bunch of bitmaps and write them to a 20-frame-per-second gif at path hello.gif

engiffen *.bmp -f 20 -o hello.gif

Read a range of files

engiffen -r file01.jpg file20.jpg -o hello.gif

The app sorts them in lexicographical order, so if your shell orders file9

before file10, the resulting gif will not be in that order.

Print to stdout by leaving out the -o argument

engiffen *.bmp > output.gif

or hose your console by forgetting to redirect!

engiffen *.bmp ```

as library

```rust extern crate engiffen;

use engiffen::{load_images, engiffen, Gif}; use std::fs::File;

let paths = vec!["vector", "of", "file", "paths", "on", "disk"]; let images = load_images(&paths); let mut output = File::create("output.gif")?;

// encode an animated gif at 10 frames per second let gif = engiffen(&images, 10, None)?; gif.write(&mut output); ```

rust // Optionally specify how many pixels of each frame should be sampled // when computing the gif's palette. This value reduces the amount of // sampling work to 1/9th of what it normally would, by only sampling // every 3rd pixel on every 3rd row (i.e. pixels lying on a 3x3 grid). let gif = engiffen(&images, 10, Some(3));

debug output

To print timing info to STDERR, compile with the debug-stderr feature

``` $ cargo install engiffen --features debug-stderr

$ engiffen *.tif -f 15 -s 10 > out.gif Checked image dimensions in 0 ms. Pushed all frame pixels in 469 ms. Computed palette in 67 ms. Mapped pixels to palette in 3443 ms. Wrote to stdout in 5415 ms ```

Major work to do

• Incremental frame processing

  Accept a stream of frames from a server to process individually as they arrive. Put off sorting the final palette and compiling the gif until finished.

Anything else?