A timer object that allows your application to synchronize its drawing to the refresh rate of the display.
- iOS 3.1+
- Mac Catalyst 13.0+
- tvOS 9.0+
- Core Animation
Your application initializes a new display link, providing a target object and a selector to be called when the screen is updated. To synchronize your display loop with the display, your application adds it to a run loop using the
Once the display link is associated with a run loop, the selector on the target is called when the screen’s contents need to be updated. The target can read the display link’s
timestamp property to retrieve the time that the previous frame was displayed. For example, an application that displays movies might use the timestamp to calculate which video frame will be displayed next. An application that performs its own animations might use the timestamp to determine where and how displayed objects appear in the upcoming frame.
duration property provides the amount of time between frames at the
maximum. To calculate the actual frame duration, use
timestamp. You can use this value in your application to calculate the frame rate of the display, the approximate time that the next frame will be displayed, and to adjust the drawing behavior so that the next frame is prepared in time to be displayed.
Your application can disable notifications by setting the
is property to
true. Also, if your application cannot provide frames in the time provided, you may want to choose a slower frame rate. An application with a slower but consistent frame rate appears smoother to the user than an application that skips frames. You can define the number of frames per second by setting the
When your application finishes with a display link, it should call
invalidate() to remove it from all run loops and to disassociate it from the target.
Listing 1 shows how you can create a display link and add it to the current run loop. The display link invokes the
step function, which simply prints the current timestamp, with each screen update.
CADisplay should not be subclassed.
Preferred and Actual Frame Rates
You can control a display link's frame rate, i.e. the number of times the specified selector of its target is called per second, by setting its
preferred. However, the actual frames per second may differ from the preferred value you set: actual frame rates are always a factor of the maximum refresh rate of the device.
For example, if your device's maximum refresh rate is 60 frames per second (defined by
maximum), actual frame rates include 15, 20, 30, and 60 frames per second. If you set a display link's preferred frame rate to a value higher than the maximum, the actual frame rate is the maximum.
Preferred frame rates than are not a divisor of the maximum frame rate are rounded to the nearest factor. For example, setting a preferred frame rate to either 26 or 35 frames per second on a device with a maximum refresh rate of 60 frames per second yields an actual frame rate of 30 times per second.