Skip to content
/ gifu Public
forked from kaishin/Gifu

Highly performant animated GIF support for iOS in Swift

License

Notifications You must be signed in to change notification settings

FrXer/gifu

 
 

Repository files navigation

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.

About

Highly performant animated GIF support for iOS in Swift

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 99.0%
  • Objective-C 1.0%