Skip to content

northwind/FlyImage

Folders and files

NameName
Last commit message
Last commit date
Sep 27, 2016
Sep 20, 2017
Jul 24, 2017
Jul 20, 2017
Jul 24, 2017
Sep 27, 2016
Aug 23, 2016
Jul 24, 2017
Aug 24, 2016
Jul 24, 2017
Aug 23, 2016
Jul 24, 2017
Aug 24, 2016

Repository files navigation

FlyImage Logo FlyImage

Build Status Pod Version Pod Platform Pod License Carthage compatible

FlyImage takes the advantages of SDWebImage, FastImageCache and AFNetworking, is a simple and high performance image library.

Features:

  • High Performance, reduce memory operations while rendering, avoid Memory warning caused by image
  • Store and retrieve different size of small images in one memory file, smooth scrolling
  • Simple, support UIImageView, CALayer category
  • An asynchronous image downloader
  • Support WebP format
  • Support mmap to improve I/O performace

Installation with CocoaPods

Set the Podfile like this:

platform :ios, '8.0'
pod 'FlyImage', '~>1.0'

If you are using Swift, be sure to add use_frameworks!:

platform :ios, '8.0'
use_frameworks!
pod 'FlyImage', '~>1.0'

If you want to support WebP, just change the Podfile:

platform :ios, '8.0'
pod 'FlyImage/WebP', '~>1.0'

How To Use

Using UIImageView and CALayer Category

#import "FlyImage.h"
...

UIImageView *imageView = [[UIImageView alloc] initWithFrame:frame];
[imageView setPlaceHolderImageName:@"default"
						thumbnailURL:[NSURL urlWithString:@"http://thumbnail"]
						originalURL:[NSURL urlWithString:@"http://original"]];
[]self.view addSubview:imageView];
...

UIImageView *iconView = [[UIImageView alloc] initWithFrame:frame];
[iconView setIconURL:[NSURL urlWithString:@"http://original"]];
[]self.view addSubview:iconView];
...

Using FlyImageCache

// retrieve a specific key, and get callback
[[FlyImageCache sharedInstance] asyncGetImageWithKey:key
	  									   completed:^(NSString *key, UIImage *image) {
		imageView.image = image;
}];

// remove a image from the cache	
[[FlyImageCache sharedInstance] removeImageWithKey:key];

// delete all images
[[FlyImageCache sharedInstance] purge];

Using FlyImageIconCache

// add a new icon with a specific key
[[FlyImageIconCache sharedInstance] addImageWithKey:key
        size:drawSize
        drawingBlock:^(CGContextRef context, CGRect contextBounds) {
        	UIImage *image = [UIImage imageWithName:@"imageName"];

    		UIGraphicsPushContext(context);
		    [image drawInRect:contextBounds];
		    UIGraphicsPopContext();
        }
        completed:nil];

// retrieve a specific key, and get callback
[[FlyImageCache sharedInstance] asyncGetImageWithKey:key
	  									   completed:^(NSString *key, UIImage *image) {
		imageView.image = image;
}];

More demos in folder Examples

Performance Mesure

Memory when scrolling images

Demo Target: FlyImageView / Device: iPhone6 Plus

Memory FlyImage SDWebImage UIKit
All Heap Allocations 2~7M 2~4M 2~5M
All Anonymous VM 17~30M 310M 17~30M

FPS when more than 170 small images in the same screen

Demo Target: FlyImageIconView / Device: iPhone6 Plus

FlyImage SDWebImage UIKit
58~60FPS 6~7FPS 6~7FPS

FPS

Architecture

FlyImage Struct

License

FlyImage is made available under the MIT license