https://github.com/eduardourso/gifgenerator
iOS Library for converting images into animated GIFs
https://github.com/eduardourso/gifgenerator
cocoapods frame-delay gif gif-animation gif-creator gif-generator gif-library gif-maker gifs ios-gif ios-lib ios-swift podfile swift swift-3 swift-framework swift-language swift-library swift3 video
Last synced: 3 months ago
JSON representation
iOS Library for converting images into animated GIFs
- Host: GitHub
- URL: https://github.com/eduardourso/gifgenerator
- Owner: eduardourso
- License: mit
- Created: 2016-01-26T10:59:47.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2017-08-10T10:35:21.000Z (about 8 years ago)
- Last Synced: 2025-05-12T06:47:27.556Z (6 months ago)
- Topics: cocoapods, frame-delay, gif, gif-animation, gif-creator, gif-generator, gif-library, gif-maker, gifs, ios-gif, ios-lib, ios-swift, podfile, swift, swift-3, swift-framework, swift-language, swift-library, swift3, video
- Language: Swift
- Homepage:
- Size: 5.22 MB
- Stars: 38
- Watchers: 0
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/eduardourso/GIFGenerator)
[](http://cocoapods.org/pods/GIFGenerator)
[](http://cocoapods.org/pods/GIFGenerator)
[](http://cocoapods.org/pods/GIFGenerator)
### Add to your project
There are 2 ways you can add .GIFGenerator to your project:
### Manual installation
Simply import the 'GIFGenerator' folder into your project then import the classes that you want to use.
#### Obj-C
```objective-c
#import "GIFGenerator.h"
```
#### Swift
```swift
import GIFGenerator
```
### Avaliable in CocoaPods
GIFGenerator is available through [CocoaPods](https://cocoapods.org) See the "[Getting Started](http://guides.cocoapods.org/syntax/podfile.html)" guide for more information.
To install it, simply add the following line to your Podfile:
#### Podfile
```ruby
platform :ios, '8.0'
pod "GIFGenerator"
```
### Practical use
```swift
let gifGenerator = GifGenerator()
gifGenerator.generateGifFromImages(imagesArray, frameDelay: 0.5, destinationURL: url, callback: { (data, error) -> () in
//returns a gif file.
})
//ATENTION: you must provide the part of the video that you want to convert, so if you need to convert just from the 0:10 to 0:20 sec. you must cut and deal with the video before you send it to the library.
gifGenerator.generateGifFromVideoURL(videoURL: url, framesInterval: 10, frameDelay: 0.2, destinationURL: NSURL(fileURLWithPath: destinationPath), callback: { (data, error) -> () in
//returns a gif file.
})
```
This generates a GIF from provided images or video file.
The library is lightweight and very straight forward. Once you have the array of images, pass it to GIFGenerator alongside the url and frame delay.
Let me explain those for you:
```
imagesArray - array of images that will compose the GIF file!
frameDelay - is the amount of time between each frame in the GIF.
destinationURL - is the url where the GIF file will be stored.
```
Or if you have the video url, pass it to GIFGenerator alongside the url and frame delay.
Let me explain those for you:
```
videoURL - url where the video is stored that will compose the GIF file!
frameDelay - is the amount of time between each frame in the GIF.
destinationURL - is the url where the GIF file will be stored.
```
I recommend you to play with those parameters to see how it can affect the GIF file.
### Example Project
To run the example project, clone the repo, and run `pod install` from the Example directory first.
### Author
Eduardo Urso, eduardourso@gmail.com
If you have any doubts, comments or improvements just shoot me an email.
### License
GIFGenerator is available under the MIT license. See the LICENSE file for more info.