UIView subclass to easily add a cool animated photo carrusel to your iOS app
Objective-C Ruby
Latest commit 38870ab Nov 9, 2015 @JaviSoto Merge pull request #8 from fkuehne/featurebranch
Add tvOS support and fix compilation warning

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.