GIF en- and decoder written in Rust (API Documentation).
This library provides all functions necessary to de- and encode GIF files.
The high level interface consists of the two types
Encoder and Decoder.
They as builders for the actual en- and decoders and can be used to set various
options beforehand.
rust
// Open the file
use std::fs::File;
use gif::SetParameter;
let mut decoder = gif::Decoder::new(File::open("tests/samples/sample_1.gif").unwrap());
// Configure the decoder such that it will expand the image to RGBA.
decoder.set(gif::ColorOutput::RGBA);
// Read the file header
let mut decoder = decoder.read_info().unwrap();
while let Some(frame) = decoder.read_next_frame().unwrap() {
// Process every frame
}
The encoder can be used so save simple computer generated images:
```rust use gif::{Frame, Encoder, Repeat, SetParameter}; use std::fs::File; use std::borrow::Cow;
let colormap = &[0xFF, 0xFF, 0xFF, 0, 0, 0]; let (width, height) = (6, 6); let beaconstates = [[ 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 0, ], [ 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 0, ]]; let mut image = File::create("target/beacon.gif").unwrap(); let mut encoder = Encoder::new(&mut image, width, height, colormap).unwrap(); encoder.set(Repeat::Infinite).unwrap(); for state in &beaconstates { let mut frame = Frame::default(); frame.width = width; frame.height = height; frame.buffer = Cow::Borrowed(&*state); encoder.write_frame(&frame).unwrap(); } ```
Frame::from_* can be used to convert a true color image to a paletted
image with a maximum of 256 colors:
```rust use std::fs::File;
// Get pixel data from some source
let mut pixels: Vec