CVDisplayLink is a timer object that allows your application to synchronize its drawing to the refresh rate of the display. ==It’s highly useful when you want to combine animation with user interactions==, something that is not easily handled by transitions or stock animations.

CVDisplayLink 60fps rich animation + interactivity demo: vimeo probably at 30fps? and original video in 60fps @dropbox and the code for this here and here


Older frame animation technology at 24fps vimeo


CVDisplayLink is the holy grail of rich animation & interaction in OSX and IOS. CVDisplayLink works very much like an NSTimer. You can set it to call a method on every tick, but instead of setting a time interval, the time interval is determined by the screen’s refresh rate. You can also use timeStamp and duration to skip frames if the frame-rate drops etc. Or set the frameRate it self to 30fps. You cant go above 60fps it seems. Aka the native device fps. ==CVDisplayLink gives us a much better time-resolution than NSTimer== to measure percentage complete use: percentComplete = elapsedTime / animationDuration;

Q & A

Q: Why use CVDisplayLink over NSTimer to do frame-animation:
A: Because CVDisplayLink will make sure that rendering is in sync with your screen refresh rate and the graphical sub-system. It makes no sense to render more images than your monitor can physically display or your sub-system can actually process. Also a timer doesn’t fire at precise intervals, ==if you miss a screen refresh only by 0.01 ms, then the whole image will be delayed by a full screen refresh== (causing animation lag and reducing the number of rendered images displayed a second). The CVDisplayLink is like a high priority optimized timer.

Q: CVDisplayLink must draw on the main thread to be visible. What happens then if there is some other computational heavy process on the main thread while heavy animation is going on? Wont the frame-rate go down and even start to be really slow? A: If you cannot achieve a good frame-rate that way, since your main thread is busy elsewhere, it is recommend to rather move everything else (pretty much your whole application logic) to other threads (e.g. using Grand Central Dispatch) and ==only keep user input and drawing code on the main thread==.

Q: Will the human brain notice if a frame is dropped at 60fps? So 59fps for one second and then back to 60fps the next? Or does the dropped frame have other implications?

A: “Unfortunately the animation still stuttered away like an old tractor plowing through a barren potato field during dry season.” source:

Facebook pop:

Pop is the framework that Facebook uses to power the animations in their app Paper. It’s also authored by Kimon Tsinteris, one of the creators of the Our Choice iPad app. Pop works differently from JNWSpringAnimation as it doesn’t use Core Animation, ==it relies on a timer firing every 1/60th of a second (CADisplayLink) to govern the motion of elements so it can recalculate their position easily if a gesture interrupts the animation.==

  • CVDisplayLink referenced from article:
  • CVDisplayLink example that draws on the main thread (its unknown if it works or not):
  • potential solution to resizing the frame when using CVDisplayLink:
  • lots of detailed workarounds to get CVDisplayLink working: stackoverflow link
  • swift + NSOpenGlView + CVDisplayLink example that seemingly works: although i’m unable to get it working.
  • This is article is important:
  • This convo is important: Thanks again Mecki for your guidance.
  • Swift 3 CVDisplayLink: here ##CADisplayLink (IOS)
  • (some insights here)

Core animation (IOS):

  • This article describes why anim + interaction doesnt work if you just use Core animation (great read):

General notes:

  • If you want to chain animation with the CVDisplayLink: Then never stop the CVDisplayLink before you start another. Since you cant start a CVDisplayLink within within the lifespan of a CVDisplayLinkStart “call”.


  • [x] create an Example with CVDisplayLink and interactivity
  • [x] ==Test CVDisplayLink with NSTextField and NSTextView==
  • [ ] Test CVDisplayLink with more complex gradients and dropshadows and many more shapes.
  • [ ] Create a system where you don’t draw views that are out of view.
  • [ ] Try to implement scroll gesture the same way you implemented “mouse-throw” See notes about this in your core anim article
  • [ ] Try to implement the spring ball demo.

Related Posts

Infinite Tree List

My notes on Infinite tree list

Protocol Inheritance

My notes on Protocol Inheritance

Protocol Ambiguity

How to differentiate protocol ambiguity

The Ultimate Xcode Workflow

Spend zero time managing dependencies

Faster Xcode With Spm

How you can speed up compile times in XCode with Swift Package Manager

Spm And Ci Travis

My notes on Swift PM + CI Travis

Spm And Nested Frameworks

My notes on Swift package manager + XCode + Nested frameworks

Xcode And Spm

Here is how you use Swift package manager in your XCode app projects

Carthage And Nested Frameworks

A few workflows concerning Carthage and nested framework

Two Finger Swipe

Notes on implementing two finger swipe for macOS