Gifu/README.md

2.4 KiB

Adds animated GIF support to UIKit. For the Japanese prefecture, click here.

Why?

Because Apple's +animatedImage* sucks, and the few third party implementations that got it right (see Credits) still require you to use a UIImageView subclass.

How?

Gifu is a UIImage subclass and UIImageView extension written in Swift. It uses CADisplayLink to animate the view and only keeps a limited number of frames in-memory, which exponentially minimizes memory usage for large GIF files (+300 frames).

The figure below summarizes how this works in practice. Given an image containing 10 frames, Gifu will load the current frame (red), pre-load the next two frames in this example (orange), and nullify all the other frames to free up memory (gray):

Usage

Use git submodules or drag-and-drop the files in your Xcode project. I can't believe I'm saying this in 2014.

Once done, you can call setAnimatableImage(named:) or setAnimatableImage(data:) on your UIImageView (or its subclass):

let imageView = UIImageView(...)

imageView.setAnimatableImage(named: "computer-kid.gif")
// or
imageView.setAnimatableImage(data: NSData(...))

You can start/stop the animation using UIImageView's startAnimating() and stopAnimating().

You can find a demo here (requires Xcode 6 Beta-7).

Compatibility

  • iOS 7+

Roadmap

The usual suspects:

  • Add documentation.
  • Write some basic tests.

Needless to say, you are welcome to contribute.

Credits

  • The animation technique described above was originally spotted on OLImageView, then improved in YLGIFImage.

  • The font used in the logo is Azuki

  • Kudos to my colleague Tony DiPasquale for helping out with the factory methods.

  • The characters used in the icon and example image in the demo are from Samurai Champloo. The name and characters are property of their respective owners.

License

See LICENSE.