# ShapeAnimation-Swift

**Repository Path**: rhcad/ShapeAnimation-Swift

## Basic Information

- **Project Name**: ShapeAnimation-Swift
- **Description**: iOS矢量动画框架，使用简单，用Swift开发
- **Primary Language**: Swift
- **License**: BSD-2-Clause
- **Default Branch**: master
- **Homepage**: https://github.com/rhcad/ShapeAnimation-Swift
- **GVP Project**: No

## Statistics

- **Stars**: 11
- **Forks**: 3
- **Created**: 2015-01-22
- **Last Updated**: 2025-04-11

## Categories & Tags

**Categories**: ios-modules, animation

**Tags**: None

## README

# ShapeAnimation-Swift

Vector animation framework in Swift based on [SwiftGraphics](https://github.com/schwa/SwiftGraphics) for iOS 8.

With ShapeAnimation you can easily create various animations with a nice Swift based syntax.

[![Travis][travis_img]][travis]

[travis]: https://travis-ci.org/rhcad/ShapeAnimation-Swift
[travis_img]: https://travis-ci.org/rhcad/ShapeAnimation-Swift.svg?branch=master

The current development happens on the [develop][develop] branch. Code is merged back on master branch infrequently.

SVG animation development with [SVGKit](https://github.com/SVGKit/SVGKit) happens on the [SVG][svg_branch] branch.

[develop]: https://github.com/rhcad/ShapeAnimation-Swift/tree/develop
[svg_branch]: https://github.com/rhcad/ShapeAnimation-Swift/tree/SVG

## What's included

* ShapeView class which contains vector shape layers.
  * Helper functions to add image, text, circle, regular polygon, lines and other shapes.
  * Support gradient fill with animation.
  * Enumerate, hit-test or find layers.

* Animation extension functions of CALayer.
  * opacityAnimation, flashAnimation, backColorAnimation
  * scaleAnimation, tapAnimation, transformAnimation
  * rotate360Degrees, rotationAnimation
  * shakeAnimation, moveAnimation, moveOnPathAnimation
  * slideToRight, slideAnimation, flipHorizontally, flipVertically
  * Layer dragging: constrainCenterToSuperview, bringOnScreen

* Animation extension functions of CAShapeLayer.
  * strokeStartAnimation, strokeEndAnimation, lineWidthAnimation
  * strokeColorAnimation, fillColorAnimation, dashPhaseAnimation
  * switchPathAnimation

* Group animation and cascaded animation.
  * animationGroup for the same layer
  * applyAnimations for multiple layers
  * Use the block-based function in apply() to play cascaded animations.
  * Pause, resume or stop animations.

* Animations with customized properties
  * Use AnimationLayer class to draw customized animations.
  * Animation with sliders example: [EllipseViewController.swift](ShapeAnimation_UITest/EllipseViewController.swift)

![Stroke Lines](Documentation/strokelines.gif)
![Move on Path](Documentation/moveonpath.gif)
![Radar Circles](Documentation/radar.gif)

![Rotate Polygons](Documentation/rotate_polygons.gif)
![Jumping Ball](Documentation/jumpball.gif)

![Animation with Sliders](Documentation/ellipse_slider.gif)
![Drag Layers](Documentation/drag.gif)

## Usage

Please see the examples in [MasterViewController.swift](ShapeAnimation_UITest/MasterViewController.swift).

``` Swift
let layer1 = self.addLinesLayer(view, points:[(10.0,20.0),(150.0,40.0),(120.0,320.0)])
layer1.strokeEndAnimation().apply() {
    layer1.shakeAnimation().apply()
}

let la2 = self.addLinesLayer(view, points:points2, color: UIColor.blueColor())
lla2.scaleAnimation(from:1, to:1.1, repeatCount:3).apply(duration:0.3)

let la3 = self.addLinesLayer(view, points:points3, color: UIColor.greenColor())
la3.flashAnimation(repeatCount:6).apply()

let la4 = self.addLinesLayer(view, points:[(10.0,20.0), (150.0,40.0), (120.0,120.0)])
let a1 = la4.moveOnPathAnimation(path).setDuration(1.6)
let a2 = la4.rotate360Degrees().setRepeatCount(2)
animationGroup([a1, a2]).autoreverses().apply()
```

## Help Wanted

All of this code is very much a _*work in progress*_. I'm adding and changing functionality as needed.

Your help wanted. Please fork this project and submit pull requests or [issues][issues].
[issues]: https://github.com/rhcad/ShapeAnimation-Swift/issues

Contributions are always welcome in the following areas:

* Header doc comments explaining what the functions do
* Useful animation template or application examples
* Fix issues about animation, Swift usage rules or translations

## License

ShapeAnimation-Swift is released under a BSD License. See LICENSE file for details.

## FAQ

* Could not build Objective-C module 'ShapeAnimation':
  - Quit Xcode and delete the sub folders in ~/Library/Developer/Xcode/DerivedData/.