This library is experimental. API and all codes will be changed without notice
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.
- iOS 8.0~
- Swift 2.0
// Create view
let box = UIView(frame:CGRectMake(100,100,50,50))
view.backgroundColor = UIColor.blueColor()
view.addSubview(box)
// Move to 100px right
box.cheetah.move(100, 0).run()
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
Cheetah groups animation properties and execute them at once.
view.cheetah
.move(100, 0)
.rotate(M_PI * 2)
.scale(1.5)
.run()
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()
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()
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
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
You can extend CheetahProperty to animate custom properties. You can refer CheetahViewProperties.swift and CheetahLayerProperties.swift.
:)