koral--/android-gif-drawable
Android Gif Drawable
android-gif-drawable is a rendering library for displaying and controlling animated GIF images within Android image views and drawables. It provides a custom drawable implementation for frame-based animations, a playback system for seeking and looping, and a metadata extractor for retrieving technical properties such as frame counts and loop settings.
The library enables the synchronization of a single animation instance across multiple views to ensure consistent playback. It supports loading GIF data from various sources, including assets, resources, URIs, byte arrays, files, and input streams.
Playback is managed through an animation controller that allows for starting, stopping, resetting, and adjusting playback speed. The system also includes memory optimization and background rendering to prevent user interface blocking.
Features
- Android Image Components - Provides custom UI components for displaying and animating GIF images within Android applications.
- Image Format Parsers - Retrieves frame counts, loop settings, and other technical properties from GIF image sources.
- Animated Image Rendering - Renders animated GIF files within Android image views and backgrounds with automatic format recognition.
- Image Metadata Extraction - Extracts technical GIF properties including frame counts, loop settings, and memory allocation sizes.
- Android Image Loading - Ships a library for fetching, decoding, and displaying animated GIF media on Android.
- Animated Drawables - Provides a custom drawable implementation for memory-efficient frame-based animations on Android.
- Animation Controllers - Implements a playback system for orchestrating seeking, looping, and speed adjustment of animations.
- Animation Playback Controls - Provides programmatic control for pausing, resuming, seeking, and adjusting the playback speed of animations.
- Custom Drawables - Implements a custom Drawable class to integrate animation logic directly into the Android view system.
- UI Memory Optimization - Optimizes memory usage by recycling drawables and offloading rendering to background threads.
- Multi-Source Asset Loading - Supports loading GIF data from assets, resources, URIs, byte arrays, and input streams.
- Android Image Memory Management - Manages image memory allocation and background rendering to maintain smooth UI performance.
- Background Thread Dispatchers - Decodes animation frames on background threads to prevent UI freezes.
- Animation Frame Buffers - Uses specialized memory buffers for frame data to reduce garbage collection overhead during playback.
- Temporal Frame Indexing - Calculates the correct frame index by mapping time offsets to GIF frame delay metadata.
- Synchronized Animation States - Allows multiple view components to share a single animation controller for perfectly synchronized playback.
- Cross-View Animation Sync - Links a single drawable instance to multiple views to ensure perfectly synchronized animation playback.
- Image Components - Efficient animated GIF rendering for Android views and drawables.
- Programming Libraries - Views and Drawable for displaying animated GIFs on Android.
- ProGuard Configurations - Provides animated image rendering configuration rules.
