How To Get

1. Install dependency: Nimbus

If your project uses CocoaPods to manage its dependencies, easiest way to do it is to add the following in your Podfile:

pod 'Nimbus/Photos', :podspec => 'https://gist.github.com/exalted/7655606/raw/ce27220c457984ecd30fb800503b4c299159ace0/Nimbus.podspec'

2. Copy `PTImageAlbumViewController` directory into your own project

Instead of manually downloading files, you could use git submodules:

git submodule add https://github.com/exalted/PTImageAlbumViewController.git

3. `#import` headers

#import <Nimbus/NimbusCore.h>
#import <Nimbus/NimbusPhotos.h>

4. Build & run

If you have trouble, check out AlbumDemo project in Examples directory for a working example.

Screenshots

A nice image scrubber, just like in Photos.app by Apple on the iPad.

One tap on the screen and all the chrome goes away!

Double tap to fit to screen by zooming in...

Flip from one image to another with multi–touch gestures you already know and love.

Pinch to zoom in and out to take a much closer look.

Sample Code

Create a new subclass of PTImageAlbumViewController, say YourAwesomeViewController
Implement PTImageAlbumViewDataSource

Number of images
Path or URL for each of'em (high–definition and thumbnail)
Size (width & height) for high–definition images

// YourAwesomeViewController.h

#import "PTImageAlbumViewController.h"

@interface YourAwesomeViewController : PTImageAlbumViewController

// ...

@end

// YourAwesomeViewController.m

#import "YourAwesomeViewController.h"

@implementation YourAwesomeViewController

//...

#pragma mark - PTImageAlbumViewDataSource

- (NSInteger)numberOfImagesInAlbumView:(PTImageAlbumView *)imageAlbumView {
    #warning missing implementation
}

- (NSString *)imageAlbumView:(PTImageAlbumView *)imageAlbumView sourceForImageAtIndex:(NSInteger)index {
    #warning missing implementation
}

- (CGSize)imageAlbumView:(PTImageAlbumView *)imageAlbumView sizeForImageAtIndex:(NSInteger)index {
    #warning missing implementation
}

- (NSString *)imageAlbumView:(PTImageAlbumView *)imageAlbumView sourceForThumbnailImageAtIndex:(NSInteger)index {
    #warning missing implementation
}

//...

@end

How To Contribute

This project uses CocoaPods to manage dependencies. Installing it is as easy as running the following commands in the terminal:

sudo gem install cocoapods

If you have any trouble during the installation, please read CocoaPods documentation.

When you've installed CocoaPods, then:

git clone https://github.com/exalted/PTImageAlbumViewController.git PTImageAlbumViewController-exalted
cd PTImageAlbumViewController-exalted/Examples/AlbumDemo/
pod install
open AlbumDemo.xcworkspace

exalted/PTImageAlbumViewController