Add the maxFramePerSecond and maxFrameSize API

Author: dreampiggy

Diff for: Example/SDWebImageVideoCoder/SDViewController.m

@@ -27,7 +27,7 @@ - (void)viewDidLoad
     self.imageView.contentMode = UIViewContentModeScaleAspectFit;
     [self.view addSubview:self.imageView];
 
-    NSURL *gifvURL = [NSURL URLWithString:@"https://i.imgur.com/FY1AbSo.mp4"];
+    NSURL *gifvURL = [NSURL URLWithString:@"https://imgur.com/download/NL1CXAF/LEGO+my+pizza"];
 
     [self.imageView sd_setImageWithURL:gifvURL completed:^(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL) {
         if (image) {

Diff for: SDWebImageVideoCoder/Classes/AVAssetImageGenerator+SDAdditions.h

@@ -11,6 +11,12 @@
 
 @interface AVAssetImageGenerator (SDAdditions) <SDAnimatedImageProvider>
 
+/// The desired animation image FPS. By default it's the Video FPS, larger value will consume much more CPU (25 FPS may consume 200% CPU)
+@property (nonatomic, assign) NSTimeInterval sd_framePerSecond;
+
+/// Create a image generator with video data and desired format type
+/// @param data video data
+/// @param type video format type
 + (nullable instancetype)sd_assetImageGeneratorWithVideoData:(nonnull NSData *)data contentType:(nullable AVFileType)type;
 
 @end

Diff for: SDWebImageVideoCoder/Classes/AVAssetImageGenerator+SDAdditions.m

@@ -22,7 +22,6 @@ - (instancetype)initWithData:(NSData *)data contentType:(AVFileType)type;
 @interface AVAssetImageGenerator ()
 
 @property (nonatomic, strong) NSData *sd_videoData;
-@property (nonatomic, assign) NSTimeInterval sd_framePerSecond;
 
 @end
 

Diff for: SDWebImageVideoCoder/Classes/SDImageVideoCoder.h

@@ -8,8 +8,20 @@
 
 @import SDWebImage;
 
+/// A coder plugin which can play Video format, such as MP4/MOV.
+/// For normal image, it generate the poster thumb image of video.
+/// For animated image, it use the `AVAssetImageGenerator` to generate individual frames by times.
 @interface SDImageVideoCoder : NSObject <SDAnimatedImageCoder>
 
+/// The shared instance of this coder
 @property (nonatomic, class, readonly, nonnull) SDImageVideoCoder *sharedCoder;
 
+/// The maximum FPS for animated image playback. This can dramatically impact the performance.
+/// By default, this value set to 10, which means the frame duration is 0.1s.
+@property (nonatomic, assign) NSTimeInterval maxFramePerSecond;
+
+/// The maximum dimensions for the animated image playback. Zero specifies the asset’s unscaled dimensions.
+/// By default, this value set to Zero. You can limit the size to reduce CPU and memory usage.
+@property (nonatomic, assign) CGSize maxFrameSize;
+
 @end

Diff for: SDWebImageVideoCoder/Classes/SDImageVideoCoder.m

@@ -26,6 +26,15 @@ + (SDImageVideoCoder *)sharedCoder {
     return coder;
 }
 
+- (instancetype)init {
+    self = [super init];
+    if (self) {
+        self.maxFramePerSecond = 10;
+        self.maxFrameSize = CGSizeZero;
+    }
+    return self;
+}
+
 #pragma mark - Helper
 
 - (AVFileType)videoContentTypeWithData:(NSData *)data {
@@ -78,7 +87,7 @@ - (nullable NSData *)encodedDataWithImage:(nullable UIImage *)image format:(SDIm
 #pragma mark - SDAnimatedImageCoder
 
 - (nullable instancetype)initWithAnimatedImageData:(nullable NSData *)data options:(nullable SDImageCoderOptions *)options {
-    self = [super init];
+    self = [self init];
     if (self) {
         if (!data) {
             return nil;
@@ -88,6 +97,10 @@ - (nullable instancetype)initWithAnimatedImageData:(nullable NSData *)data optio
         if (!generator) {
             return nil;
         }
+        if (generator.sd_framePerSecond > self.maxFramePerSecond) {
+            generator.sd_framePerSecond = self.maxFramePerSecond;
+        }
+        generator.maximumSize = self.maxFrameSize;
         self.generator = generator;
     }
     return self;