Latest 1.1
Homepage https://github.com/northwind/FlyImage
License MIT
Platforms ios 8.0, requires ARC
Dependencies AFNetworking
Frameworks ImageIO, UIKit
Authors

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

Latest podspec

{
    "name": "FlyImage",
    "version": "1.1",
    "summary": "Download, cache, render small images with UIImageView category",
    "description": "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;",
    "homepage": "https://github.com/northwind/FlyImage",
    "license": "MIT",
    "authors": {
        "norristong": "[email protected]"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/northwind/FlyImage.git",
        "tag": "1.1"
    },
    "source_files": [
        "FlyImage",
        "FlyImage/**/*.{h,m}"
    ],
    "frameworks": [
        "ImageIO",
        "UIKit"
    ],
    "requires_arc": true,
    "dependencies": {
        "AFNetworking": [
            "~> 3.1"
        ]
    },
    "default_subspecs": "Core",
    "subspecs": [
        {
            "name": "Core",
            "source_files": [
                "FlyImage",
                "FlyImage/**/*.{h,m}"
            ]
        },
        {
            "name": "WebP",
            "xcconfig": {
                "GCC_PREPROCESSOR_DEFINITIONS": "$(inherited) FLYIMAGE_WEBP=1",
                "USER_HEADER_SEARCH_PATHS": "$(inherited) $(SRCROOT)/libwebp/src"
            },
            "watchos": {
                "xcconfig": {
                    "GCC_PREPROCESSOR_DEFINITIONS": "$(inherited) FLYIMAGE_WEBP=1",
                    "USER_HEADER_SEARCH_PATHS": "$(inherited) $(SRCROOT)/libwebp/src"
                }
            },
            "dependencies": {
                "FlyImage/Core": [],
                "libwebp": []
            }
        }
    ]
}

Pin It on Pinterest

Share This