HYBImageCliped 2.2.4
- 由
- huangyibiao
一个开源高效的圆角处理扩展，包括UIImageView、UIView、UIButton、UIImage的扩展API，可根据图片颜色生成圆角图片，可给UIButton设置不同状态下的图片并添加圆角，为UIImageView设置任意图片，支持带圆角的圆形显示。上述功能均不会引起离屏渲染、混合颜色层、图像错位等。
概述
开源项目名称：HYBImageCliped
当前版本：2.2.3
项目用途：为任意继承UIView的控件添加任意多个圆角、根据颜色生成图片且可带任意个圆角、为UIButton设置不同状态下的图片并添加圆角、为UIImageView设置任意图片，支持带圆角或直接生成圆形。所有这些功能都不会造成离屏渲染。
版本变化
版本 2.2.3
- 增加对自动布局的支持
版本 2.2.2
- 增加刷新缓存的功能，用于满足视图宽高动态变化的需求
// UIView的扩展属性，默认为NO。设置为YES时，则会刷新缓存，重新添加
@property (nonatomic, assign) BOOL hyb_shouldRefreshCache;
版本 2.2.1
- 修复了单圆角或双圆角显示成四个圆角的bug
版本 2.2.0
- 修改添加边框颜色的方法，并缓存
- 增加单边框API
- 增加镂空图圆角设置，且对镂空图缓存以提高效率
- 修改UIView的圆角方式增加了策略：
- 1、若需要设置双边框，使用裁剪图片；
- 2、如果图片比例相差不大，使用镂空图；
- 3、如果图片比例相差不大，但是需要边框，裁剪并添加镂空图；
增加了Demo，对比添加圆角后的效果：
优化后增加了许多控件，所以效果没有达到60~
版本 2.1.1
- 优化内存，及时释放未使用的图片
版本 2.1.0
- 增加带圆角的图片可以设置边框
- 增加图片缓存到内存功能，异步读取、保存图片功能、异步清除缓存功能
版本 2.0.0
- 将UIImageView扩展中的API全部移至UIView扩展，这样可以直接使用更轻量的UIView来显示图片，而不需要UIImageView。同时还可以兼容使用UIImageView的同学
- 增加几个方便生成图片的API
- 新增图片添加边框功能
效果如下：
详情查看：Version2.0.0新增API
版本 1.1.1
- 修复bug
- 优化内存
版本 1.1.0
- 增加剪裁的图片缓存管理类HYBImageClipedManager，用于解决缓存到内存引起内存增长很快的问题。详情查看HYBImageClipedManager
版本 1.0.1
- 修复文档未上传的bug
- 删除不相关的注释
- 增加demo
截图
裁剪耗时
正常图片裁剪耗时较小，但是当图片过大时，耗时也会增多。但是，裁剪前滚动列表会很卡，裁剪后滚动会明显流畅。对于图片列表这个demo中，裁剪后FPS能平均在58左右，基本没有感觉到卡。
如何使用
在使用前，先引入头文件：
#import "HYBImageCliped.h"
HYBImageClipedManager
此类用于处理将图片缓存到本地，解决内存增长问题。仅提供以下API，包括读取图片、存储图片、获取缓存大小、清空缓存：
/**
* 根据存储时指定的key从本地获取已剪裁好的图片
*
* @param key 通常是URL。在内部会进行MD5
*
* @return 从本地读取图片，不会存储到内存中，用于解决图片列表中内存暴涨问题
*/
+ (UIImage *)clipedImageFromDiskWithKey:(NSString *)key;
/**
* 在裁剪成功后，可以调用此API，将剪裁后的图片存储到本地。
*
* @param clipedImage 已剪裁好的图片
* @param key 唯一key，通常是指URL。内部会进行MD5.
*/
+ (void)storeClipedImage:(UIImage *)clipedImage toDiskWithKey:(NSString *)key;
/**
* 获取本地已存储的所有已剪裁的缓存大小，单位为bytes
*
* @return 缓存大小
*/
+ (unsigned long long)imagesCacheSize;
/**
* 清除缓存
*/
+ (void)clearClipedImagesCache;
UIImage+HYBImageCliped
目前提供以下几种类型的API：
- 根据颜色生成图片，支持带任意圆角
- 单纯地放大或缩小图片
- 直接生成带四个圆角的图片
- 生成带任意圆角的图片
- 直接生成圆形图片
2.0.0新增：增加添加图片边框属性
#pragma mark - 边框相关属属性，仅对生成圆形图片和矩形图片有效
/**
* 默认为1.0，当小于0时，不会添加边框，仅对生成圆形图片和矩形图片有效
*/
@property (nonatomic, assign) CGFloat hyb_borderWidth;
/**
* 当小于0时，不会添加边框。默认为0.仅对生成圆形图片和矩形图片有效
*/
@property (nonatomic, assign) CGFloat hyb_pathWidth;
/**
* 边框线的颜色，默认为[UIColor lightGrayColor]，仅对生成圆形图片和矩形图片有效
*/
@property (nonatomic, strong) UIColor *hyb_borderColor;
/**
* Path颜色，默认为白色。仅对生成圆形图片和矩形图片有效
*/
@property (nonatomic, strong) UIColor *hyb_pathColor;
根据颜色生成图片
以下是去掉注释后的API，可以根据颜色生成指定大小的图片，也可以生成带圆角的图片。当有圆角时，可以指定背景颜色，以处理图层混合问题：
+ (UIImage *)hyb_imageWithColor:(UIColor *)color toSize:(CGSize)targetSize;
+ (UIImage *)hyb_imageWithColor:(UIColor *)color toSize:(CGSize)targetSize cornerRadius:(CGFloat)cornerRadius;
+ (UIImage *)hyb_imageWithColor:(UIColor *)color
toSize:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRadius
backgroundColor:(UIColor *)backgroundColor;
单纯放大或缩小图片
注释已去除，参数一是将图片放大或缩小到targetSize，参数二是表示是否要保持等比例放大或缩小。当图片的宽高比与targetSize的宽高比相近时，可以使用等比例；当比例相差很大时，如果使用等比例，将无法看到部分内容。
- (UIImage *)hyb_clipToSize:(CGSize)targetSize
isEqualScale:(BOOL)isEqualScale;
直接生成带四个圆角的图片
当有圆角时，默认背景颜色为白色。为了解决图层混合带来的性能问题，如果白色与控件的背景颜色不同，请手动指定背景颜色，以生成最适合场景的图片：
- (UIImage *)hyb_clipToSize:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRadius
backgroundColor:(UIColor *)backgroundColor
isEqualScale:(BOOL)isEqualScale;
/**
* 生成带圆角图片，默认为白色背景、isEqualScale为YES
*/
- (UIImage *)hyb_clipToSize:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRadius;
生成带任意圆角的图片
图片也可以生成带任意圆角的，例如要生成上左、上右两个圆角，可以这么写UIRectCornerTopLeft | UIRectCornerTopRight，中间直接使用 | 来连接即可：
- (UIImage *)hyb_clipToSize:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRadius
corners:(UIRectCorner)corners
backgroundColor:(UIColor *)backgroundColor
isEqualScale:(BOOL)isEqualScale;
/**
* 生成任意带圆角的图片，默认为白色背景，isEqualScale=YES
*/
- (UIImage *)hyb_clipToSize:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRadius
corners:(UIRectCorner)corners;
直接生成圆形图片
在App中，很多需要显示成圆形的，因此使用下面的API来直接生成圆形图片很方便：
- (UIImage *)hyb_clipCircleToSize:(CGSize)targetSize
backgroundColor:(UIColor *)backgroundColor
isEqualScale:(BOOL)isEqualScale;
/**
* 生成圆形图片，默认为白色背景、isEqualScale为YES
*/
- (UIImage *)hyb_clipCircleToSize:(CGSize)targetSize;
UIButton+HYBImageCliped
对于UIButton，目前提供以下两种API：
- 根据状态设置图片
- 根据状态设置背景图片
根据状态设置图片
这两个API只有一个targetSize参数的差异，如果控件已经是明确的大小，可以直接使用不带targetSize参数的API。如果控件大小在设置图片前不确定，请手动明确指定要生成的图片的大小：
- (void)hyb_setImage:(id)image
forState:(UIControlState)state
cornerRadius:(CGFloat)cornerRadius
isEqualScale:(BOOL)isEqualScale;
- (void)hyb_setImage:(id)image
forState:(UIControlState)state
toSize:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRadius
isEqualScale:(BOOL)isEqualScale;
根据状态设置背景图片
按钮可以有多种状态，可以设置图片，自然也可以设置背景图片：
- (void)hyb_setBackgroundImage:(id)image
forState:(UIControlState)state
cornerRadius:(CGFloat)cornerRadius
isEqualScale:(BOOL)isEqualScale;
- (void)hyb_setBackgroundImage:(id)image
forState:(UIControlState)state
toSize:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRadius
isEqualScale:(BOOL)isEqualScale;
UIView+HYBImageCliped
支持为任何视图添加任意数量的圆角。使用起来非常简单，看注释中的API介绍，带有小例子。如果有多个圆角，可以通过UIRectCornerTopLeft | UIRectCornerBottomRight这样来设置，中间用 | 连接，表示按位与的操作：
/**
* 给控件本身添加圆角，不是通过图片实现的。
*
* @param corner 多个圆角可通过UIRectCornerTopLeft | UIRectCornerTopRight这样来使用
* @param cornerRadius 圆角大小
*
* @Example
* [cornerView3 hyb_setImage:@"bimg8.jpg" cornerRadius:10 rectCorner:UIRectCornerTopLeft |UIRectCornerBottomRight isEqualScale:NO onCliped:^(UIImage *clipedImage) {
// 如果需要复用，可在异步剪裁后，得到已剪裁后的图片，可另行他用
}];
*/
- (void)hyb_addCorner:(UIRectCorner)corner cornerRadius:(CGFloat)cornerRadius;
/**
* corner为UIRectCornerAllCorners
*
* @Example
* 添加一个圆角：[view1 hyb_addCorner:UIRectCornerTopLeft cornerRadius:10];
*/
- (void)hyb_addCornerRadius:(CGFloat)cornerRadius;
UIImageView+HYBImageCliped
2.0版本之后，已添加至UIView+HYBImageCliped
这里提供的API也有好几种，与UIImage+HYBImageCliped有点类似：
- 将图片裁剪成指定大小（只是单纯地缩放）
- 直接生成圆形图片控件
- 生成四个带圆角图片来填充
- 生成任意圆角图片来填充
每个API后面都有一个闭包回调，在剪裁完成时会被调用，外部可以根据需要处理。因为剪裁是异步进行的，所以只能通过闭包回调！
将图片裁剪成指定大小（只是单纯地缩放）
如果不需要添加任何圆角，只是想解决图片过大，与控件本身相差太大而导致像素不对齐的问题，可以直接使用以下API：
- (UIImage *)hyb_setImage:(id)image size:(CGSize)targetSize isEqualScale:(BOOL)isEqualScale onCliped:(HYBClipedCallback)callback;
/**
* 使用指定的图片来填充图片。对于在填充图片之前，肯定有控件大小的，可以直接使用些API。
*/
- (UIImage *)hyb_setImage:(id)image isEqualScale:(BOOL)isEqualScale onCliped:(HYBClipedCallback)callback;
直接生成圆形图像
在开发中，有很多直接显示圆形头像、圆形图片的场景，下面的API可以直接生成：
- (UIImage *)hyb_setCircleImage:(id)image
size:(CGSize)targetSize
isEqualScale:(BOOL)isEqualScale
onCliped:(HYBClipedCallback)callback;
/**
* 使用指定的图片来填充，但是生成的是圆形图片，默认背景颜色为白色。当调用此API时，若控件本身
* 已经有确定的大小，则可以直接使用此API
*/
- (UIImage *)hyb_setCircleImage:(id)image
isEqualScale:(BOOL)isEqualScale
onCliped:(HYBClipedCallback)callback;
生成四个带圆角图片来填充
如果显示带四个圆角，可以直接使用下面的API，高效生成带圆角且与控件大小一致的图片来填充：
- (UIImage *)hyb_setImage:(id)image
size:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRaidus
backgroundColor:(UIColor *)backgroundColor
isEqualScale:(BOOL)isEqualScale
onCliped:(HYBClipedCallback)callback;
/**
* 生成带四个圆角的图片，默认使用白色背景、isEqualScale=YES
*/
- (UIImage *)hyb_setImage:(id)image
size:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRaidus
onCliped:(HYBClipedCallback)callback;
/**
* 生成带四个圆角的图片，默认使用白色背景、isEqualScale=YES。当调用此API时，若控件本身大小是确定的，才能起效！
*/
- (UIImage *)hyb_setImage:(id)image
cornerRadius:(CGFloat)cornerRaidus
onCliped:(HYBClipedCallback)callback;
生成任意圆角图片来填充
如果出现特殊的场景，需要生成三个圆角等特殊情况，或者生成上左、下左圆角或生成上右、下右的组合情况时，可以通过下面的API来生成：
- (UIImage *)hyb_setImage:(id)image
size:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRaidus
rectCorner:(UIRectCorner)rectCorner
backgroundColor:(UIColor *)backgroundColor
isEqualScale:(BOOL)isEqualScale
onCliped:(HYBClipedCallback)callback;
/**
* 生成任意圆角的图片来填充控件。默认背景色为白色、isEqualScale=YES
*/
- (UIImage *)hyb_setImage:(id)image
size:(CGSize)targetSize
cornerRadius:(CGFloat)cornerRaidus
rectCorner:(UIRectCorner)rectCorner
onCliped:(HYBClipedCallback)callback;
/**
* 生成任意圆角的图片来填充控件。默认背景色为白色。如果控件本身大小确定，
* 可以直接使用此API来生成与控件大小相同的图片来填充。
*/
- (UIImage *)hyb_setImage:(id)image
cornerRadius:(CGFloat)cornerRaidus
rectCorner:(UIRectCorner)rectCorner
isEqualScale:(BOOL)isEqualScale
onCliped:(HYBClipedCallback)callback;
/**
* 生成任意圆角的图片来填充控件。默认背景色为白色、isEqualScale=YES。如果控件本身大小确定，
* 可以直接使用此API来生成与控件大小相同的图片来填充。
*/
- (UIImage *)hyb_setImage:(id)image
cornerRadius:(CGFloat)cornerRaidus
rectCorner:(UIRectCorner)rectCorner
onCliped:(HYBClipedCallback)callback;
网络下载图片处理
以下是通过SDWebImage实现异步下载图片，然后剪裁后再显示的一段代码：
if (model.clipedImage) {
self.imageView.image = model.clipedImage;
} else {
__weak __typeof(self) weakSelf = self;
UIImage *image = [UIImage imageNamed:@"img5.jpg"];
[self.imageView sd_setImageWithURL:[NSURL URLWithString:model.url] placeholderImage:image options:SDWebImageRetryFailed completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
dispatch_async(dispatch_get_global_queue(0, 0), ^{
// 将剪裁后的图片记录下来，下次直接使用
model.clipedImage = [image hyb_clipToSize:weakSelf.imageView.bounds.size
cornerRadius:12
backgroundColor:[UIColor blackColor]
isEqualScale:NO];
dispatch_async(dispatch_get_main_queue(), ^{
weakSelf.imageView.image = model.clipedImage;
});
});
}];
}
为了防止SDWebImage每次都从本地读取，做了个判断，将剪裁后的图片放到模型中，下次直接使用即可！
根据颜色生成图片使用
UIImageView *colorImageView = [[UIImageView alloc] init];
colorImageView.frame = CGRectMake(200, 200, 80, 100);
[self.view addSubview:colorImageView];
colorImageView.image = [UIImage hyb_imageWithColor:[UIColor greenColor] toSize:CGSizeMake(80, 100) cornerRadius:20];
按钮使用
UIButton *button = [UIButton buttonWithType:UIButtonTypeCustom];
button.frame = CGRectMake(100, 200, 80, 80);
button.backgroundColor = [UIColor whiteColor];
[self.view addSubview:button];
[button hyb_setImage:@"img1.jpeg" forState:UIControlStateNormal cornerRadius:40 isEqualScale:YES];
[button hyb_setImage:@"bimg5.jpg" forState:UIControlStateHighlighted cornerRadius:40 isEqualScale:NO];
UIImageView使用
生成圆形图片：
[imgView hyb_setCircleImage:@"img1.jpeg" isEqualScale:YES onCliped:^(UIImage *clipedImage) {
}];
任意圆角
UIView *view1 = [[UIView alloc] initWithFrame:CGRectMake(10, 100, 80, 80)];
view1.backgroundColor = [UIColor greenColor];
// 只加左上角
[view1 hyb_addCorner:UIRectCornerTopLeft cornerRadius:10];
[self.view addSubview:view1];
UIView *view2 = [[UIView alloc] initWithFrame:CGRectMake(100, 100, 80, 80)];
view2.backgroundColor = [UIColor greenColor];
// 只添加右
[view2 hyb_addCorner:UIRectCornerTopRight cornerRadius:10];
[self.view addSubview:view2];
UIView *view3 = [[UIView alloc] initWithFrame:CGRectMake(200, 100, 80, 80)];
view3.backgroundColor = [UIColor greenColor];
// 只添加下左角和下右角
[view3 hyb_addCorner:UIRectCornerBottomLeft | UIRectCornerBottomRight cornerRadius:10];
[self.view addSubview:view3];
如何安装
支持Pod安装，可直接将下面的代码放到Podfile中：
pod 'HYBImageCliped', '~> 2.0.0'
或者到GITHUB直接下载【HYBImageCliped】将其中的Sources目录放入到工程！
LICENSE
MIT LICENSE