Initial commit with the implementation of AVAssetImageGenerator

Author: dreampiggy

.gitignore

@@ -23,9 +23,7 @@ DerivedData
 .bundle
 
 # Add this line if you want to avoid checking in source code from Carthage dependencies.
-# Carthage/Checkouts
-
-Carthage/Build
+Carthage/
 
 # We recommend against adding the Pods directory to your .gitignore. However
 # you should judge for yourself, the pros and cons are mentioned at:
@@ -34,4 +32,4 @@ Carthage/Build
 # Note: if you ignore the Pods directory, make sure to uncomment
 # `pod install` in .travis.yml
 #
-# Pods/
+Pods/

Cartfile

@@ -0,0 +1 @@
+github "SDWebImage/SDWebImage" ~> 5.3

Cartfile.resolved

@@ -0,0 +1 @@
+github "SDWebImage/SDWebImage" "5.3.1"

Example/Podfile.lock

@@ -0,0 +1,25 @@
+PODS:
+  - SDWebImage (5.3.1):
+    - SDWebImage/Core (= 5.3.1)
+  - SDWebImage/Core (5.3.1)
+  - SDWebImageVideoCoder (0.1.0):
+    - SDWebImage (~> 5.3)
+
+DEPENDENCIES:
+  - SDWebImageVideoCoder (from `../`)
+
+SPEC REPOS:
+  trunk:
+    - SDWebImage
+
+EXTERNAL SOURCES:
+  SDWebImageVideoCoder:
+    :path: "../"
+
+SPEC CHECKSUMS:
+  SDWebImage: 7137d57385fb632129838c1e6ab9528a22c666cc
+  SDWebImageVideoCoder: e60bfc97d644f6fafe3f16c3eafc4c626d55e962
+
+PODFILE CHECKSUM: f74263dcdd6f9f9df152726d6934aca467cf2b39
+
+COCOAPODS: 1.8.4

Example/SDWebImageVideoCoder.xcodeproj/project.pbxproj

@@ -346,10 +346,12 @@
 			);
 			inputPaths = (
 				"${PODS_ROOT}/Target Support Files/Pods-SDWebImageVideoCoder_Example/Pods-SDWebImageVideoCoder_Example-frameworks.sh",
+				"${BUILT_PRODUCTS_DIR}/SDWebImage/SDWebImage.framework",
 				"${BUILT_PRODUCTS_DIR}/SDWebImageVideoCoder/SDWebImageVideoCoder.framework",
 			);
 			name = "[CP] Embed Pods Frameworks";
 			outputPaths = (
+				"${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/SDWebImage.framework",
 				"${TARGET_BUILD_DIR}/${FRAMEWORKS_FOLDER_PATH}/SDWebImageVideoCoder.framework",
 			);
 			runOnlyForDeploymentPostprocessing = 0;

Example/SDWebImageVideoCoder.xcworkspace/contents.xcworkspacedata

@@ -7,17 +7,40 @@
 //
 
 #import "SDViewController.h"
+#import <SDWebImage/SDWebImage.h>
+#import <SDWebImageVideoCoder/SDWebImageVideoCoder.h>
 
 @interface SDViewController ()
 
+@property (nonatomic, strong) SDAnimatedImageView *imageView;
+
 @end
 
 @implementation SDViewController
 
 - (void)viewDidLoad
 {
     [super viewDidLoad];
-	// Do any additional setup after loading the view, typically from a nib.
+    [SDImageCodersManager.sharedManager addCoder:SDImageVideoCoder.sharedCoder];
+    
+    self.imageView = [SDAnimatedImageView new];
+    self.imageView.contentMode = UIViewContentModeScaleAspectFit;
+    [self.view addSubview:self.imageView];
+    
+    NSURL *gifvURL = [NSURL URLWithString:@"https://i.imgur.com/FY1AbSo.mp4"];
+    
+    [self.imageView sd_setImageWithURL:gifvURL completed:^(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL) {
+        if (image) {
+            NSLog(@"GIFV load success");
+        } else {
+            NSLog(@"Error: %@", error);
+        }
+    }];
+}
+
+- (void)viewDidLayoutSubviews {
+    [super viewDidLayoutSubviews];
+    self.imageView.frame = self.view.bounds;
 }
 
 - (void)didReceiveMemoryWarning

Example/SDWebImageVideoCoder/SDViewController.m

@@ -5,12 +5,26 @@
 [![License](https://img.shields.io/cocoapods/l/SDWebImageVideoCoder.svg?style=flat)](https://cocoapods.org/pods/SDWebImageVideoCoder)
 [![Platform](https://img.shields.io/cocoapods/p/SDWebImageVideoCoder.svg?style=flat)](https://cocoapods.org/pods/SDWebImageVideoCoder)
 
-## Example
+## What's for
 
-To run the example project, clone the repo, and run `pod install` from the Example directory first.
+This is just a toy coder plugin for [SDWebImage](https://github.com/SDWebImage). Which aim to provide a demo usage that how SDWeImage combined the Animated Image View and Player and let it works for generic usage and customization.
+
+**Important**: This project is just a toy, which means, it does not provide any production ready features, and the performances is really slow.
+
+For real world rendering for small video files (like [Imgur's GIFV format](https://help.imgur.com/hc/en-us/articles/208606616-What-is-GIFV-)). You should always prefers to use the video player and rendering components, like AVKit's [AVPlayerViewController](https://developer.apple.com/documentation/avkit/avplayerviewcontroller) .
+
+This coder plugin, provide the animation loading support for video format, including:
+
++ MP4 (MPEG/4)
++ MOV (QuickTime Movie)
++ AVI (Audio Video Interleave)
 
 ## Requirements
 
++ iOS 8+
++ macOS 10.10+
++ tvOS 9+
+
 ## Installation
 
 SDWebImageVideoCoder is available through [CocoaPods](https://cocoapods.org). To install
@@ -20,9 +34,78 @@ it, simply add the following line to your Podfile:
 pod 'SDWebImageVideoCoder'
 ```
 
+## Usage
+
+### Load Video URL
+
+For coder plugin usage, see [Wiki - Coder Usage](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#coder-usage)
+
++ Objective-C
+
+```objective-c
+SDAnimatedImageView *imageView;
+NSURL *videoURL = [NSURL URLWithString:@"https://i.imgur.com/FY1AbSo.mp4"]; 
+[imageView sd_setImageWithURL:videoURL];
+```
+
++ Swift
+
+```swift
+let imageView: SDAnimatedImageView
+let url = URL(string: "https://i.imgur.com/FY1AbSo.mp4")
+imageView.sd_setImage(url: url)
+```
+
+### AVAsset player usage
+
+For player usage, see [Wiki - Animated Image Player](https://github.com/SDWebImage/SDWebImage/wiki/Advanced-Usage#animated-player-530)
+
++ Objective-C
+
+```objective-c
+// AVAsset
+AVAsset *asset;
+AVAssetImageGenerator *generator = [AVAssetImageGenerator assetImageGeneratorWithAsset:asset];
+generator.appliesPreferredTrackTransform = YES;
+generator.requestedTimeToleranceBefore = kCMTimeZero;
+generator.requestedTimeToleranceAfter = kCMTimeZero;
+// Player
+SDAnimatedImagePlayer *player = [SDAnimatedImagePlayer playerWithProvider:generator];
+player.animationFrameHandler = ^(NSUInteger index, UIImage * frame) {
+    // frames
+};
+[player seekToFrameAtIndex:5 loopCount:0];
+[player play];
+```
+
++ Swift
+
+```swift
+let asset: AVAsset
+let generator = AVAssetImageGenerator(asset: asset)
+generator.appliesPreferredTrackTransform = true
+generator.requestedTimeToleranceBefore = .zero
+generator.requestedTimeToleranceAfter = .zero
+// Player
+let player = SDAnimatedImagePlayer(provider: generator)
+player.animationFrameHandler = { (index, frame) in 
+    // frames
+}
+player.seekToFrame(at: 5, loopCount: 0)
+player.play()
+```
+
+## Example
+
+To run the example project, clone the repo, and run `pod install` from the Example directory first.
+
+<img src="https://raw.githubusercontent.com/SDWebImage/SDWebImageVideoCoder/master/Example/Screenshot/MP4Demo.png" width="600" />
+
+These MP4 video is from [Imgur](https://imgur.com/).
+
 ## Author
 
-lizhuoli1126@126.com, lizhuoli1126@126.com
+DreamPiggy, lizhuoli1126@126.com
 
 ## License
 

Example/Screenshot/MP4Demo.png

@@ -21,22 +21,15 @@ Pod::Spec.new do |s|
 TODO: Add long description of the pod here.
                        DESC
 
-  s.homepage         = 'https://github.com/lizhuoli1126@126.com/SDWebImageVideoCoder'
-  # s.screenshots     = 'www.example.com/screenshots_1', 'www.example.com/screenshots_2'
+  s.homepage         = 'https://github.com/SDWebImage/SDWebImageVideoCoder'
   s.license          = { :type => 'MIT', :file => 'LICENSE' }
-  s.author           = { 'lizhuoli1126@126.com' => 'lizhuoli1126@126.com' }
-  s.source           = { :git => 'https://github.com/lizhuoli1126@126.com/SDWebImageVideoCoder.git', :tag => s.version.to_s }
-  # s.social_media_url = 'https://twitter.com/<TWITTER_USERNAME>'
+  s.author           = { 'DreamPiggy' => 'lizhuoli1126@126.com' }
+  s.source           = { :git => 'https://github.com/SDWebImage/SDWebImageVideoCoder.git', :tag => s.version.to_s }
 
   s.ios.deployment_target = '8.0'
+  s.osx.deployment_target = '10.10'
+  s.tvos.deployment_target = '9.0'
 
-  s.source_files = 'SDWebImageVideoCoder/Classes/**/*'
-  
-  # s.resource_bundles = {
-  #   'SDWebImageVideoCoder' => ['SDWebImageVideoCoder/Assets/*.png']
-  # }
-
-  # s.public_header_files = 'Pod/Classes/**/*.h'
-  # s.frameworks = 'UIKit', 'MapKit'
-  # s.dependency 'AFNetworking', '~> 2.3'
+  s.source_files = 'SDWebImageVideoCoder/Classes/**/*', 'SDWebImageVideoCoder/Module/SDWebImageVideoCoder.h'
+  s.dependency 'SDWebImage', '~> 5.3'
 end