Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/overboming/ZCAnimatedLabel

UILabel replacement with fine-grain appear/disappear animation
https://github.com/overboming/ZCAnimatedLabel

Last synced: about 2 months ago
JSON representation

UILabel replacement with fine-grain appear/disappear animation

Lists

README 

        
# ZCAnimatedLabel

UILabel-like view with easy to extend appear/disappear animation



# Features

* Rich text support (with NSAttributedString)

* Group aniamtion by character/word/line

* Customizable animation start delay for each text block

* Great performance, only changed area is redrawn

* Optional layer-based implementation

* 3D/Geometry transform support (layer based only)

* iOS 5+ compatibility



# Demo



* Default 



![image](http://zippy.gfycat.com/LimitedWigglyGermanshepherd.gif)



* Fall

 

![image](http://zippy.gfycat.com/FantasticGargantuanHog.gif)



* Duang/Spring 



![image](http://zippy.gfycat.com/GrippingMeanJavalina.gif)



* Flyin 



![image](http://zippy.gfycat.com/JampackedCompetentGerbil.gif)



* Focus 



![image](http://zippy.gfycat.com/FeistyShockingGermanshepherd.gif)



* Shapeshift  



![image](http://zippy.gfycat.com/ForkedScalyKagu.gif)



* Reveal 



![image](http://zippy.gfycat.com/GrouchyLastingGrizzlybear.gif)

 

* Thrown



 ![image](http://zippy.gfycat.com/RashDecimalImperatorangel.gif)



* Transparency 



![image](http://zippy.gfycat.com/NeighboringSlightJumpingbean.gif)



* Spin 



![image](http://zippy.gfycat.com/UnderstatedBoldAlpineroadguidetigerbeetle.gif)

* Dash 



![image](http://zippy.gfycat.com/DeadlyUnlinedJunco.gif)

* More to come



# How to use

`ZCAnimatedLabel` is available via CocoaPods. If you don't need all the effect subclasses, simply drag `ZCAnimatedLabel.(h|m)`, `ZCCoreTextLayout.(h|m)` and `ZCEasingUtil.(h|m)` into your project and start customizing your own.



# Subclassing

`ZCAnimatedLabel` has two modes: non-layer based and layer based. In the first mode, `ZCAnimatedLabel` is a flat `UIView`, every stage of animation is drawn using Core Graphics, you can customize redraw area for your animation for better performance. Following methods can be overriden:



* `- (void) textBlockAttributesInit: (ZCTextBlock *) textBlock;`

* `- (void) appearStateDrawingForRect: (CGRect) rect textBlock: (ZCTextBlock *) textBlock;`

* `- (void) disappearStateDrawingForRect: (CGRect) rect textBlock: (ZCTextBlock *) textBlock;`

* `- (CGRect) redrawAreaForRect: (CGRect) rect textBlock: (ZCTextBlock *) textBlock;`



Second option is layer based, where each text block is a simple `CALayer`, 3D tranform is possible in this mode by setting layer's `transform` property, if redraw area is bigger and not too many text blocks, this can achive a performance gain. Set `self.layerBased` to `YES` and override following methods for customization:



* `- (void) textBlockAttributesInit: (ZCTextBlock *) textBlock;`

* `- (void) appearStateLayerChangesForTextBlock: (ZCTextBlock *) textBlock;`

* `- (void) disappearLayerStateChangesForTextBlock: (ZCTextBlock *) textBlock;`



# Todo

* Merge CALayers no longer animating into a single backing store and reuse CALayer for animating layers. (Even better performance for layerBased implementation)

* More Effects, possily glyph related ones

* Use core animation emmiter



# Thanks to



* [`LTMorhpingLabel`](https://github.com/lexrus/LTMorphingLabel) for heavy inspiration. If you like `ZCAnimatedLabel`, you should definitely this one out. 

* [`AGGeometryKit`](https://github.com/hfossli/AGGeometryKit) for arbitrary shape 3D transform code piece used in `ZCDashLabel`