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
MPFoldTransition is a set of classes to add folding-style transitions to iOS 5 projects.
MPFlipTransition is a set of classes to add page-flipping transitions to iOS 5 projects.
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
- Mode: Normal vs. Cubic
- Orientation: Vertical vs. Horizontal
Flip Styles
Currently there are 3 style bits that can be combined for 8 different styles.
- Direction: Forward vs. Backward
- Orientation: Horizontal vs. Vertical
- Perspective: Normal vs. Reverse
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.
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)
Best,
Mark Pospesel
Website: http://markpospesel.com/
Contact: http://markpospesel.com/about
Twitter: http://twitter.com/mpospese
Hire Me: http://crazymilksoftware.com/