Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eure/Animo
Bring life to CALayers with SpriteKit-like animation builders
https://github.com/eure/Animo
Last synced: 6 days ago
JSON representation
Bring life to CALayers with SpriteKit-like animation builders
- Host: GitHub
- URL: https://github.com/eure/Animo
- Owner: eure
- License: mit
- Created: 2015-09-27T14:19:20.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2019-04-12T09:09:33.000Z (over 5 years ago)
- Last Synced: 2024-11-14T00:36:15.618Z (28 days ago)
- Language: Swift
- Size: 83 KB
- Stars: 282
- Watchers: 90
- Forks: 27
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
- awesome-ios-star - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
- awesome-swift-cn - Animo - SpriteKit-like animation builders for CALayers. (Libs / Animation)
README
# Animo
[](http://cocoadocs.org/docsets/Animo)
[](http://cocoadocs.org/docsets/Animo)
[](https://raw.githubusercontent.com/eure/Animo/master/LICENSE)
[](https://github.com/Carthage/Carthage)
Bring life to CALayers with SpriteKit-like animation builders.
## Why use Animo?
Because declaring `CAAnimation`s (especially with `CAAnimationGroup`s) is very verbose and tedious.
Animo turns this:
```swift
let positionAnimation = CABasicAnimation(keyPath: "position")
positionAnimation.fromValue = NSValue(CGPoint: fromPoint)
positionAnimation.toValue = NSValue(CGPoint: toPoint)
let colorAnimation = CABasicAnimation(keyPath: "backgroundColor")
colorAnimation.fromValue = fromColor.CGColor
colorAnimation.toValue = toColor.CGColor
let animationGroup = CAAnimationGroup()
animationGroup.animations = [positionAnimation, colorAnimation]
animationGroup.fillMode = kCAFillModeForwards
animationGroup.removedOnCompletion = false
animationGroup.timingFunction = CAMediaTimingFunction(name: kCAMediaTimingFunctionEaseInEaseOut)
someView.layer.addAnimation(animationGroup, forKey: "animationGroup")
```
to this:
```
someView.layer.runAnimation(
Animo.group(
Animo.move(from: fromPoint, to: toPoint, duration: 1),
Animo.keyPath("backgroundColor", from: fromColor, to: toColor, duration: 1),
timingMode: .EaseInOut,
options: Options(fillMode: .Forwards)
)
)
```
## Feature List
- All timing modes from [http://easings.net/](http://easings.net/) are implemented.
- Choose how to mix your animations with grouping utilities:
- `group(...)`
- `sequence(...)`
- `autoreverse(...)`
- `wait(...)`
- `replay(...)` and `replayForever(...)`
- No need to box native types and struct types in `NSValue`s! Animo will do that for you for:
- `Int8`
- `Int16`
- `Int32`
- `Int64`
- `UInt8`
- `UInt16`
- `UInt32`
- `UInt64`
- `Int`
- `UInt`
- `CGFloat`
- `Double`
- `Float`
- `CGPoint`
- `CGSize`
- `CGRect`
- `CGAffineTransform`
- `CGVector`
- `CATransform3D`
- `UIEdgeInsets`
- `UIOffset`
- `NSRange`
- No need to bother between `CGColor` and `UIColor`! Animo automatically converts the following types for you so you can just use UIKit objects all the time:
- `UIColor` → `CGColor`
- `UIImage` → `UIImage`
- `UIBezierPath` → `CGPath`
- Don't bother type-casting `M_PI` anymore and just use Degrees-to-Radians (and vice-versa) extensions for `CGFloat`, `Double`, and `Float`!
Here's a slightly complex animation that showcases what else you can do with Animo:
```swift
someView.layer.runAnimation(
Animo.sequence( // Runs a list of animations in sequence
Animo.wait(1), // Waits for a certain interval before running the next animation
Animo.replayForever( // Replays the animation endlessly
Animo.sequence(
Animo.move( // Moves the layer's position
by: CGPoint(x: 100, y: 200), // "by", "from", and "to" arguments are supported
duration: 2,
timingMode: .Spring(damping: 1) // simplistic spring function that doesn't rely on physics
),
Animo.rotateDegrees( // Rotates the layer (degrees and radians variants are supported)
by: -180,
duration: 1,
timingMode: .EaseInOutBack
),
Animo.autoreverse( // Auto-reverses the animation
Animo.keyPath(
"cornerRadius", // Any custom KVC key is supported as well!
to: 10,
duration: 1,
timingMode: .EaseInOutBack
)
),
Animo.group( // Runs multiple animations together
Animo.scaleX(
by: 2,
duration: 1,
timingMode: .EaseInOutBack
),
Animo.scaleY(
by: 0.5,
duration: 1,
timingMode: .EaseInOutBack
)
),
Animo.wait(1),
Animo.move(
by: CGPoint(x: -100, y: -200),
duration: 2,
timingMode: .EaseInOutBack
),
Animo.rotateDegrees(
by: 180,
duration: 1,
timingMode: .EaseInOutBack
),
Animo.group(
Animo.scaleX(
to: 1,
duration: 1,
timingMode: .EaseInOutBack
),
Animo.scaleY(
to: 1,
duration: 1,
timingMode: .EaseInOutBack
)
)
)
)
)
)
```
### Install with CocoaPods
Add
```
pod 'Animo'
```
to your `Podfile` and run `pod install`
### Install with Carthage
Add
```
github "eure/Animo" >= 1.2.0
```
to your `Cartfile` and run `carthage update`
### Install as Git Submodule
Run
```
git submodule add https://github.com/eure/Animo.git
```
#### To install as a framework:
Drag and drop **Animo.xcodeproj** to your project.
#### To include directly in your app module:
Add all *.swift* files to your project.
## License
Animo is released under an MIT license. See the LICENSE file for more information.