156 lines
5.6 KiB
Objective-C
156 lines
5.6 KiB
Objective-C
/*
|
|
* 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 "UIImage+Transform.h"
|
|
|
|
/**
|
|
Return the transformed cache key which applied with specify transformerKey.
|
|
|
|
@param key The original cache key
|
|
@param transformerKey The transformer key from the transformer
|
|
@return The transformed cache key
|
|
*/
|
|
FOUNDATION_EXPORT NSString * _Nullable SDTransformedKeyForKey(NSString * _Nullable key, NSString * _Nonnull transformerKey);
|
|
|
|
/**
|
|
A transformer protocol to transform the image load from cache or from download.
|
|
You can provide transformer to cache and manager (Through the `transformer` property or context option `SDWebImageContextCustomTransformer`).
|
|
|
|
@note The transform process is called from a global queue in order to not to block the main queue.
|
|
*/
|
|
@protocol SDWebImageTransformer <NSObject>
|
|
|
|
@required
|
|
/**
|
|
For each transformer, it must contains its cache key to used to store the image cache or query from the cache. This key will be appened after the original cache key generated by URL or from user.
|
|
|
|
@return The cache key to appended after the original cache key. Should not be nil.
|
|
*/
|
|
- (nonnull NSString *)transformerKey;
|
|
|
|
/**
|
|
Transform the image to another image.
|
|
|
|
@param image The image to be transformed
|
|
@param key The cache key associated to the image
|
|
@return The transformed image, or nil if transform failed
|
|
*/
|
|
- (nullable UIImage *)transformedImageWithImage:(nonnull UIImage *)image forKey:(nonnull NSString *)key;
|
|
|
|
@end
|
|
|
|
#pragma mark - Pipeline
|
|
|
|
// Pipeline transformer. Which you can bind multiple transformers together to let the image to be transformed one by one in order and generate the final image.
|
|
// Because transformers are lightweight, if you want to append or arrange transfomers, create another pipeline transformer instead. This class is considered as immutable.
|
|
@interface SDWebImagePipelineTransformer : NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, copy, readonly, nonnull) NSArray<id<SDWebImageTransformer>> *transformers;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithTransformers:(nonnull NSArray<id<SDWebImageTransformer>> *)transformers;
|
|
|
|
@end
|
|
|
|
// There are some built-in transformers based on the `UIImage+Transformer` category to provide the common image geometry, image blending and image effect process. Those transform are useful for static image only but you can create your own to support animated image as well.
|
|
// Because transformers are lightweight, these class are considered as immutable.
|
|
#pragma mark - Image Geometry
|
|
|
|
// Image round corner transformer
|
|
@interface SDWebImageRoundCornerTransformer: NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, assign, readonly) CGFloat cornerRadius;
|
|
@property (nonatomic, assign, readonly) SDRectCorner corners;
|
|
@property (nonatomic, assign, readonly) CGFloat borderWidth;
|
|
@property (nonatomic, strong, readonly, nullable) UIColor *borderColor;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithRadius:(CGFloat)cornerRadius corners:(SDRectCorner)corners borderWidth:(CGFloat)borderWidth borderColor:(nullable UIColor *)borderColor;
|
|
|
|
@end
|
|
|
|
// Image resizing transformer
|
|
@interface SDWebImageResizingTransformer : NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, assign, readonly) CGSize size;
|
|
@property (nonatomic, assign, readonly) SDImageScaleMode scaleMode;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithSize:(CGSize)size scaleMode:(SDImageScaleMode)scaleMode;
|
|
|
|
@end
|
|
|
|
// Image cropping transformer
|
|
@interface SDWebImageCroppingTransformer : NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, assign, readonly) CGRect rect;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithRect:(CGRect)rect;
|
|
|
|
@end
|
|
|
|
// Image flipping transformer
|
|
@interface SDWebImageFlippingTransformer : NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, assign, readonly) BOOL horizontal;
|
|
@property (nonatomic, assign, readonly) BOOL vertical;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithHorizontal:(BOOL)horizontal vertical:(BOOL)vertical;
|
|
|
|
@end
|
|
|
|
// Image rotation transformer
|
|
@interface SDWebImageRotationTransformer : NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, assign, readonly) CGFloat angle;
|
|
@property (nonatomic, assign, readonly) BOOL fitSize;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithAngle:(CGFloat)angle fitSize:(BOOL)fitSize;
|
|
|
|
@end
|
|
|
|
#pragma mark - Image Blending
|
|
|
|
// Image tint color transformer
|
|
@interface SDWebImageTintTransformer : NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, strong, readonly, nonnull) UIColor *tintColor;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithColor:(nonnull UIColor *)tintColor;
|
|
|
|
@end
|
|
|
|
#pragma mark - Image Effect
|
|
|
|
// Image blur effect transformer
|
|
@interface SDWebImageBlurTransformer : NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, assign, readonly) CGFloat blurRadius;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithRadius:(CGFloat)blurRadius;
|
|
|
|
@end
|
|
|
|
#if SD_UIKIT || SD_MAC
|
|
// Core Image filter transformer
|
|
@interface SDWebImageFilterTransformer: NSObject <SDWebImageTransformer>
|
|
|
|
@property (nonatomic, strong, readonly, nonnull) CIFilter *filter;
|
|
|
|
- (nonnull instancetype)init NS_UNAVAILABLE;
|
|
+ (nonnull instancetype)transformerWithFilter:(nonnull CIFilter *)filter;
|
|
|
|
@end
|
|
#endif
|