https://github.com/swiftgif/SwiftGif

[UNMAINTAINED] 🌠 A small UIImage extension with gif support
https://github.com/swiftgif/SwiftGif

gif gif-support ios macos swift uiimage xcode

Last synced: 7 days ago
JSON representation

[UNMAINTAINED] 🌠 A small UIImage extension with gif support

• Host: GitHub
• URL: https://github.com/swiftgif/SwiftGif
• Owner: swiftgif
• License: mit
• Archived: true
• Created: 2014-06-10T19:37:12.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2021-01-14T09:18:22.000Z (almost 4 years ago)
• Last Synced: 2024-10-25T00:26:45.018Z (about 2 months ago)
• Topics: gif, gif-support, ios, macos, swift, uiimage, xcode
• Language: Swift
• Homepage:
• Size: 3.81 MB
• Stars: 1,327
• Watchers: 29
• Forks: 306
• Open Issues: 33
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-ios - SwiftGif - A small UIImage extension with gif support. (Media / GIF)
• awesome-swift - SwiftGif - A small UIImage extension with GIF support. (Libs / Images)
• awesome-ios-star - SwiftGif - A small UIImage extension with gif support. (Media / GIF)
• awesome-swift - SwiftGif - [UNMAINTAINED] A small UIImage extension with gif support ` 📝 5 months ago ` (Images [🔝](#readme))

README

        
### :warning: UNMAINTAINED :warning:

This library is no longer maintained. I recommend using [Gifu](https://github.com/kaishin/gifu) instead.

---

# SwiftGif [![Swift 3.0](https://img.shields.io/badge/Swift-3.0-orange.svg?style=flat)](https://developer.apple.com/swift/) [![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage) [![CocoaPods](https://img.shields.io/cocoapods/v/SwiftGifOrigin.svg)](http://cocoadocs.org/docsets/SwiftGifOrigin) [![License MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat)](https://github.com/Carthage/Carthage) [![Build Status](https://travis-ci.org/bahlo/SwiftGif.svg?branch=master)](https://travis-ci.org/bahlo/SwiftGif)

A small `UIImage` extension with gif support.

![Demo gif](demo.gif)

## Usage

```swift

import SwiftGifOrigin

// An animated UIImage

let jeremyGif = UIImage.gif(name: "jeremy")

// A UIImageView with async loading

let imageView = UIImageView()

imageView.loadGif(name: "jeremy")

// A UIImageView with async loading from asset catalog(from iOS9)

let imageView = UIImageView()

imageView.loadGif(asset: "jeremy")

```

## Installation

### CocoaPods

Install [CocoaPods](http://cocoapods.org) with the following command:

```bash

gem install cocoapods

```

Integrate SwiftGif into your Xcode project by creating a `Podfile`:

```ruby

platform :ios, '9.0'

use_frameworks!

target '' do

    pod 'SwiftGifOrigin', '~> 1.7.0'

end

```

Run `pod install` to build your dependencies.

### Carthage

Install [Carthage](https://github.com/Carthage/Carthage) with

[Homebrew](http://brew.sh/) using the following command:

```bash

brew update

brew install carthage

```

Add the following line to your `Cartfile` to add SwiftGif:

```ogdl

github "bahlo/SwiftGif" ~> 1.7.0

```

Run `carthage update` to build the framework and drag the built

`SwiftGif.framework` into your Xcode project.

## How does it work?

Easy, it does the following:

1. Find out the duration of every frame

2. Find the greatest common divisor

3. Add frames accordingly to the greatest common divisor to an array

4. Create an animated UIImage with the frames

## Testing

```

$ xcodebuild \

  -project SwiftGif.xcodeproj \

  -scheme SwiftGif \

  -sdk iphonesimulator \

  -destination "platform=iOS Simulator,name=iPhone 8" \

  build test \

  CODE_SIGNING_REQUIRED=NO CODE_SIGN_IDENTITY=""

```

# Inspiration

This project is heavily inspired by [uiimage-from-animated-gif](https://github.com/mayoff/uiimage-from-animated-gif).

Kudos to [@mayoff](https://github.com/mayoff). :thumbsup:

## License

This repository is licensed under the MIT license, more under

[LICENSE](LICENSE).