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: about 2 months 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 (over 8 years ago)
Default Branch: master
Last Pushed: 2019-04-12T09:09:33.000Z (about 5 years ago)
Last Synced: 2024-04-16T12:04:57.271Z (2 months ago)
Language: Swift
Size: 83 KB
Stars: 282
Watchers: 90
Forks: 27
Open Issues: 6
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
awesome-ios2 - Animo - SpriteKit-like animation builders for CALayers. (UI / Other free courses)
awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Other free courses)
awesome-ios-star - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Other free courses)
awesome-swift-cn - Animo - SpriteKit-like animation builders for CALayers. (Libs / Animation)
awesome-xamarin-forms - Animo - SpriteKit-like animation builders for CALayers. :large_orange_diamond: (Animation)
awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
awesome-ios - Animo - SpriteKit-like animation builders for CALayers. :large_orange_diamond: (UI / Other free courses)
awesome-iosx - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
awesome-iosr - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
learn.awesome-iOS - Animo - SpriteKit-like animation builders for CALayers. :large_orange_diamond: (UI)
awesome-ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)
learn.awesome.ios - Animo - SpriteKit-like animation builders for CALayers. (UI / Animation)

README

# Animo
[![Version](https://img.shields.io/cocoapods/v/Animo.svg?style=flat)](http://cocoadocs.org/docsets/Animo)
[![Platform](https://img.shields.io/cocoapods/p/Animo.svg?style=flat)](http://cocoadocs.org/docsets/Animo)
[![License](https://img.shields.io/cocoapods/l/Animo.svg?style=flat)](https://raw.githubusercontent.com/eure/Animo/master/LICENSE)
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)

Bring life to CALayers with SpriteKit-like animation builders.

![preview](https://cloud.githubusercontent.com/assets/3029684/11888561/1df51b40-a582-11e5-85c4-564a7f39ca08.gif)

## 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.