Anima - GitLite

KO | EN

gitlite — search

#python #hacktoberfest #react #ai #typescript #machine-learning #macos #nodejs #java #cli #vue #pytorch #openai #mcp

Anima

(★ 619)

Anima is chainable Layer-Based Animation library for Swift5.

파일 탐색기

최종 버전 다운로드 (.zip)

- - deploy-pods.yml
- - contents.xcworkspacedata
- project.pbxproj
- AnimaTests.swift
- Info.plist
- - Contents.json
- AnimaListTableViewController.swift
- AppDelegate.swift
- CornerLineAnimationViewController.swift
- Info.plist
- LaunchScreen.storyboard
- Main.storyboard
- MovePathAnimationViewController.swift
- MoveViewController.swift
- PauseResumeAnimationViewController.swift
- SizeAnimationViewController.swift
- SpreadViewController.swift
- UIColor+Anima.swift
- Appfile
- Fastfile
- eyecatch.gif
- eyecatch.png
- sample1.gif
- sample_anchor.gif
- sample_group.gif
- sample_move.gif
- sample_rotate.gif
- Anima+CALayer.swift
- Anima.h
- Anima.swift
- AnimaAnchorPoint.swift
- AnimaAnimation.swift
- AnimaAnimations.swift
- AnimaNode.swift
- AnimaOption.swift
- AnimationType.swift
- AnimaType.swift
- AnimaUtility.swift
- Info.plist
- TimingFunction.swift
.gitignore
.swift-version
.travis.yml
Anima.framework.zip
Anima.podspec
CODE_OF_CONDUCT.md
Gemfile
Gemfile.lock
LICENSE
Package.swift
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/satoshin21/Anima

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd Anima

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Ruby

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Ruby bundle 명령어를 쓰려면 Ruby가 필요합니다.

bundle install

Gemfile에 명시된 루비 라이브러리를 설치합니다.

✅ bundle install이 에러 없이 끝나면 README에 안내된 실행 명령어(예: rails server)로 마저 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[![Version](https://img.shields.io/cocoapods/v/Anima.svg?style=flat)](http://cocoapods.org/pods/Anima)
[![License](https://img.shields.io/cocoapods/l/Anima.svg?style=flat)](http://cocoapods.org/pods/Anima)
[![Platform](https://img.shields.io/cocoapods/p/Anima.svg?style=flat)](http://cocoapods.org/pods/Anima)
![language](https://img.shields.io/badge/Language-Swift4-8E44AD.svg)
![Version](https://img.shields.io/badge/Pod-%20v2.0.1%20-96281B.svg)
![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)
![MIT License](https://img.shields.io/github/license/mashape/apistatus.svg)
![Platform](https://img.shields.io/badge/platform-%20iOS%20-lightgrey.svg)
![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)

<p align="center">
<img src="./img/eyecatch.png"/>
</p>

# Anima

Anima is chainable Layer-Based Animation library for Swift5.<br>
It support to make sequensial and grouped animation more easily.

<img src="./img/eyecatch.gif" width=700px>

is written as follows.

```swift
let startAnimations: [AnimaType] = [.moveByY(-50), .rotateByZDegree(90)]
let moveAnimations: [AnimaType] = [.moveByX(50), .rotateByZDegree(90)]
let endAnimations: [AnimaType] = [.moveByY(-50), .rotateByZDegree(90)]

animaView.layer.anima
    .then(.opacity(1.0))
    .then(group: startAnimations)
    .then(group: moveAnimations, options: labelAnimaOption(index: 0))
    .then(group: moveAnimations, options: labelAnimaOption(index: 1))
    .then(group: moveAnimations, options: labelAnimaOption(index: 2))
    .then(group: moveAnimations, options: labelAnimaOption(index: 3))
    .then(group: endAnimations, options: labelAnimaOption(index: 4))
    .then(group: [.scaleBy(0.0), .opacity(0.0)])

func labelAnimaOption(index: Int) -> [AnimaOption] {
    let labelAnima = labels[index]?.layer.anima

return [.completion({
        labelAnima?.then(.opacity(1)).fire()
    })]
}
```

## Requirements

Anima require for Swift4 and greater than iOS9.0📱<br>

## Features

- Almost all timing modes from [easings.set](http://easings.net/) are implemented.
- Spring Animation ( featured by [CASpringAnimation](https://developer.apple.com/reference/quartzcore/caspringanimation) )
- Type-Safed Animation KeyPath ()

## Usage

### Move Position

If you want to translate `CALayer.position` relatively, use `.moveByX(CGFloat)`, `.moveByY(CGFloat)`, `.moveByXY(x: CGFloat, y: CGFloat)` AnimaTypes.

<img src="./img/sample_move.gif" width=300px>

```swift
layer.anima.then(.moveByX(50)).fire()
```

or destination is determined, use `.moveTo(x: CGFloat, y: CGFloat)`.

※ Anima doesn't update `CALayer.position` value for animations. Because when update Layer-backed view's layer position value, It will be resetted to default value frequently.

### Sequential Animation

Anima supports.

### Group Animation

To run animation concurrently, you use `CAAnimationGroup` with CoreAnimation.
In Anima, you can use `Anima.then(group: )` to run some `AnimaType` concurrently.

Below is an example of how to run moving, scaling and rotating animations concurrently.

<img src="./img/sample_group.gif" width=300px>

```swift
layer.anima
    .then(group: [.moveByX(200),
                .scaleBy(1.5),
                .rotateByZDegree(180)])
    .fire()
```

### Animation Options

There are some options for Anima.

- duration(TimeInterval)
- timingFunction(TimingFunction)
  _ Change timing function defining the pacing of the animation.
  _ Default timing function is at `Anima.defaultTimingFunction`. If you do not set the timing function option, defaultTimingFunction is used. \* Please read `Anima.TimingFunction.swift`
- repeat(count: Float) \* To run animation infinitely, set `.infinity`.
- autoreverse
- completion(() -> Void)

you can use these values as belows.

```
layer
    .anima
    .then(.moveByX(100), options: [.autoreverse,
                                   .timingFunciton(.easeInQuad),
                                   .repeat(count: 3),
                                   .completion({
                                    print("completion")
                                   })])
    .fire()
```

### Rotate Animation & AnchorPoint

AnimaType has 3 rotation animation type, `.rotateByX`, `.rotateByY`, `.rotateByZ`.
and each animation type has 2 value types, `degrees` and `radians`.
you use whichever you like.

and CALayer has `AnchorPoint`. Rotating, moving, or other Animations are affected by it. Default value is (0.5, 0.5).
`AnimaType.moveAnchor(AnimaAnchorPoint)` can move layer's AnchorPoint.

<img src="./img/sample_rotate.gif" width=300px>

```swift
layer.anima
    .then(.rotateByZDegree(360))
    .then(.moveAnchor(.topLeft))
    .then(.rotateByZDegree(360))
    .fire()
```

or If you want to change only AnchorPoint, use `Anima.then(setAnchor: AnimaAnchorPoint)`.

<img src="./img/sample_anchor.gif" width=300px>

```swift
layer.anima
    .then(.rotateByZDegree(360))
    .then(setAnchor: .topLeft)
    .then(.rotateByZDegree(360))
    .fire()
```

### Move Path

If you want to make moving animation more complex, use `.movePath(path: CGPath, keyTymes: [Double])`.
Anima example app has sample of creating animation by drag gesture. you see it!

but It has any problems when you use with `AnimaOption.autoreverse`.
so If you use it, please be careful of options.

### Original KeyPath

If you want to animate other animatable values, You can use `AnimaType.original(keyPath: String, from: Any?, to: Any)` for it.
`CAEmitterLayer`'s animation is like this.

```swift
let layer = CAEmitterLayer()
layer.emitterPosition = CGPoint(x: 100.0, y:100.0)

layer.anima
    .then(.original(keyPath: #keyPath(CAEmitterLayer.emitterPosition), from: layer.emitterPosition, to: CGPoint(x: 200.0, y:200.0)))
    .fire()
```

## Example

To run the example project, clone the repo, open `Anima.xcodeproj`, and run target `Anima iOS Example`.

## Installation

### Cocoapods

Anima is available through [CocoaPods](http://cocoapods.org). To install
it, simply add the following line to your Podfile:

```ruby
pod "Anima"

# If you want to use Swift 3 version, Please specify Anima version.

pod "Anima", "0.5.1"
```

### Carthage

Add github `satoshin21/Anima` to your `Cartfile`.
Execute carthage update to install it.

## Author

Satoshi Nagasaka, satoshi.nagasaka21@gmail.com

## License

Anima is available under the MIT license. See the LICENSE file for more info.