Struct GifRecorder 

pub struct GifRecorder { /* private fields */ }

Writes frames into one looping animated GIF.

Every frame gets its own 256 colour palette, built with NeuQuant, so smooth gradients survive better than they would with one palette for the whole file. Frames are written as they arrive, so memory use stays at one frame however long the recording is.

The file is complete once finish returns. Dropping the recorder also finishes the file, but cannot report a write error.

Implementations

impl GifRecorder

pub const DEFAULT_SPEED: i32 = 10

Default quantiser speed: 1 is best and slowest, 30 fastest.

pub fn create(path: impl AsRef<Path>, frame_secs: f32) -> Result<Self>

Start a GIF at path whose frames are shown for frame_secs each.

GIF timing is in hundredths of a second, so the delay is rounded to the nearest 10 ms (and never below 20 ms, the fastest rate browsers honour).

pub fn create_with_speed( path: impl AsRef<Path>, frame_secs: f32, speed: i32, ) -> Result<Self>

As create, with the quantiser speed (1 to 30).

pub fn delay_ms(&self) -> u32

The delay given to each frame, in milliseconds.

pub fn frames(&self) -> usize

Frames written so far.

pub fn push(&mut self, w: u32, h: u32, rgba: &[u8]) -> Result<()>

Append one RGBA8 frame, top row first. Alpha is ignored.

Every frame must be the size of the first.

pub fn finish(self) -> Result<usize>

Write the GIF trailer and close the file. Returns the frame count.