Skip to content

JaviSoto/JSAnimatedImagesView

Folders and files

NameName
Last commit message
Last commit date

Latest commit

38870ab · Nov 9, 2015

History

41 Commits
Jul 12, 2013
Jul 12, 2013
Feb 15, 2012
Jul 12, 2013
Sep 16, 2014
Nov 7, 2015
Nov 7, 2015
Jul 12, 2013
Jul 12, 2013

Repository files navigation

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 [email protected]: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.