https://github.com/rhcad/shapeanimation-swift

Vector animation framework in Swift for iOS and OSX.
https://github.com/rhcad/shapeanimation-swift

animation-framework

Last synced: 8 months ago
JSON representation

Vector animation framework in Swift for iOS and OSX.

• Host: GitHub
• URL: https://github.com/rhcad/shapeanimation-swift
• Owner: rhcad
• License: other
• Created: 2015-01-22T03:19:11.000Z (over 11 years ago)
• Default Branch: develop
• Last Pushed: 2015-07-16T02:04:44.000Z (almost 11 years ago)
• Last Synced: 2025-04-02T12:09:31.667Z (about 1 year ago)
• Topics: animation-framework
• Language: Swift
• Homepage:
• Size: 6.93 MB
• Stars: 414
• Watchers: 23
• Forks: 38
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# ShapeAnimation-Swift

Vector animation framework in Swift based on [SwiftGraphics][SwiftGraphics] for iOS 9 and OSX.

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

SVG animation development with [SVGKit][SVGKit] happens on the [SVG][svg_branch] branch.

[ShapeAnimation-ObjC][SAObjC] is an alternative vector animation framework in Objective-C.

Also note this project has moved to Swift 2.0 which requires Xcode 7.0 and Mac OS X 10.10.

[SwiftGraphics]: https://github.com/schwa/SwiftGraphics

[SVGKit]: https://github.com/SVGKit/SVGKit

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

[SAObjC]: https://github.com/rhcad/ShapeAnimation-ObjC

## 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][MasterVC].

[MasterVC]: 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/.