Struct gif::Encoder

pub struct Encoder<W: Write> { /* fields omitted */ }

GIF encoder.

Implementations

impl<W: Write> Encoder<W>

pub fn new(
    w: W,
    width: u16,
    height: u16,
    global_palette: &[u8]
) -> Result<Self, EncodingError>

Creates a new encoder.

global_palette gives the global color palette in the format [r, g, b, ...], if no global palette shall be used an empty slice may be supplied.

pub fn set_repeat(&mut self, repeat: Repeat) -> Result<(), EncodingError>

Write an extension block that signals a repeat behaviour.

pub fn write_global_palette(self, palette: &[u8]) -> Result<Self, EncodingError>

Writes the global color palette.

pub fn write_frame(&mut self, frame: &Frame<'_>) -> Result<(), EncodingError>

Writes a frame to the image.

Note: This function also writes a control extension if necessary.

pub fn write_extension(
    &mut self,
    extension: ExtensionData
) -> Result<(), EncodingError>

Writes an extension to the image.

It is normally not necessary to call this method manually.

pub fn write_raw_extension(
    &mut self,
    func: AnyExtension,
    data: &[&[u8]]
) -> Result<()>

Writes a raw extension to the image.

This method can be used to write an unsupported extension to the file. func is the extension identifier (e.g. Extension::Application as u8). data are the extension payload blocks. If any contained slice has a lenght > 255 it is automatically divided into sub-blocks.

Trait Implementations

impl<W: Write> Drop for Encoder<W>

fn drop(&mut self)

Executes the destructor for this type.