APKenBurnsView
Ken Burns effect with face recognition!
APKenBurnsView is UIView subclass which supports face recognition to beautifully animate people photos.
Features
- Face recognition feature to beautifully animate people photos.
- Totally random algorithm. No more hardcoded values!
- Memory efficient. Holds maximum of two UIImage pointers at any moment.
- Pausing animations done right.
- Auto restart after entering background and returning back.
- A lot of animation customizations to fit your needs.
Face Recognition
APKenBurnsView supports three modes for face recognition:
None- no face recognition, simple Ken Burns effect.Biggest- recognizes biggest face in image, if any then transition will start or finish (chosen randomly) in center of face rect.Group- recognizes all faces in image, if any then transition will start or finish (chosen randomly) in center of compound rect of all faces.
Usage
Just simple interface. Provide data source class for UIImage's, setup all timings and run startAnimations(). No rocket science!
Data source should be ready to provide next image at the moment when APKenBurnsView calls func nextImageForKenBurnsView(kenBurnsView: APKenBurnsView) -> UIImage?. If there is no UIImage ready (still loading from network, etc.) then data source should return nil and APKenBurnsView will animate last image one more time. If you are loading your images from network you should consider some preloading mechanism.
Example of usage:
class MyViewController: UIViewController {
// MARK: - Outlets
@IBOutlet weak var kenBurnsView: APKenBurnsView!
// MARK: - Lifecycle
override func viewDidLoad() {
super.viewDidLoad()
kenBurnsView.dataSource = self
kenBurnsView.faceRecognitionMode = .Biggest
kenBurnsView.scaleFactorDeviation = 0.5
kenBurnsView.imageAnimationDuration = 5.0
kenBurnsView.imageAnimationDurationDeviation = 1.0
kenBurnsView.transitionAnimationDuration = 2.0
kenBurnsView.transitionAnimationDurationDeviation = 1.0
}
override func viewDidAppear(animated: Bool) {
super.viewDidAppear(animated)
self.kenBurnsView.startAnimations()
}
}
extension KenBurnsViewController: APKenBurnsViewDataSource {
func nextImageForKenBurnsView(kenBurnsView: APKenBurnsView) -> UIImage? {
return /* Provide UIImage instance */
}
}
Example
To run the example project, clone the repo, and run pod install from the Example directory first.
Requirements
- iOS 8.0 and higher
- ARC
Installation
APKenBurnsView is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'APKenBurnsView'
Author
Nickolay Sheika, [email protected]
Contacts
If you have improvements or concerns, feel free to post an issue and write details.
Check out all Alterplay's GitHub projects. Email us with other ideas and projects.
License
APKenBurnsView is available under the MIT license. See the LICENSE file for more info.
6 Oct 25, 2022
32 Dec 12, 2022
35 Dec 19, 2022
16 Nov 24, 2022
589 Dec 24, 2022
3 Jun 26, 2022
23 Sep 20, 2022
297 Dec 17, 2022
151 Nov 2, 2022
80 Nov 17, 2022
58 Jan 6, 2023
58 Dec 14, 2022
10 May 14, 2022
628 Oct 22, 2022
361 Oct 26, 2022
0 Oct 23, 2021
37 Jan 3, 2023
1 Aug 17, 2022
500 Oct 30, 2022
11 Aug 20, 2022
361 Oct 26, 2022
0 Jan 19, 2022
14 Nov 18, 2022
555 Dec 17, 2022
440 Dec 17, 2022
170 Nov 15, 2022
1 Dec 20, 2021