Struct AnimatedImage 

pub struct AnimatedImage {
    pub width: u32,
    pub height: u32,
    /* private fields */
}

An animated GIF streamed on demand during live playback.

Fields

width: u32

height: u32

Implementations

impl AnimatedImage

pub fn decode(path: &Path) -> Result<Option<Self>>

Parses path’s GIF header for timing metadata without decoding any pixels. Returns Ok(None) when the file is not a GIF so callers can keep their existing static-image path.

pub fn first_frame(&mut self) -> &[u8]

RGBA8 bytes of the first frame, used as the transition’s incoming image.

pub fn frame_at(&mut self, index: usize) -> &[u8]

RGBA8 bytes of the frame at index.

pub fn decompress_into(&mut self, index: usize, out: &mut [u8]) -> bool

Decompresses the frame at index directly into out (which must be exactly width * height * 4 bytes), skipping the shared scratch buffer. Returns false when the frame is not cached yet.

pub fn frame_index_at(&self, elapsed: Duration) -> usize

Index of the frame to display at elapsed time, looping forever.

pub fn frame_start(&self, index: usize) -> Duration

Cumulative time at which frame index begins. For index == len this equals the total duration (the next wrap back to frame 0).

pub fn frame_count(&self) -> usize

Total number of frames in the animation.

pub fn cache_bytes(&self) -> usize

Bytes currently held by the frame cache.

pub fn raw_cached(&self) -> usize

Number of frames stored uncompressed.

pub fn zstd_cached(&self) -> usize

Number of frames stored zstd-compressed.

pub fn total_duration(&self) -> Duration

Total duration of one full loop of the animation.