Skip to content
This repository has been archived by the owner on Jun 6, 2018. It is now read-only.

"Image Album" — or "Photo Album" if you like that better — View( Controller) for all crazy iOS developers out there...

Notifications You must be signed in to change notification settings

exalted/PTImageAlbumViewController

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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.

A nice image scrubber, just like in Photos.app by Apple on the iPad. 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!

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

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

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

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

Flip from one image to another with multi–touch gestures you already know and love. 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.

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

Sample Code

  1. Create a new subclass of PTImageAlbumViewController, say YourAwesomeViewController
  2. 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

About

"Image Album" — or "Photo Album" if you like that better — View( Controller) for all crazy iOS developers out there...

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published