|
| 1 | +// |
| 2 | +// FLAnimatedImage.h |
| 3 | +// Flipboard |
| 4 | +// |
| 5 | +// Created by Raphael Schaad on 7/8/13. |
| 6 | +// Copyright (c) 2013-2015 Flipboard. All rights reserved. |
| 7 | +// |
| 8 | + |
| 9 | + |
| 10 | +#import <UIKit/UIKit.h> |
| 11 | + |
| 12 | +// Allow user classes conveniently just importing one header. |
| 13 | +#import "FLAnimatedImageView.h" |
| 14 | + |
| 15 | + |
| 16 | +#ifndef NS_DESIGNATED_INITIALIZER |
| 17 | + #if __has_attribute(objc_designated_initializer) |
| 18 | + #define NS_DESIGNATED_INITIALIZER __attribute((objc_designated_initializer)) |
| 19 | + #else |
| 20 | + #define NS_DESIGNATED_INITIALIZER |
| 21 | + #endif |
| 22 | +#endif |
| 23 | + |
| 24 | +extern const NSTimeInterval kFLAnimatedImageDelayTimeIntervalMinimum; |
| 25 | + |
| 26 | +// |
| 27 | +// An `FLAnimatedImage`'s job is to deliver frames in a highly performant way and works in conjunction with `FLAnimatedImageView`. |
| 28 | +// It subclasses `NSObject` and not `UIImage` because it's only an "image" in the sense that a sea lion is a lion. |
| 29 | +// It tries to intelligently choose the frame cache size depending on the image and memory situation with the goal to lower CPU usage for smaller ones, lower memory usage for larger ones and always deliver frames for high performant play-back. |
| 30 | +// Note: `posterImage`, `size`, `loopCount`, `delayTimes` and `frameCount` don't change after successful initialization. |
| 31 | +// |
| 32 | +@interface FLAnimatedImage : NSObject |
| 33 | + |
| 34 | +@property (nonatomic, strong, readonly) UIImage *posterImage; // Guaranteed to be loaded; usually equivalent to `-imageLazilyCachedAtIndex:0` |
| 35 | +@property (nonatomic, assign, readonly) CGSize size; // The `.posterImage`'s `.size` |
| 36 | + |
| 37 | +@property (nonatomic, assign, readonly) NSUInteger loopCount; // 0 means repeating the animation indefinitely |
| 38 | +@property (nonatomic, strong, readonly) NSDictionary *delayTimesForIndexes; // Of type `NSTimeInterval` boxed in `NSNumber`s |
| 39 | +@property (nonatomic, assign, readonly) NSUInteger frameCount; // Number of valid frames; equal to `[.delayTimes count]` |
| 40 | + |
| 41 | +@property (nonatomic, assign, readonly) NSUInteger frameCacheSizeCurrent; // Current size of intelligently chosen buffer window; can range in the interval [1..frameCount] |
| 42 | +@property (nonatomic, assign) NSUInteger frameCacheSizeMax; // Allow to cap the cache size; 0 means no specific limit (default) |
| 43 | + |
| 44 | +// Intended to be called from main thread synchronously; will return immediately. |
| 45 | +// If the result isn't cached, will return `nil`; the caller should then pause playback, not increment frame counter and keep polling. |
| 46 | +// After an initial loading time, depending on `frameCacheSize`, frames should be available immediately from the cache. |
| 47 | +- (UIImage *)imageLazilyCachedAtIndex:(NSUInteger)index; |
| 48 | + |
| 49 | +// Pass either a `UIImage` or an `FLAnimatedImage` and get back its size |
| 50 | ++ (CGSize)sizeForImage:(id)image; |
| 51 | + |
| 52 | +// On success, the initializers return an `FLAnimatedImage` with all fields initialized, on failure they return `nil` and an error will be logged. |
| 53 | +- (instancetype)initWithAnimatedGIFData:(NSData *)data; |
| 54 | +// Pass 0 for optimalFrameCacheSize to get the default, predrawing is enabled by default. |
| 55 | +- (instancetype)initWithAnimatedGIFData:(NSData *)data optimalFrameCacheSize:(NSUInteger)optimalFrameCacheSize predrawingEnabled:(BOOL)isPredrawingEnabled NS_DESIGNATED_INITIALIZER; |
| 56 | ++ (instancetype)animatedImageWithGIFData:(NSData *)data; |
| 57 | + |
| 58 | +@property (nonatomic, strong, readonly) NSData *data; // The data the receiver was initialized with; read-only |
| 59 | + |
| 60 | +@end |
| 61 | + |
| 62 | +typedef NS_ENUM(NSUInteger, FLLogLevel) { |
| 63 | + FLLogLevelNone = 0, |
| 64 | + FLLogLevelError, |
| 65 | + FLLogLevelWarn, |
| 66 | + FLLogLevelInfo, |
| 67 | + FLLogLevelDebug, |
| 68 | + FLLogLevelVerbose |
| 69 | +}; |
| 70 | + |
| 71 | +@interface FLAnimatedImage (Logging) |
| 72 | + |
| 73 | ++ (void)setLogBlock:(void (^)(NSString *logString, FLLogLevel logLevel))logBlock logLevel:(FLLogLevel)logLevel; |
| 74 | ++ (void)logStringFromBlock:(NSString *(^)(void))stringBlock withLevel:(FLLogLevel)level; |
| 75 | + |
| 76 | +@end |
| 77 | + |
| 78 | +#define FLLog(logLevel, format, ...) [FLAnimatedImage logStringFromBlock:^NSString *{ return [NSString stringWithFormat:(format), ## __VA_ARGS__]; } withLevel:(logLevel)] |
| 79 | + |
| 80 | +@interface FLWeakProxy : NSProxy |
| 81 | + |
| 82 | ++ (instancetype)weakProxyForObject:(id)targetObject; |
| 83 | + |
| 84 | +@end |
0 commit comments