https://github.com/jpsim/jpsdisplaylink

JPSDisplayLink provides an easy block interface to CADisplayLink-based animations.
https://github.com/jpsim/jpsdisplaylink

Last synced: 3 days ago
JSON representation

JPSDisplayLink provides an easy block interface to CADisplayLink-based animations.

• Host: GitHub
• URL: https://github.com/jpsim/jpsdisplaylink
• Owner: jpsim
• License: mit
• Created: 2014-01-14T03:31:27.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2014-02-11T22:50:48.000Z (almost 11 years ago)
• Last Synced: 2025-01-04T04:03:05.795Z (5 days ago)
• Language: Objective-C
• Homepage:
• Size: 225 KB
• Stars: 23
• Watchers: 2
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# JPSDisplayLink

JPSDisplayLink provides an easy block interface to CADisplayLink-based animations.

This is ideal for animating properties that don't support UIView-based animations like font size on a UILabel or UITextView.

## Installation

### From CocoaPods

Add `pod 'JPSDisplayLink'` to your Podfile.

### Manually

_**Important note if your project doesn't use ARC**: you must add the `-fobjc-arc` compiler flag to `JPSDisplayLink.m` in Target Settings > Build Phases > Compile Sources._

Drag the `JPSDisplayLink/JPSDisplayLink` folder into your project.

## Usage

JPSDisplayLink only has one class method:

```objective-c

typedef void (^JPSDisplayLinkBlock)(CGFloat progress);

+ (void)runDisplayLinkWithDuration:(CFTimeInterval)duration block:(JPSDisplayLinkBlock)block;

```

A JPSDisplayLink object will be created and implicitly retained for the duration specified, then it is automatically released.

_**Make sure you follow proper block etiquette when using JPSDisplayLinkBlock**: for example, avoid retain cycles._

## Easing

Add easing to your JPSDisplayLink animations by manipulating the `progress` parameter in your animation block.

For example, to animate a font size with cubic ease in/out, add [AHEasing](https://github.com/warrenm/AHEasing) to your project and use the following code:

```objective-c

[JPSDisplayLink runDisplayLinkWithDuration:5.0f block:^(CGFloat progress) {

    CGFloat easedProgress = CubicEaseInOut(progress);

    weakLabel.font = [UIFont boldSystemFontOfSize:12.0f + easedProgress*16.0f];

}];

```

### Demo

See sample Xcode project in `/JPSDisplayLinkDemo`.

Here's a GIF of the demo app in action. Note that the GIF's framerate is much slower than in reality.

![Demo GIF](demo.gif)

## License

This project is under the MIT license.