Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

UIView subclass to easily add a cool animated photo carrusel to your iOS app

branch: master
README.markdown

Description:

Easy to use UIView subclass to quickly add a cool animated carrousel of pictures to your app.

Documentation: http://cocoadocs.org/docsets/JSAnimatedImagesView/

Sample:

Video

http://jsoto.es/xmKcLb

Usage

  • Using CocoaPods:
  • Add pod 'JSAnimatedImagesView', '~> 1.0.' to your Podfile.
  • You're done!

-- or --

  • Clone the repository:
$ git clone git@github.com:JaviSoto/JSAnimatedImagesView.git
  • Update the submodules:
$ git submodule update --init
  • Check out the sample project.
  • Drag the two files JSAnimatedImagesView.(h/m) onto your project.
  • Drag Dependencies/MSWeakTimer/MSWeakTimer.(h/m) onto your project.
  • Include the header file JSAnimatedImagesView.h into the controller where you want to use it.
  • Create a JSAnimatedImagesView instance either via code, or in interface builder (by creating a UIView and changing its class to JSAnimatedImagesView).
  • Set the data source property on the view (probably on the viewDidLoad method):
self.animatedImagesView.dataSource = self;
  • Implement the data source methods:
@interface MyViewController () <JSAnimatedImagesViewDataSource> // Conform to the protocol

@end
@implementation MyViewController

- (NSUInteger)animatedImagesNumberOfImages:(JSAnimatedImagesView *)animatedImagesView
{
    return self.myImageNames.count;
}

- (UIImage *)animatedImagesView:(JSAnimatedImagesView *)animatedImagesView imageAtIndex:(NSUInteger)index
{
    return [UIImage imageNamed:[self.myImageNames objectAtIndex:index]];
}

@end

Configuration

@property (nonatomic, assign) NSTimeInterval timePerImage;

Specifies the time each image is viewed until the next image is faded in.

@property (nonatomic, assign) NSTimeInterval transitionDuration;

Specifies the duration of the transition (fade-out/fade-in) animation.

Compatibility

  • JSAnimatedImagesView is compatible with iOS5.0+
  • JSAnimatedImagesView requires ARC.

Attributions (Creative Commons Images)

License

JSAnimatedImagesView is available under the MIT license. See the LICENSE file for more info.

Something went wrong with that request. Please try again.