URBMediaFocusViewController is an experiment to recreate the view used to enlarge photos and videos from their thumbnail previews as seen in Tweetbot 3 for iOS 7 using the new UIDynamics API available in iOS 7.
CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries in your projects.
Add the following to your Podfile and run $ pod install:
pod "URBMediaFocusViewController"
If you don't have CocoaPods installed or integrated into your project, you can learn how to do via CocoaPods.
To use URBMediaFocusViewController in your own project, just import URBMediaFocusViewController.h and URBMediaFocusViewController.m files into your project, and then include "URBMediaFocusViewController.h" where needed, or in your precompiled header.
The project uses ARC and targets iOS 7.0+.
NOTE: This project has been updated to work with and tested against iOS 6 (when compiling using Xcode 5+). However, the UIDynamics features are only support in iOS 7+.
To create an instance of URBMediaFocusViewController, just instantiate it the same way you would UIViewController, or by simply using init:
self.mediaFocusController = [[URBMediaFocusViewController alloc] init];
/* ...or... */
self.mediaFocusController = [[URBMediaFocusViewController alloc] initWithNibName:nil bundle:nil];
The standard usage of URBMediaFocusViewController is to use it for displaying full-size photos over an existing view. In most cases, you would use it from a smaller thumbnail view of the photo you wish to show an enlarged version for. You can either display a photo that already exists locally within your project, or load the full-size image from a remote URL asynchronously using NSURLConnection.
The standard method would be to load your thumbnail images first, then request their full sizes when displaying the media focus view:
NSURL *url = [NSURL URLWithString:@"http://apollo.urban10.net/random/oiab/01.jpg"];
[self.mediaFocusController showImageFromURL:url fromView:self.thumbnailView];
The following is a basic example of showing an image that is linked into your project locally:
[self.mediaFocusController showImage:[UIImage imageNamed:@"seattle01.jpg"] fromView:self.thumbnailView];
In most cases, you would present URBMediaFocusViewController from your app's key window, which is the default implementation. However, in some cases you may want to present your URBMediaFocusViewController view from a specific view controller. You can provide a parent view controller in those cases, and the URBMediaFocusViewController instance will be added on top of that controller's view:
[self.mediaFocusController showImageFromURL:url fromView:self.thubmnailView inViewController:self];
The component will automatically detect if a loaded remote image is a GIF and properly animate it once it appears if so. You can also use the following built-in category methods to provide your own animated GIF image when displaying images that are local to your project:
+ (UIImage *)urb_animatedImageWithAnimatedGIFData:(NSData *)data;
+ (UIImage *)urb_animatedImageWithAnimatedGIFURL:(NSURL *)url;
Most of the customization options included within this component are related to animation and physics, all of which are stored as static variables in URBMediaFocusViewController.m and can be quickly edited to achieve your desired effect.
By default, parallax and blur effects are enabled. To disable one or both effects, just set the following properties on your instance:
self.parallaxEnabled = NO; // default YES
self.shouldBlurBackground = NO; // default YES
By default, tapping on the image will not dismiss the focus view (as controlled by shouldDismissOnTap), but tapping outside of the image bounds will. You can change this by setting shouldDismissOnImageTap to YES on your URBMediaFocusViewController instance, which will allow tapping directly on the image to dismiss:
self.shouldDismissOnImageTap = YES; // default NO
If you wish to only dismiss using UIDynamics, you can also dismiss the default tap gesture used to dismiss (not recommended for iOS 6 since UIDynamics isn't available):
self.shouldDismissOnTap = NO; // default YES
You can also provide copy and save actions for the presented photo from an action sheet when the image receives a long press gesture. By default this feature is disabled, so just control this using the shouldShowPhotoActions property:
self.shouldShowPhotoActions = YES; // default NO
Add CocoaPods spec(added 11/15/2013)- Support for handling device orientation changes
Support for focusing in image from a web view (issue #6)(added 1/5/2014)Support for animated GIFs(added 4/14/2014)- Add support for loading videos similar to the method for remote photos
- Consider adding support for additional present/dismiss transition animations
This code is distributed under the terms and conditions of the MIT license.