Struct BufferedDecoder 

pub struct BufferedDecoder { /* private fields */ }

A buffered GIF decoder that loads and composites all frames.

This decoder properly handles GIF disposal methods and transparency, producing fully composited RGBA frames suitable for analysis.

Example

use figif_core::decoders::BufferedDecoder;
use figif_core::traits::GifDecoder;

let decoder = BufferedDecoder::new();
let frames: Vec<_> = decoder.decode_file("animation.gif")?.collect::<Result<Vec<_>, _>>()?;

Implementations

impl BufferedDecoder

pub fn new() -> Self

Create a new buffered decoder with default settings.

pub fn with_memory_limit(self, limit: usize) -> Self

Set a memory limit for decoding.

If the GIF would require more memory than this limit, decoding will fail with an error.

Trait Implementations

impl BufferedGifDecoder for BufferedDecoder

fn decode_all(&self, data: &[u8]) -> Result<Vec<DecodedFrame>>

Decode all frames into a vector.

fn decode_all_from_file( &self, path: impl AsRef<Path>, ) -> Result<Vec<DecodedFrame>>

Decode all frames from a file into a vector.

impl Clone for BufferedDecoder

fn clone(&self) -> BufferedDecoder

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BufferedDecoder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for BufferedDecoder

fn default() -> BufferedDecoder

Returns the “default value” for a type.

impl GifDecoder for BufferedDecoder

type FrameIter = BufferedFrameIter

The type of iterator returned by decode operations.

fn decode_file(&self, path: impl AsRef<Path>) -> Result<Self::FrameIter>

Decode a GIF from a file path.

fn decode_bytes(&self, data: &[u8]) -> Result<Self::FrameIter>

Decode a GIF from a byte slice.

fn decode_reader<R: Read + Send>(&self, reader: R) -> Result<Self::FrameIter>

Decode a GIF from any reader.

fn metadata_from_bytes(&self, data: &[u8]) -> Result<GifMetadata>

Extract metadata without fully decoding all frames.

fn metadata_from_file(&self, path: impl AsRef<Path>) -> Result<GifMetadata>

Extract metadata from a file.

fn name(&self) -> &'static str

Get the name of this decoder for logging/debugging.