Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mpospese/MPFoldTransition

Easily add custom folding and page-flipping transitions to UIViews and UIViewControllers
https://github.com/mpospese/MPFoldTransition

Last synced: about 2 months ago
JSON representation

Easily add custom folding and page-flipping transitions to UIViews and UIViewControllers

Awesome Lists containing this project

README 

        
MPTransition

=====================

__Update__: MPTransition now comprises MPFoldTransition and MPFlipTransition  

  

__Update 2__: For a touch gesture-enabled container controller with page-flipping (not just a transition), see [MPFlipViewController](https://github.com/mpospese/MPFlipViewController)  

  

MPFoldTransition is a set of classes to add folding-style transitions to iOS 5 projects.  

![iPhone Fold](http://markpospesel.files.wordpress.com/2012/05/iphone-fold2.png)  

MPFlipTransition is a set of classes to add page-flipping transitions to iOS 5 projects.  

![iPhone Flip](http://markpospesel.files.wordpress.com/2012/05/iphone-flip-3.png)  

I built it using ARC (and for the demo portion storyboards) strictly for convenience, so it uses iOS 5.  I imagine the relevant code (minus the UIStoryboardSegue helper classes) could be easily ported to iOS 4.3 under ARC, or ported to iOS 4.0 with memory management inserted.  (_Hint:_ If you're porting to non-ARC, you'll need to retain [sourceView superView] in the init method.)



Features

---------

* Convenience methods to extend UIViewController to present/dismiss a view controller modally using fold/flip transitions

* Convenience methods to extend UINavigationController to push/pop view controllers onto the navigation stack using fold/flip transitions

* Convenience methods to transition between any 2 UIViewControllers or UIViews

* 3 Custom UIStoryboardSegue subclasses to easily add folding/flipping transitions via Interface Builder in your storyboards

* Fully customizable to adjust style, duration, timing curves, and completion action

* Blocks-based: many methods include a completion block parameter following the pattern of block-based animations introduced in iOS 4.



Fold Styles

---------

Currently there are 3 style bits that can be combined for 8 different styles.

* __Direction:__ Fold vs. Unfold  

![Fold vs. Unfold](http://markpospesel.files.wordpress.com/2012/05/fold-vs-unfold2.png)  

* __Mode:__ Normal vs. Cubic  

![Normal vs. Cubic](http://markpospesel.files.wordpress.com/2012/05/normal-vs-cubic2.png)  

* __Orientation:__ Vertical vs. Horizontal  

![Vertical vs. Horizontal](http://markpospesel.files.wordpress.com/2012/05/vertical-vs-horizontal2.png)  



Flip Styles

---------

Currently there are 3 style bits that can be combined for 8 different styles.

* __Direction:__ Forward vs. Backward  

![Forward vs. Backward](http://markpospesel.files.wordpress.com/2012/05/forward-vs-backward-3.png)  

* __Orientation:__ Horizontal vs. Vertical  

![Horizontal vs. Vertical](http://markpospesel.files.wordpress.com/2012/05/horizontal-vs-vertical-3.png)  

* __Perspective:__ Normal vs. Reverse  

![Normal vs. Reverse](http://markpospesel.files.wordpress.com/2012/05/normal-vs-reverse-3.png)  



Requirements

-----------

* Xcode 4.4 or higher

* LLVM compiler

* iOS 5 or higher



How To Use

---------

See the "MPFoldTransition.h" (and "MPFlipTransition.h") header file(s) for methods and use the demo project as a reference.  The Segue classes (under directory of the same name) are optional, only if you want to include storyboard support.  Otherwise you just need the classes under the bottommost MPFoldTransition directory.



Licensing

---------

Read Source Code License.rtf, but the gist is:

* Anyone can use it for any type of project

* All I ask for is attribution somewhere



Support, bugs and feature requests

----------------------------------

There is absolutely no support offered with this component. You're on your own! If you want to submit a feature request, please do so via [the issue tracker on github](https://github.com/mpospese/MPFoldTransition/issues).  

  

If you want to submit a bug report, please also do so via the issue tracker, including a diagnosis of the problem and a suggested fix (in code). If you're using MPTransition, you're a developer - so I expect you to do your homework and provide a fix along with each bug report. You can also submit pull requests or patches.  

  

Please don't submit bug reports without fixes!  



(The preceding blurb provided courtesy of the legendary [Matt Gemmell](https://github.com/mattgemmell/))



Best,  

Mark Pospesel



Website: http://markpospesel.com/  

Contact: http://markpospesel.com/about  

Twitter: http://twitter.com/mpospese  

Hire Me: http://crazymilksoftware.com/