https://github.com/hon-key/thinkverb

A super cool animation interface based on CoreAnimation
https://github.com/hon-key/thinkverb

animation coreanimation ios objective-c swift

Last synced: 20 days ago
JSON representation

A super cool animation interface based on CoreAnimation

• Host: GitHub
• URL: https://github.com/hon-key/thinkverb
• Owner: hon-key
• License: mit
• Created: 2019-01-16T12:55:19.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2021-03-16T09:49:33.000Z (over 3 years ago)
• Last Synced: 2024-10-11T10:26:19.049Z (about 1 month ago)
• Topics: animation, coreanimation, ios, objective-c, swift
• Language: Objective-C
• Homepage:
• Size: 568 KB
• Stars: 107
• Watchers: 6
• Forks: 20
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        


[![Cocoapods](https://img.shields.io/badge/pod-1.1.0-orange.svg)](https://img.shields.io/badge/pod-1.2.4-orange.svg)

[![Platform](https://img.shields.io/badge/platform-iOS-lightgrey.svg)](https://img.shields.io/badge/platform-iOS-lightgrey.svg)

[![Language](https://img.shields.io/badge/language-Objective--C-blue.svg)](https://img.shields.io/badge/language-Objective--C-blue.svg)

[English Introduction](https://github.com/hon-key/ThinkVerb/blob/master/README_EN.md)

# ThinkVerb

ThinkVerb 是一组基于 CoreAnimation 的 API，相比与直接使用 CoreAnimation，ThinkVerb 通过链式语法进行编程，并且自管理 CAAnimation，你无需自己手动创建任何 CAAnimation 并将其添加到视图上。

得益于此，ThinkVerb 可以用非常少的代码快速生成基础动画，不单单如此，你所写的代码还相当可读而易于维护。

目前 ThinkVerb 的功能几乎涵盖了所有的基础动画，你可以轻松通过多个基础动画的组合来生成一个复杂的动画。如果用原生代码，你可能需要大量代码来完成此工作，但是用 ThinkVerb，你则可以在短短几行代码里完成相同的工作量。

# Usage

ThinkVerb 很简单，它只有一个入口，那就是 ThinkVerb 扩展 UIView 的一个属性：TVAnimation。

TVAnimation 管理所有的动画单元，我们称动画单元为 Sprite，你需要做的只有：通过 TVAnimation 创建 sprite，配置 sprite，最后 activate sprite。

这样，动画就被激活，UIView 将自动开始动画。

#### 例如，如果你想永不停息地旋转你的 UIView，你只需要下面这一句代码：

```

NSString *rotation = view.TVAnimation.rotate.z.endAngle(M_PI * 2).repeat(-1).activate();

```

或者，如果你想为你创建的 sprite 定义你自己想要的名字，你可以这么写:

```

view.TVAnimation.rotate.z.endAngle(M_PI * 2).repeat(-1).activateAs(@"rotation");

```

这行代码会绕着 z 轴旋转你的 UIView，其旋转角度是从 UIView 当前的角度旋转到 M_PI * 2，假设当前角度是 0，那就是转一圈。**`repeat(-1)`** 能够让 sprite 无限重复。最后，调用 **`activate()`** 就等于激活了该动画。

#### 通常情况下，如果你没有让 sprite 永远重复下去，或者没有让 sprite 在动画结束时停留，sprite 会自动被移除并释放，而如上面的例子，你需要手动移除该动画:

```

view.TVAnimation.clear();

```

#### 上面一行代码移除 view 的所有动画，通常情况下，你调用这一行代码就够了，如果你不想对 view 的其他动画造成影响，你可以只移除相应的动画:

```

view.TVAnimation.existSprite(rotation).stop();

```

如果你自己定义了名字，你可以这么做:

```

view.TVAnimation.existSprite(@"rotation").stop();

```

这样，旋转会停止，sprite 会被移除并释放，否则，就算 view 释放掉了，sprite 也不会被释放，从而造成内存泄漏。

你可以通过 ThinkVerbDemo 看到更多的例子。

ThinkVerb 做复杂动画也是相当轻松的，你甚至可以写出一把手枪来:

```

view.TVAnimation.appearance.duration(3).timing(TVTiming.extremeEaseOut).end();

view.TVAnimation.contents.drawRange(nil,[UIImage imageNamed:@"1"]).didStop(^{

    view.TVAnimation.contents.drawRange([UIImage imageNamed:@"1"],[UIImage imageNamed:@"2"]).didStop(^{

        view.TVAnimation.contents.drawRange([UIImage imageNamed:@"2"],[UIImage imageNamed:@"3"]).didStop(^{

            view.TVAnimation.contents.drawRange([UIImage imageNamed:@"3"],[UIImage imageNamed:@"2"]).activate();

        }).activate();

    }).activate();

}).activate();

```

# Installation

## Using cocoapods

```

pod 'ThinkVerb'

```

# 版本信息

当前版本：1.1.0

更新:

适配 iOS 8

## Copy files

拷贝子 ThinkVerb 文件夹下的所有源码到你的工程

# Indexes

* ### Basic

    - [**move**](#move) **`从某个点移动 view 到另一个点`**

    - [**scale**](#scale) **`将 view 缩放到某个倍数`**

    - [**rotate**](#rotate) **`围绕 x/y/z 轴旋转 view`**

    - [**shadow**](#shadow) **`对 shadow 的 offset/opacity/radius/color 做动画,`**

    - [**bounds**](#bounds) **`对 view 的 bounds 做动画，注意该动画效果取决于 anchorPoint `**

    - [**anchor**](#anchor) **`对 view 的 anchorPoint 做动画，单独进行不会有任何效果，需要和相关的动画组合才会有效果`**

    - [**translate**](#translate) **`通过偏移来移动动画，基于 Transform3D，所以你可以将它应用到 sublayer 上`**

    - [**fade**](#fade) **`淡入淡出`**

    

    - [**contents**](#contents) **`对 cotnents 属性做动画，如 rect属性会对位图的渲染范围做动画，范围在 [0 0 1 1] 内`**

    - [**backgroundColor**](#backgroundColor) **`背景变换`**

    - [**cornerRadius**](#cornerRadius) **`圆角动画`**

    - [**border**](#border) **`对 view 的边框的宽度和颜色做动画`**

    - [**path**](#path) **`对 view 做关键帧动画，可通过贝塞尔控制点生成曲线动画`**

    

    - [**basicCustom**](#path) **`对 view 做自定义动画，可快速对自定义layer进行动画控制`**

* ### Appearance

    appearance sprite 可以用来对某个 view 配置默认参数，如果你想让某个 view 的所有 sprite 默认在动画结束时停留而不移除，你可以在生成 sprite 之前写:

    ```

    view.TVAnimation.appearance.keepAlive(YES).end();

    ```

## License

ThinkVerb is released under the MIT license. See [LICENSE](https://github.com/hon-key/ThinkVerb/blob/master/LICENSE) for details.