@momo-kits/native-kits 0.0.1-beta.5 → 0.89.1-2

package/example/ios/Pods/SDWebImage/SDWebImage/Core/SDImageIOCoder.h

@@ -1,30 +0,0 @@
-/*
- * This file is part of the SDWebImage package.
- * (c) Olivier Poitrey <rs@dailymotion.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-
-#import <Foundation/Foundation.h>
-#import "SDImageCoder.h"
-
-/**
- Built in coder that supports PNG, JPEG, TIFF, includes support for progressive decoding.
- 
- GIF
- Also supports static GIF (meaning will only handle the 1st frame).
- For a full GIF support, we recommend `SDAnimatedImageView` to keep both CPU and memory balanced.
- 
- HEIC
- This coder also supports HEIC format because ImageIO supports it natively. But it depends on the system capabilities, so it won't work on all devices, see: https://devstreaming-cdn.apple.com/videos/wwdc/2017/511tj33587vdhds/511/511_working_with_heif_and_hevc.pdf
- Decode(Software): !Simulator && (iOS 11 || tvOS 11 || macOS 10.13)
- Decode(Hardware): !Simulator && ((iOS 11 && A9Chip) || (macOS 10.13 && 6thGenerationIntelCPU))
- Encode(Software): macOS 10.13
- Encode(Hardware): !Simulator && ((iOS 11 && A10FusionChip) || (macOS 10.13 && 6thGenerationIntelCPU))
- */
-@interface SDImageIOCoder : NSObject <SDProgressiveImageCoder>
-
-@property (nonatomic, class, readonly, nonnull) SDImageIOCoder *sharedCoder;
-
-@end

package/example/ios/Pods/SDWebImage/SDWebImage/Core/SDImageIOCoder.m

@@ -1,420 +0,0 @@
-/*
- * This file is part of the SDWebImage package.
- * (c) Olivier Poitrey <rs@dailymotion.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-
-#import "SDImageIOCoder.h"
-#import "SDImageCoderHelper.h"
-#import "NSImage+Compatibility.h"
-#import "UIImage+Metadata.h"
-#import "SDImageGraphics.h"
-#import "SDImageIOAnimatedCoderInternal.h"
-
-#import <ImageIO/ImageIO.h>
-#import <CoreServices/CoreServices.h>
-
-// Specify File Size for lossy format encoding, like JPEG
-static NSString * kSDCGImageDestinationRequestedFileSize = @"kCGImageDestinationRequestedFileSize";
-
-@implementation SDImageIOCoder {
-    size_t _width, _height;
-    CGImagePropertyOrientation _orientation;
-    CGImageSourceRef _imageSource;
-    CGFloat _scale;
-    BOOL _finished;
-    BOOL _preserveAspectRatio;
-    CGSize _thumbnailSize;
-    BOOL _lazyDecode;
-}
-
-- (void)dealloc {
-    if (_imageSource) {
-        CFRelease(_imageSource);
-        _imageSource = NULL;
-    }
-#if SD_UIKIT
-    [[NSNotificationCenter defaultCenter] removeObserver:self name:UIApplicationDidReceiveMemoryWarningNotification object:nil];
-#endif
-}
-
-- (void)didReceiveMemoryWarning:(NSNotification *)notification
-{
-    if (_imageSource) {
-        CGImageSourceRemoveCacheAtIndex(_imageSource, 0);
-    }
-}
-
-+ (instancetype)sharedCoder {
-    static SDImageIOCoder *coder;
-    static dispatch_once_t onceToken;
-    dispatch_once(&onceToken, ^{
-        coder = [[SDImageIOCoder alloc] init];
-    });
-    return coder;
-}
-
-#pragma mark - Bitmap PDF representation
-+ (UIImage *)createBitmapPDFWithData:(nonnull NSData *)data pageNumber:(NSUInteger)pageNumber targetSize:(CGSize)targetSize preserveAspectRatio:(BOOL)preserveAspectRatio {
-    NSParameterAssert(data);
-    UIImage *image;
-    
-    CGDataProviderRef provider = CGDataProviderCreateWithCFData((__bridge CFDataRef)data);
-    if (!provider) {
-        return nil;
-    }
-    CGPDFDocumentRef document = CGPDFDocumentCreateWithProvider(provider);
-    CGDataProviderRelease(provider);
-    if (!document) {
-        return nil;
-    }
-    
-    // `CGPDFDocumentGetPage` page number is 1-indexed.
-    CGPDFPageRef page = CGPDFDocumentGetPage(document, pageNumber + 1);
-    if (!page) {
-        CGPDFDocumentRelease(document);
-        return nil;
-    }
-    
-    CGPDFBox box = kCGPDFMediaBox;
-    CGRect rect = CGPDFPageGetBoxRect(page, box);
-    CGRect targetRect = rect;
-    if (!CGSizeEqualToSize(targetSize, CGSizeZero)) {
-        targetRect = CGRectMake(0, 0, targetSize.width, targetSize.height);
-    }
-    
-    CGFloat xRatio = targetRect.size.width / rect.size.width;
-    CGFloat yRatio = targetRect.size.height / rect.size.height;
-    CGFloat xScale = preserveAspectRatio ? MIN(xRatio, yRatio) : xRatio;
-    CGFloat yScale = preserveAspectRatio ? MIN(xRatio, yRatio) : yRatio;
-    
-    // `CGPDFPageGetDrawingTransform` will only scale down, but not scale up, so we need calculate the actual scale again
-    CGRect drawRect = CGRectMake( 0, 0, targetRect.size.width / xScale, targetRect.size.height / yScale);
-    CGAffineTransform scaleTransform = CGAffineTransformMakeScale(xScale, yScale);
-    CGAffineTransform transform = CGPDFPageGetDrawingTransform(page, box, drawRect, 0, preserveAspectRatio);
-    
-    SDGraphicsBeginImageContextWithOptions(targetRect.size, NO, 0);
-    CGContextRef context = SDGraphicsGetCurrentContext();
-    
-#if SD_UIKIT || SD_WATCH
-    // Core Graphics coordinate system use the bottom-left, UIKit use the flipped one
-    CGContextTranslateCTM(context, 0, targetRect.size.height);
-    CGContextScaleCTM(context, 1, -1);
-#endif
-    
-    CGContextConcatCTM(context, scaleTransform);
-    CGContextConcatCTM(context, transform);
-    
-    CGContextDrawPDFPage(context, page);
-    
-    image = SDGraphicsGetImageFromCurrentImageContext();
-    SDGraphicsEndImageContext();
-    
-    CGPDFDocumentRelease(document);
-    
-    return image;
-}
-
-#pragma mark - Decode
-- (BOOL)canDecodeFromData:(nullable NSData *)data {
-    return YES;
-}
-
-- (UIImage *)decodedImageWithData:(NSData *)data options:(nullable SDImageCoderOptions *)options {
-    if (!data) {
-        return nil;
-    }
-    CGFloat scale = 1;
-    NSNumber *scaleFactor = options[SDImageCoderDecodeScaleFactor];
-    if (scaleFactor != nil) {
-        scale = MAX([scaleFactor doubleValue], 1) ;
-    }
-    
-    CGSize thumbnailSize = CGSizeZero;
-    NSValue *thumbnailSizeValue = options[SDImageCoderDecodeThumbnailPixelSize];
-    if (thumbnailSizeValue != nil) {
-#if SD_MAC
-        thumbnailSize = thumbnailSizeValue.sizeValue;
-#else
-        thumbnailSize = thumbnailSizeValue.CGSizeValue;
-#endif
-    }
-    
-    BOOL preserveAspectRatio = YES;
-    NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
-    if (preserveAspectRatioValue != nil) {
-        preserveAspectRatio = preserveAspectRatioValue.boolValue;
-    }
-    
-    // Check vector format
-    if ([NSData sd_imageFormatForImageData:data] == SDImageFormatPDF) {
-        // History before iOS 16, ImageIO can decode PDF with rasterization size, but can't ever :(
-        // So, use CoreGraphics to decode PDF (copy code from SDWebImagePDFCoder, may do refactor in the future)
-        UIImage *image;
-        NSUInteger pageNumber = 0; // Still use first page, may added options is user want
-#if SD_MAC
-        // If don't use thumbnail, prefers the built-in generation of vector image
-        // macOS's `NSImage` supports PDF built-in rendering
-        if (thumbnailSize.width == 0 || thumbnailSize.height == 0) {
-            NSPDFImageRep *imageRep = [[NSPDFImageRep alloc] initWithData:data];
-            if (imageRep) {
-                imageRep.currentPage = pageNumber;
-                image = [[NSImage alloc] initWithSize:imageRep.size];
-                [image addRepresentation:imageRep];
-                image.sd_imageFormat = SDImageFormatPDF;
-                return image;
-            }
-        }
-#endif
-        image = [self.class createBitmapPDFWithData:data pageNumber:pageNumber targetSize:thumbnailSize preserveAspectRatio:preserveAspectRatio];
-        image.sd_imageFormat = SDImageFormatPDF;
-        return image;
-    }
-    
-    BOOL lazyDecode = YES; // Defaults YES for static image coder
-    NSNumber *lazyDecodeValue = options[SDImageCoderDecodeUseLazyDecoding];
-    if (lazyDecodeValue != nil) {
-        lazyDecode = lazyDecodeValue.boolValue;
-    }
-    
-    NSString *typeIdentifierHint = options[SDImageCoderDecodeTypeIdentifierHint];
-    if (!typeIdentifierHint) {
-        // Check file extension and convert to UTI, from: https://stackoverflow.com/questions/1506251/getting-an-uniform-type-identifier-for-a-given-extension
-        NSString *fileExtensionHint = options[SDImageCoderDecodeFileExtensionHint];
-        if (fileExtensionHint) {
-            typeIdentifierHint = (__bridge_transfer NSString *)UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, (__bridge CFStringRef)fileExtensionHint, kUTTypeImage);
-            // Ignore dynamic UTI
-            if (UTTypeIsDynamic((__bridge CFStringRef)typeIdentifierHint)) {
-                typeIdentifierHint = nil;
-            }
-        }
-    } else if ([typeIdentifierHint isEqual:NSNull.null]) {
-        // Hack if user don't want to imply file extension
-        typeIdentifierHint = nil;
-    }
-    
-    NSDictionary *creatingOptions = nil;
-    if (typeIdentifierHint) {
-        creatingOptions = @{(__bridge NSString *)kCGImageSourceTypeIdentifierHint : typeIdentifierHint};
-    }
-    CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)data, (__bridge CFDictionaryRef)creatingOptions);
-    if (!source) {
-        // Try again without UTType hint, the call site from user may provide the wrong UTType
-        source = CGImageSourceCreateWithData((__bridge CFDataRef)data, (__bridge CFDictionaryRef)creatingOptions);
-    }
-    if (!source) {
-        return nil;
-    }
-    
-    CFStringRef uttype = CGImageSourceGetType(source);
-    SDImageFormat imageFormat = [NSData sd_imageFormatFromUTType:uttype];
-    
-    UIImage *image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:source scale:scale preserveAspectRatio:preserveAspectRatio thumbnailSize:thumbnailSize lazyDecode:lazyDecode animatedImage:NO];
-    CFRelease(source);
-    
-    image.sd_imageFormat = imageFormat;
-    return image;
-}
-
-#pragma mark - Progressive Decode
-
-- (BOOL)canIncrementalDecodeFromData:(NSData *)data {
-    return [self canDecodeFromData:data];
-}
-
-- (instancetype)initIncrementalWithOptions:(nullable SDImageCoderOptions *)options {
-    self = [super init];
-    if (self) {
-        _imageSource = CGImageSourceCreateIncremental(NULL);
-        CGFloat scale = 1;
-        NSNumber *scaleFactor = options[SDImageCoderDecodeScaleFactor];
-        if (scaleFactor != nil) {
-            scale = MAX([scaleFactor doubleValue], 1);
-        }
-        _scale = scale;
-        CGSize thumbnailSize = CGSizeZero;
-        NSValue *thumbnailSizeValue = options[SDImageCoderDecodeThumbnailPixelSize];
-        if (thumbnailSizeValue != nil) {
-    #if SD_MAC
-            thumbnailSize = thumbnailSizeValue.sizeValue;
-    #else
-            thumbnailSize = thumbnailSizeValue.CGSizeValue;
-    #endif
-        }
-        _thumbnailSize = thumbnailSize;
-        BOOL preserveAspectRatio = YES;
-        NSNumber *preserveAspectRatioValue = options[SDImageCoderDecodePreserveAspectRatio];
-        if (preserveAspectRatioValue != nil) {
-            preserveAspectRatio = preserveAspectRatioValue.boolValue;
-        }
-        _preserveAspectRatio = preserveAspectRatio;
-        BOOL lazyDecode = YES; // Defaults YES for static image coder
-        NSNumber *lazyDecodeValue = options[SDImageCoderDecodeUseLazyDecoding];
-        if (lazyDecodeValue != nil) {
-            lazyDecode = lazyDecodeValue.boolValue;
-        }
-        _lazyDecode = lazyDecode;
-#if SD_UIKIT
-        [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(didReceiveMemoryWarning:) name:UIApplicationDidReceiveMemoryWarningNotification object:nil];
-#endif
-    }
-    return self;
-}
-
-- (void)updateIncrementalData:(NSData *)data finished:(BOOL)finished {
-    if (_finished) {
-        return;
-    }
-    _finished = finished;
-    
-    // The following code is from http://www.cocoaintheshell.com/2011/05/progressive-images-download-imageio/
-    // Thanks to the author @Nyx0uf
-    
-    // Update the data source, we must pass ALL the data, not just the new bytes
-    CGImageSourceUpdateData(_imageSource, (__bridge CFDataRef)data, finished);
-    
-    if (_width + _height == 0) {
-        CFDictionaryRef properties = CGImageSourceCopyPropertiesAtIndex(_imageSource, 0, NULL);
-        if (properties) {
-            NSInteger orientationValue = 1;
-            CFTypeRef val = CFDictionaryGetValue(properties, kCGImagePropertyPixelHeight);
-            if (val) CFNumberGetValue(val, kCFNumberLongType, &_height);
-            val = CFDictionaryGetValue(properties, kCGImagePropertyPixelWidth);
-            if (val) CFNumberGetValue(val, kCFNumberLongType, &_width);
-            val = CFDictionaryGetValue(properties, kCGImagePropertyOrientation);
-            if (val) CFNumberGetValue(val, kCFNumberNSIntegerType, &orientationValue);
-            CFRelease(properties);
-            
-            // When we draw to Core Graphics, we lose orientation information,
-            // which means the image below born of initWithCGIImage will be
-            // oriented incorrectly sometimes. (Unlike the image born of initWithData
-            // in didCompleteWithError.) So save it here and pass it on later.
-            _orientation = (CGImagePropertyOrientation)orientationValue;
-        }
-    }
-}
-
-- (UIImage *)incrementalDecodedImageWithOptions:(SDImageCoderOptions *)options {
-    UIImage *image;
-    
-    if (_width + _height > 0) {
-        // Create the image
-        CGFloat scale = _scale;
-        NSNumber *scaleFactor = options[SDImageCoderDecodeScaleFactor];
-        if (scaleFactor != nil) {
-            scale = MAX([scaleFactor doubleValue], 1);
-        }
-        image = [SDImageIOAnimatedCoder createFrameAtIndex:0 source:_imageSource scale:scale preserveAspectRatio:_preserveAspectRatio thumbnailSize:_thumbnailSize lazyDecode:_lazyDecode animatedImage:NO];
-        if (image) {
-            CFStringRef uttype = CGImageSourceGetType(_imageSource);
-            image.sd_imageFormat = [NSData sd_imageFormatFromUTType:uttype];
-        }
-    }
-    
-    return image;
-}
-
-#pragma mark - Encode
-- (BOOL)canEncodeToFormat:(SDImageFormat)format {
-    return YES;
-}
-
-- (NSData *)encodedDataWithImage:(UIImage *)image format:(SDImageFormat)format options:(nullable SDImageCoderOptions *)options {
-    if (!image) {
-        return nil;
-    }
-    CGImageRef imageRef = image.CGImage;
-    if (!imageRef) {
-        // Earily return, supports CGImage only
-        return nil;
-    }
-    
-    if (format == SDImageFormatUndefined) {
-        BOOL hasAlpha = [SDImageCoderHelper CGImageContainsAlpha:imageRef];
-        if (hasAlpha) {
-            format = SDImageFormatPNG;
-        } else {
-            format = SDImageFormatJPEG;
-        }
-    }
-    
-    NSMutableData *imageData = [NSMutableData data];
-    CFStringRef imageUTType = [NSData sd_UTTypeFromImageFormat:format];
-    
-    // Create an image destination.
-    CGImageDestinationRef imageDestination = CGImageDestinationCreateWithData((__bridge CFMutableDataRef)imageData, imageUTType, 1, NULL);
-    if (!imageDestination) {
-        // Handle failure.
-        return nil;
-    }
-    
-    NSMutableDictionary *properties = [NSMutableDictionary dictionary];
-#if SD_UIKIT || SD_WATCH
-    CGImagePropertyOrientation exifOrientation = [SDImageCoderHelper exifOrientationFromImageOrientation:image.imageOrientation];
-#else
-    CGImagePropertyOrientation exifOrientation = kCGImagePropertyOrientationUp;
-#endif
-    properties[(__bridge NSString *)kCGImagePropertyOrientation] = @(exifOrientation);
-    // Encoding Options
-    double compressionQuality = 1;
-    if (options[SDImageCoderEncodeCompressionQuality]) {
-        compressionQuality = [options[SDImageCoderEncodeCompressionQuality] doubleValue];
-    }
-    properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = @(compressionQuality);
-    CGColorRef backgroundColor = [options[SDImageCoderEncodeBackgroundColor] CGColor];
-    if (backgroundColor) {
-        properties[(__bridge NSString *)kCGImageDestinationBackgroundColor] = (__bridge id)(backgroundColor);
-    }
-    CGSize maxPixelSize = CGSizeZero;
-    NSValue *maxPixelSizeValue = options[SDImageCoderEncodeMaxPixelSize];
-    if (maxPixelSizeValue != nil) {
-#if SD_MAC
-        maxPixelSize = maxPixelSizeValue.sizeValue;
-#else
-        maxPixelSize = maxPixelSizeValue.CGSizeValue;
-#endif
-    }
-    CGFloat pixelWidth = (CGFloat)CGImageGetWidth(imageRef);
-    CGFloat pixelHeight = (CGFloat)CGImageGetHeight(imageRef);
-    CGFloat finalPixelSize = 0;
-    BOOL encodeFullImage = maxPixelSize.width == 0 || maxPixelSize.height == 0 || pixelWidth == 0 || pixelHeight == 0 || (pixelWidth <= maxPixelSize.width && pixelHeight <= maxPixelSize.height);
-    if (!encodeFullImage) {
-        // Thumbnail Encoding
-        CGFloat pixelRatio = pixelWidth / pixelHeight;
-        CGFloat maxPixelSizeRatio = maxPixelSize.width / maxPixelSize.height;
-        if (pixelRatio > maxPixelSizeRatio) {
-            finalPixelSize = MAX(maxPixelSize.width, maxPixelSize.width / pixelRatio);
-        } else {
-            finalPixelSize = MAX(maxPixelSize.height, maxPixelSize.height * pixelRatio);
-        }
-        properties[(__bridge NSString *)kCGImageDestinationImageMaxPixelSize] = @(finalPixelSize);
-    }
-    NSUInteger maxFileSize = [options[SDImageCoderEncodeMaxFileSize] unsignedIntegerValue];
-    if (maxFileSize > 0) {
-        properties[kSDCGImageDestinationRequestedFileSize] = @(maxFileSize);
-        // Remove the quality if we have file size limit
-        properties[(__bridge NSString *)kCGImageDestinationLossyCompressionQuality] = nil;
-    }
-    BOOL embedThumbnail = NO;
-    if (options[SDImageCoderEncodeEmbedThumbnail]) {
-        embedThumbnail = [options[SDImageCoderEncodeEmbedThumbnail] boolValue];
-    }
-    properties[(__bridge NSString *)kCGImageDestinationEmbedThumbnail] = @(embedThumbnail);
-    
-    // Add your image to the destination.
-    CGImageDestinationAddImage(imageDestination, imageRef, (__bridge CFDictionaryRef)properties);
-    
-    // Finalize the destination.
-    if (CGImageDestinationFinalize(imageDestination) == NO) {
-        // Handle failure.
-        imageData = nil;
-    }
-    
-    CFRelease(imageDestination);
-    
-    return [imageData copy];
-}
-
-@end

package/example/ios/Pods/SDWebImage/SDWebImage/Core/SDImageLoader.h

@@ -1,146 +0,0 @@
-/*
- * This file is part of the SDWebImage package.
- * (c) Olivier Poitrey <rs@dailymotion.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-
-#import "SDWebImageCompat.h"
-#import "SDWebImageDefine.h"
-#import "SDWebImageOperation.h"
-#import "SDImageCoder.h"
-
-typedef void(^SDImageLoaderProgressBlock)(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL);
-typedef void(^SDImageLoaderCompletedBlock)(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, BOOL finished);
-
-#pragma mark - Context Options
-
-/**
- A `UIImage` instance from `SDWebImageManager` when you specify `SDWebImageRefreshCached` and image cache hit.
- This can be a hint for image loader to load the image from network and refresh the image from remote location if needed. If the image from remote location does not change, you should call the completion with `SDWebImageErrorCacheNotModified` error. (UIImage)
- @note If you don't implement `SDWebImageRefreshCached` support, you do not need to care about this context option.
- */
-FOUNDATION_EXPORT SDWebImageContextOption _Nonnull const SDWebImageContextLoaderCachedImage;
-
-#pragma mark - Helper method
-
-/**
- This is the built-in decoding process for image download from network or local file.
- @note If you want to implement your custom loader with `requestImageWithURL:options:context:progress:completed:` API, but also want to keep compatible with SDWebImage's behavior, you'd better use this to produce image.
-
- @param imageData The image data from the network. Should not be nil
- @param imageURL The image URL from the input. Should not be nil
- @param options The options arg from the input
- @param context The context arg from the input
- @return The decoded image for current image data load from the network
- */
-FOUNDATION_EXPORT UIImage * _Nullable SDImageLoaderDecodeImageData(NSData * _Nonnull imageData, NSURL * _Nonnull imageURL, SDWebImageOptions options, SDWebImageContext * _Nullable context);
-
-/**
- This is the built-in decoding process for image progressive download from network. It's used when `SDWebImageProgressiveLoad` option is set. (It's not required when your loader does not support progressive image loading)
- @note If you want to implement your custom loader with `requestImageWithURL:options:context:progress:completed:` API, but also want to keep compatible with SDWebImage's behavior, you'd better use this to produce image.
-
- @param imageData The image data from the network so far. Should not be nil
- @param imageURL The image URL from the input. Should not be nil
- @param finished Pass NO to specify the download process has not finished. Pass YES when all image data has finished.
- @param operation The loader operation associated with current progressive download. Why to provide this is because progressive decoding need to store the partial decoded context for each operation to avoid conflict. You should provide the operation from `loadImageWithURL:` method return value.
- @param options The options arg from the input
- @param context The context arg from the input
- @return The decoded progressive image for current image data load from the network
- */
-FOUNDATION_EXPORT UIImage * _Nullable SDImageLoaderDecodeProgressiveImageData(NSData * _Nonnull imageData, NSURL * _Nonnull imageURL, BOOL finished,  id<SDWebImageOperation> _Nonnull operation, SDWebImageOptions options, SDWebImageContext * _Nullable context);
-
-/**
- This function get the progressive decoder for current loading operation. If no progressive decoding is happended or decoder is not able to construct, return nil.
- @return The progressive decoder associated with the loading operation.
- */
-FOUNDATION_EXPORT id<SDProgressiveImageCoder> _Nullable SDImageLoaderGetProgressiveCoder(id<SDWebImageOperation> _Nonnull operation);
-
-/**
- This function set the progressive decoder for current loading operation. If no progressive decoding is happended, pass nil.
- @param operation The loading operation to associate the progerssive decoder.
- */
-FOUNDATION_EXPORT void SDImageLoaderSetProgressiveCoder(id<SDWebImageOperation> _Nonnull operation, id<SDProgressiveImageCoder> _Nullable progressiveCoder);
-
-#pragma mark - SDImageLoader
-
-/**
- This is the protocol to specify custom image load process. You can create your own class to conform this protocol and use as a image loader to load image from network or any available remote resources defined by yourself.
- If you want to implement custom loader for image download from network or local file, you just need to concentrate on image data download only. After the download finish, call `SDImageLoaderDecodeImageData` or `SDImageLoaderDecodeProgressiveImageData` to use the built-in decoding process and produce image (Remember to call in the global queue). And finally callback the completion block.
- If you directly get the image instance using some third-party SDKs, such as image directly from Photos framework. You can process the image data and image instance by yourself without that built-in decoding process. And finally callback the completion block.
- @note It's your responsibility to load the image in the desired global queue(to avoid block main queue). We do not dispatch these method call in a global queue but just from the call queue (For `SDWebImageManager`, it typically call from the main queue).
-*/
-@protocol SDImageLoader <NSObject>
-
-@required
-/**
- Whether current image loader supports to load the provide image URL.
- This will be checked every time a new image request come for loader. If this return NO, we will mark this image load as failed. If return YES, we will start to call `requestImageWithURL:options:context:progress:completed:`.
-
- @param url The image URL to be loaded.
- @return YES to continue download, NO to stop download.
- */
-- (BOOL)canRequestImageForURL:(nullable NSURL *)url API_DEPRECATED("Use canRequestImageForURL:options:context: instead", macos(10.10, API_TO_BE_DEPRECATED), ios(8.0, API_TO_BE_DEPRECATED), tvos(9.0, API_TO_BE_DEPRECATED), watchos(2.0, API_TO_BE_DEPRECATED));
-
-@optional
-/**
- Whether current image loader supports to load the provide image URL, with associated options and context.
- This will be checked every time a new image request come for loader. If this return NO, we will mark this image load as failed. If return YES, we will start to call `requestImageWithURL:options:context:progress:completed:`.
-
- @param url The image URL to be loaded.
- @param options A mask to specify options to use for this request
- @param context A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
- @return YES to continue download, NO to stop download.
- */
-- (BOOL)canRequestImageForURL:(nullable NSURL *)url
-                      options:(SDWebImageOptions)options
-                      context:(nullable SDWebImageContext *)context;
-
-@required
-/**
- Load the image and image data with the given URL and return the image data. You're responsible for producing the image instance.
-
- @param url The URL represent the image. Note this may not be a HTTP URL
- @param options A mask to specify options to use for this request
- @param context A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
- @param progressBlock A block called while image is downloading
- *                    @note the progress block is executed on a background queue
- @param completedBlock A block called when operation has been completed.
- @return An operation which allow the user to cancel the current request.
- */
-- (nullable id<SDWebImageOperation>)requestImageWithURL:(nullable NSURL *)url
-                                                options:(SDWebImageOptions)options
-                                                context:(nullable SDWebImageContext *)context
-                                               progress:(nullable SDImageLoaderProgressBlock)progressBlock
-                                              completed:(nullable SDImageLoaderCompletedBlock)completedBlock;
-
-
-/**
- Whether the error from image loader should be marked indeed un-recoverable or not.
- If this return YES, failed URL which does not using `SDWebImageRetryFailed` will be blocked into black list. Else not.
-
- @param url The URL represent the image. Note this may not be a HTTP URL
- @param error The URL's loading error, from previous `requestImageWithURL:options:context:progress:completed:` completedBlock's error.
- @return Whether to block this url or not. Return YES to mark this URL as failed.
- */
-- (BOOL)shouldBlockFailedURLWithURL:(nonnull NSURL *)url
-                              error:(nonnull NSError *)error API_DEPRECATED("Use shouldBlockFailedURLWithURL:error:options:context: instead", macos(10.10, API_TO_BE_DEPRECATED), ios(8.0, API_TO_BE_DEPRECATED), tvos(9.0, API_TO_BE_DEPRECATED), watchos(2.0, API_TO_BE_DEPRECATED));
-
-@optional
-/**
- Whether the error from image loader should be marked indeed un-recoverable or not, with associated options and context.
- If this return YES, failed URL which does not using `SDWebImageRetryFailed` will be blocked into black list. Else not.
-
- @param url The URL represent the image. Note this may not be a HTTP URL
- @param error The URL's loading error, from previous `requestImageWithURL:options:context:progress:completed:` completedBlock's error.
- @param options A mask to specify options to use for this request
- @param context A context contains different options to perform specify changes or processes, see `SDWebImageContextOption`. This hold the extra objects which `options` enum can not hold.
- @return Whether to block this url or not. Return YES to mark this URL as failed.
- */
-- (BOOL)shouldBlockFailedURLWithURL:(nonnull NSURL *)url
-                              error:(nonnull NSError *)error
-                            options:(SDWebImageOptions)options
-                            context:(nullable SDWebImageContext *)context;
-
-@end