Skip to content

roberthein/Ease

Folders and files

NameName
Last commit message
Last commit date

Latest commit

fb74dfd Â· Jul 14, 2020

History

42 Commits
Oct 7, 2019
Oct 7, 2019
Jul 14, 2020
Oct 10, 2019
Jul 14, 2020
Jul 14, 2020
Jun 6, 2019
Dec 13, 2017
Dec 13, 2017
Jul 14, 2020
Dec 13, 2017
Jun 6, 2019
Apr 9, 2019
Dec 13, 2017

Repository files navigation

Ease

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

Features

  • Animate any value type
  • Set multiple animations for a single value
  • Animation trajectories update when you update the targetValue
  • Add natural spring behavior to any value change
  • Optimized for Swift 5
  • 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.