FLAnimatedImage is a performant animated GIF engine for iOS:
- Plays multiple GIFs simultaneously with a playback speed comparable to desktop browsers
- Honors variable frame delays
- Behaves gracefully under memory pressure
- Eliminates delays or blocking during the first playback loop
- Interprets the frame delays of fast GIFs the same way modern browsers do
It’s a well-tested component that powers all GIFs in Flipboard. To understand its behavior it comes with an interactive demo:
Who is this for?
- Apps that don’t support animated GIFs yet
- Apps that already support animated GIFs but want a higher performance solution
- People who want to tinker with the code (the corresponding blog post is a great place to start; also see the To Do section below)
Installation & Usage
FLAnimatedImage is a well encapsulated drop-in component. Simply replace your
UIImageView instances with instances of
FLAnimatedImageView to get animated GIF support. There is no central cache or state to manage.
If using CocoaPods, the quickest way to try it out is to type this on the command line:
$ pod try FLAnimatedImage
To add it to your app, copy the two classes
FLAnimatedImageView.h/.m into your Xcode project or add via CocoaPods by adding this to your Podfile:
pod 'FLAnimatedImage', '~> 1.0'
If using Carthage, add following line into your
In your code,
#import "FLAnimatedImage.h", create an image from an animated GIF, and setup the image view to display it:
FLAnimatedImage *image = [FLAnimatedImage animatedImageWithGIFData:[NSData dataWithContentsOfURL:[NSURL URLWithString:@"http://raphaelschaad.com/static/nyan.gif"]]]; FLAnimatedImageView *imageView = [[FLAnimatedImageView alloc] init]; imageView.animatedImage = image; imageView.frame = CGRectMake(0.0, 0.0, 100.0, 100.0); [self.view addSubview:imageView];
It’s flexible to integrate in your custom image loading stack and backwards compatible to iOS 6.
It uses ARC and the Apple frameworks
It has fine-grained logging. By default, it uses NSLog. However, if your project uses CocoaLumberjack, it automatically can detect that and use CocoaLumberjack to send logs to the configured output.
Since FLAnimatedImage is licensed under MIT, it’s compatible with the terms of using it for any app on the App Store.
- Support other animated image formats such as APNG or WebP
- Integration into network libraries and image caches
- Investigate whether
FLAnimatedImageshould become a
- Smarter buffering
- Bring demo app to iOS 6 and iPhone
This has successfully shipped to many people as is, but please do come with your questions, issues and pull requests!
Feel free to reach out to @RaphaelSchaad for further help.
Select apps using FLAnimatedImage
- Design Shots
- lWlVl Festival
- Zip Code Finder
Using FLAnimatedImage in your app? Let me know!