-
Notifications
You must be signed in to change notification settings - Fork 0
/
FLAnimatedImage.h
executable file
·156 lines (123 loc) · 7.47 KB
/
FLAnimatedImage.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
//
// FLAnimatedImage.h
// Flipboard
//
// Created by Raphael Schaad on 7/8/13.
// Copyright (c) 2013-2015 Flipboard. All rights reserved.
//
#import <UIKit/UIKit.h>
// Allow user classes conveniently just importing one header.
#import "FLAnimatedImageView.h"
#if defined(DEBUG) && DEBUG
@protocol FLAnimatedImageDebugDelegate;
#endif
// Logging
// If set to 0, disables integration with CocoaLumberjack Logger (only matters if CocoaLumberjack is installed).
#ifndef FLLumberjackIntegrationEnabled
#define FLLumberjackIntegrationEnabled 1
#endif
// If set to 1, enables NSLog logging (only matters #if DEBUG -- never for release builds).
#ifndef FLDebugLoggingEnabled
#define FLDebugLoggingEnabled 0
#endif
#ifndef NS_DESIGNATED_INITIALIZER
#if __has_attribute(objc_designated_initializer)
#define NS_DESIGNATED_INITIALIZER __attribute((objc_designated_initializer))
#else
#define NS_DESIGNATED_INITIALIZER
#endif
#endif
//
// An `FLAnimatedImage`'s job is to deliver frames in a highly performant way and works in conjunction with `FLAnimatedImageView`.
// It subclasses `NSObject` and not `UIImage` because it's only an "image" in the sense that a sea lion is a lion.
// 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.
// Note: `posterImage`, `size`, `loopCount`, `delayTimes` and `frameCount` don't change after successful initialization.
//
@interface FLAnimatedImage : NSObject
@property (nonatomic, strong, readonly) UIImage *posterImage; // Guaranteed to be loaded; usually equivalent to `-imageLazilyCachedAtIndex:0`
@property (nonatomic, assign, readonly) CGSize size; // The `.posterImage`'s `.size`
@property (nonatomic, assign, readonly) NSUInteger loopCount; // 0 means repeating the animation indefinitely
@property (nonatomic, strong, readonly) NSArray *delayTimes; // Of type `NSTimeInterval` boxed in `NSNumber`s
@property (nonatomic, assign, readonly) NSUInteger frameCount; // Number of valid frames; equal to `[.delayTimes count]`
@property (nonatomic, assign, readonly) NSUInteger frameCacheSizeCurrent; // Current size of intelligently chosen buffer window; can range in the interval [1..frameCount]
@property (nonatomic, assign) NSUInteger frameCacheSizeMax; // Allow to cap the cache size; 0 means no specific limit (default)
// Intended to be called from main thread synchronously; will return immediately.
// If the result isn't cached, will return `nil`; the caller should then pause playback, not increment frame counter and keep polling.
// After an initial loading time, depending on `frameCacheSize`, frames should be available immediately from the cache.
- (UIImage *)imageLazilyCachedAtIndex:(NSUInteger)index;
// Pass either a `UIImage` or an `FLAnimatedImage` and get back its size
+ (CGSize)sizeForImage:(id)image;
// On success, the initializers return an `FLAnimatedImage` with all fields initialized, on failure they return `nil` and an error will be logged.
- (instancetype)initWithAnimatedGIFData:(NSData *)data NS_DESIGNATED_INITIALIZER;
+ (instancetype)animatedImageWithGIFData:(NSData *)data;
@property (nonatomic, strong, readonly) NSData *data; // The data the receiver was initialized with; read-only
#if defined(DEBUG) && DEBUG
// Only intended to report internal state for debugging
@property (nonatomic, weak) id<FLAnimatedImageDebugDelegate> debug_delegate;
@property (nonatomic, strong) NSMutableDictionary *debug_info; // To track arbitrary data (e.g. original URL, loading durations, cache hits, etc.)
#endif
@end
@interface FLWeakProxy : NSProxy
+ (instancetype)weakProxyForObject:(id)targetObject;
@end
#if defined(DEBUG) && DEBUG
@protocol FLAnimatedImageDebugDelegate <NSObject>
@optional
- (void)debug_animatedImage:(FLAnimatedImage *)animatedImage didUpdateCachedFrames:(NSIndexSet *)indexesOfFramesInCache;
- (void)debug_animatedImage:(FLAnimatedImage *)animatedImage didRequestCachedFrame:(NSUInteger)index;
- (CGFloat)debug_animatedImagePredrawingSlowdownFactor:(FLAnimatedImage *)animatedImage;
@end
#endif
// Try to detect and import CocoaLumberjack in all scenarious (library versions, way of including it, CocoaPods versions, etc.).
#if FLLumberjackIntegrationEnabled
#if defined(__has_include)
#if __has_include("<CocoaLumberjack/CocoaLumberjack.h>")
#import <CocoaLumberjack/CocoaLumberjack.h>
#elif __has_include("CocoaLumberjack.h")
#import "CocoaLumberjack.h"
#elif __has_include("<CocoaLumberjack/DDLog.h>")
#import <CocoaLumberjack/DDLog.h>
#elif __has_include("DDLog.h")
#import "DDLog.h"
#endif
#elif defined(COCOAPODS_POD_AVAILABLE_CocoaLumberjack) || defined(__POD_CocoaLumberjack)
#if COCOAPODS_VERSION_MAJOR_CocoaLumberjack == 2
#import <CocoaLumberjack/CocoaLumberjack.h>
#else
#import <CocoaLumberjack/DDLog.h>
#endif
#endif
#if defined(DDLogError) && defined(DDLogWarn) && defined(DDLogInfo) && defined(DDLogDebug) && defined(DDLogVerbose)
#define FLLumberjackAvailable
#endif
#endif
#if FLLumberjackIntegrationEnabled && defined(FLLumberjackAvailable)
// Use a custom, global (not per-file) log level for this library.
extern int flAnimatedImageLogLevel;
#if defined(LOG_OBJC_MAYBE) // CocoaLumberjack 1.x
#define FLLogError(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_ERROR, flAnimatedImageLogLevel, LOG_FLAG_ERROR, 0, frmt, ##__VA_ARGS__)
#define FLLogWarn(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_WARN, flAnimatedImageLogLevel, LOG_FLAG_WARN, 0, frmt, ##__VA_ARGS__)
#define FLLogInfo(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_INFO, flAnimatedImageLogLevel, LOG_FLAG_INFO, 0, frmt, ##__VA_ARGS__)
#define FLLogDebug(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_DEBUG, flAnimatedImageLogLevel, LOG_FLAG_DEBUG, 0, frmt, ##__VA_ARGS__)
#define FLLogVerbose(frmt, ...) LOG_OBJC_MAYBE(LOG_ASYNC_VERBOSE, flAnimatedImageLogLevel, LOG_FLAG_VERBOSE, 0, frmt, ##__VA_ARGS__)
#else // CocoaLumberjack 2.x
#define FLLogError(frmt, ...) LOG_MAYBE(NO, flAnimatedImageLogLevel, DDLogFlagError, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
#define FLLogWarn(frmt, ...) LOG_MAYBE(LOG_ASYNC_ENABLED, flAnimatedImageLogLevel, DDLogFlagWarning, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
#define FLLogInfo(frmt, ...) LOG_MAYBE(LOG_ASYNC_ENABLED, flAnimatedImageLogLevel, DDLogFlagInfo, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
#define FLLogDebug(frmt, ...) LOG_MAYBE(LOG_ASYNC_ENABLED, flAnimatedImageLogLevel, DDLogFlagDebug, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
#define FLLogVerbose(frmt, ...) LOG_MAYBE(LOG_ASYNC_ENABLED, flAnimatedImageLogLevel, DDLogFlagVerbose, 0, nil, __PRETTY_FUNCTION__, frmt, ##__VA_ARGS__)
#endif
#else
#if FLDebugLoggingEnabled && DEBUG
// CocoaLumberjack is disabled or not available, but we want to fallback to regular logging (debug builds only).
#define FLLog(...) NSLog(__VA_ARGS__)
#else
// No logging at all.
#define FLLog(...) ((void)0)
#endif
#define FLLogError(...) FLLog(__VA_ARGS__)
#define FLLogWarn(...) FLLog(__VA_ARGS__)
#define FLLogInfo(...) FLLog(__VA_ARGS__)
#define FLLogDebug(...) FLLog(__VA_ARGS__)
#define FLLogVerbose(...) FLLog(__VA_ARGS__)
#endif