Go to file
Tony DiPasquale e979c72bf8 Bump version to 0.10.0 2015-06-05 11:25:14 -04:00
Demo Add a toggle for both gifs 2015-06-05 11:22:23 -04:00
Gifu.xcodeproj Remove delegate 2015-06-05 11:22:22 -04:00
Source Bump version to 0.10.0 2015-06-05 11:25:14 -04:00
.gitignore Use Runes for functional operators 2015-01-20 20:44:15 +01:00
.gitmodules Cleanup demo project and runes references 2015-04-23 18:37:05 -04:00
Cartfile Update Runes dependency 2015-06-02 11:28:07 -04:00
Cartfile.resolved Update Runes dependency 2015-06-02 11:28:07 -04:00
LICENSE Update LICENSE & README 2014-09-10 21:41:13 +02:00
README.md Update README to reflect API changes 2014-12-12 23:29:10 +01:00

README.md

Adds performant animated GIF support to UIKit, without subclassing UIImageView. If you're looking for the Japanese prefecture, click here.

Why?

Because Apple's +animatedImage* is not meant to be used for animated GIFs (loads all the full-sized frames in memory), and the few third party implementations that got it right (see Credits) still require you to use a UIImageView subclass, which is not very flexible and might clash with other application-specific functionality.

How?

Gifu uses a UIImage subclass and UIImageView extension written in Swift. It relies on CADisplayLink to animate the view and optimizes the frames by resizing them.

Install

If you use Carthage, add this to your cartfile: github "kaishin/gifu".

If your prefer Git submodules or want to support iOS 7, you want to add the files in source to your Xcode project.

Usage

Start by instantiating an AnimatedImage, then pass it to your UIImageView's setAnimatedImage:

if let image = AnimatedImage.animatedImageWithName("mugen.gif") {
  imageView.setAnimatedImage(image)
  imageView.startAnimatingGIF()
}

Note that the image view will not start animating until you call startAnimatingGIF() on it. You can stop the animation anytime using stopAnimatingGIF(), and resume it using startAnimatingGIF(). These methods will fallback to UIKit's startAnimating() and stopAnimating() if the image view has no animatable image.

Likewise, the isAnimatingGIF() method returns the current animation state of the view if it has an animatable image, or UIKit's isAnimating() otherwise.

Demo App

Compatibility

  • iOS 7+

Roadmap

  • Documentation.
  • Write some basic tests.
  • Add ability to pass a frame-rate argument to startAnimatingGIF()

Contributors

Misc

  • The font used in the logo is Azuki
  • The characters used in the icon and example image in the demo are from Samurai Champloo.

License

See LICENSE.