Cheetah

Easy animation library on iOS with Swift2

Code Quality Rank: L5

Programming language: Swift

License: MIT License

Tags: Animation    

Latest version: v0.4.1

README

Cheetah

Cheetah is an animation utility on iOS with Swift. Cheetah can animate any properties since Cheetah uses simple CADisplayLink run loop to change animated properties.

Requirements

• iOS 8.0~
• tvOS 9.0~
• Swift 3.0

Features

• Animation with duration and delay
• Changing with absolute/relative properties
• Parallel/Serial executions
• Easings
• Springs

Carthage

Carthage is a simple, decentralized dependency manager for Cocoa.

To install Cheetah, simply add the following line to your Cartfile:

github "suguru/Cheetah"

Code Example

// Create view
let box = UIView(frame:CGRectMake(100,100,50,50))
box.backgroundColor = UIColor.blueColor()
view.addSubview(box)

// Move to 100px right
box.cheetah.move(100, 0).run()

Properties

Cheetah has several methods to animate properties easily. You can also animate your own properties with extending CheetahProperty.

• move
• position (absolute of move)
• scale
• rotate
• rotation (absolute of rotate)
• size
• frame
• alpha
• backgroundColor
• textColor
• borderColor
• borderWidth
• borderRadius
• custom properties

Parallel execution

Cheetah groups animation properties and execute them at once.

view.cheetah
  .move(100, 0)
  .rotate(M_PI * 2)
  .scale(1.5)
  .run()

Serial execution

wait will wait until all animations placed before it completed. It can also receive seconds to wait to start next animation.

view.cheetah
  .move(100, 0).rotate(M_PI)
  .wait()
  .move(-100, 0).rotate(-M_PI)
  .wait(1.0) // <- wait 1 sec to start next animation
  .move(0, -20).duration(0.4)
  .wait()
  .move(0, 20).duration(0.4)
  .run()

Duration and delay

Cheetah has duration and delay to each animation properties.

view.cheetah
  .move(100, 0).duration(1.0).delay(1.0)
  .rotate(M_PI).duration(2.0)
  .wait(1)
  .move(-100, 0).duration(0.4)
  .run()

Duration will be copied from the property placed before.

view.cheetah
  .duration(0.5)
  .move(100, 0) // <- will have 0.5 sec duration
  .rotate(M_PI) // <- will have 0.5 sec duration
  .run()

Repeating

To repeat animations, use repeatCount(count: Int)

view.cheetah.rotate(M_PI_2).run().repeat(3)

To repeat forever, use forever

view.cheetah.rotate(M_PI_2).run().forever

Easings

Cheetah supports various easing functions. You can also add custom easings with quad bezier points.

Exmaple

view.cheetah.move(150, 150).easeInQuad.run()

Supported eassing equations

• Linear
• Sine
• Quad
• Quart
• Quint
• Circ
• Cubic
• Expo
• Back
• Bounce
• Elastic

Springs

Cheetah supports spring dynamics with tension and friction parameters.

Example

view.cheetah
  .move(200, 0)
  .spring()
  .run()

view.cheetah
  .move(200, 0)
  .spring(tension: 100, friction: 4)
  .run()

Animate custom properties

You can extend CheetahProperty to animate custom properties. You can refer CheetahViewProperties.swift and CheetahLayerProperties.swift.

:)