/MPFoldTransition

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

Primary LanguageObjective-C

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.
iPhone Fold
MPFlipTransition is a set of classes to add page-flipping transitions to iOS 5 projects.
iPhone Flip
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
  • Mode: Normal vs. Cubic
    Normal vs. Cubic
  • Orientation: Vertical vs. Horizontal
    Vertical vs. Horizontal

Flip Styles

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

  • Direction: Forward vs. Backward
    Forward vs. Backward
  • Orientation: Horizontal vs. Vertical
    Horizontal vs. Vertical
  • Perspective: Normal vs. Reverse
    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/