Calculating Spring Velocity

Episode #232 | 8 minutes | published on 08/19/2016 | Uses Xcode-7.3, swift-2.3
Subscribers Only
UIView has an incredibly useful spring-based animation API, but it can be difficult to know what to use for the damping and initial spring velocity parameters. In this episode, we'll break down how to compute the velocity value using the values we get from our UIPanGestureRecognizer and a little math.

Episode Links

Handling the End Gesture State

In the gesture recognizer method, we handle the .Ended state by computing the following:

  • the target point we are going to animate to
  • the view's current velocity in its parent, given to us by UIPanGestureRecognizer
  • the overall distance we need to travel
  • the relative distance our velocity vector makes up

Using these values, we can calculate our spring animations initial velocity:

 case .Ended:
            let velocity = recognizer.velocityInView(parent)

            let targetPoint = computeTargetPoint(view, location: centerInParent, velocity: velocity, bounds: parent.bounds)

            func magnitude(vector: CGPoint) -> CGFloat {
                return sqrt(pow(vector.x, 2) + pow(vector.y, 2))

            let distanceVector = CGPoint(x: centerInParent.x - targetPoint.x, y: centerInParent.y - targetPoint.y)
            let totalDistance = magnitude(distanceVector)
            let magVelocity = magnitude(velocity)

            let animationDuration: NSTimeInterval = 1
            let springVelocity: CGFloat = magVelocity / totalDistance / CGFloat(animationDuration)

                                       delay: 0,
                                       usingSpringWithDamping: 0.9,
                                       initialSpringVelocity: springVelocity,
                                       options: [],
                                       animations: {
                recognizer.view!.center = targetPoint
            }, completion: nil)

blog comments powered by Disqus