Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JaviSoto/JSAnimatedImagesView
UIView subclass to easily add a cool animated photo carrusel to your iOS app
https://github.com/JaviSoto/JSAnimatedImagesView
Last synced: about 1 month ago
JSON representation
UIView subclass to easily add a cool animated photo carrusel to your iOS app
- Host: GitHub
- URL: https://github.com/JaviSoto/JSAnimatedImagesView
- Owner: JaviSoto
- License: mit
- Created: 2012-02-15T11:03:00.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2015-11-09T17:15:01.000Z (about 9 years ago)
- Last Synced: 2024-10-26T21:33:33.077Z (about 2 months ago)
- Language: Objective-C
- Homepage: http://javisoto.github.com/JSAnimatedImagesView/
- Size: 1.31 MB
- Stars: 408
- Watchers: 22
- Forks: 57
- Open Issues: 0
-
Metadata Files:
- Readme: README.markdown
- License: LICENSE
Awesome Lists containing this project
- awesome - JSAnimatedImagesView - UIView subclass to easily add a cool animated photo carrusel to your iOS app (etc)
- awesome - JSAnimatedImagesView - UIView subclass to easily add a cool animated photo carrusel to your iOS app (etc)
README
## 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:
http://jsoto.es/xmKcLb
## Usage
- Using [CocoaPods](http://cocoapods.org/):
- Add `pod 'JSAnimatedImagesView', '~> 1.0.'` to your `Podfile`.
- You're done!
-- or --
- Clone the repository:
```bash
$ git clone [email protected]:JaviSoto/JSAnimatedImagesView.git
```
- Update the submodules:
```bash
$ 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):
```objc
self.animatedImagesView.dataSource = self;
```
- Implement the data source methods:
```objectivec
@interface MyViewController () // Conform to the protocol
@end
```
```objc
@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
```objc
@property (nonatomic, assign) NSTimeInterval timePerImage;
```
Specifies the time each image is viewed until the next image is faded in.
```objc
@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)
+ http://www.flickr.com/photos/blmiers2/
+ http://www.flickr.com/photos/niamor/
+ http://www.flickr.com/photos/macieklew/
## License
`JSAnimatedImagesView` is available under the MIT license. See the LICENSE file for more info.