Awesome Open Source
Awesome Open Source

Ease

Ease is an event driven animation system that combines the observer pattern with custom spring animations as observers. It's magic.

Features

  • [X] Animate any value type
  • [X] Set multiple animations for a single value
  • [X] Animation trajectories update when you update the targetValue
  • [X] Add natural spring behavior to any value change
  • [X] Optimized for Swift 5
  • [X] Compatible with iOS 9 and up

Supported value types

  • CGFloat
  • CGPoint
  • CGSize
  • CGVector
  • Int
  • Float
  • Double
  • SCNVector3

Easily extendible with more (custom) types.

Examples

How

Create your Ease object with an initial value

var ease: Ease<CGPoint> = Ease(view.center, minimumStep: 0.001)

Add your custom spring-animation(s)

ease.addSpring(tension: 300, damping: 15, mass: 1) { position in
    view.center = position
}

Set the target value of your Ease object and adjust your target as often as you want

ease.targetValue = gestureRecognizer.location(in: view)

Memory management

For a single spring-animation you can store the returned EaseDisposable to a variable

disposable = ease.addSpring(tension...

For multiple spring-animations you can add the disposable to a EaseDisposal variable

ease.addSpring(tension...) { }.add(to: &disposal)

And always weakify self when referencing self inside your spring-animation

ease.addSpring(tension...) { [weak self] position in

Installation

Ease is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod 'Ease'

Suggestions or feedback?

Feel free to create a pull request, open an issue or find me on Twitter.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
swift (7,529
animation (1,029
spring (491
animations (155
events (137
swift5 (110
system (96
event (59
observable (58
scenekit (48
observables (28
uiscrollview (27
observer (22
swift-5 (18
observer-pattern (15

Find Open Source By Browsing 7,000 Topics Across 59 Categories