当前位置：首页 > news >正文

UIImage-BlurredFrame完全指南：从安装到高级应用

news 2026/7/5 17:18:58

UIImage-BlurredFrame完全指南：从安装到高级应用

【免费下载链接】UIImage-BlurredFrameUIImage category that blurs an specified frame of a UIImage项目地址: https://gitcode.com/gh_mirrors/ui/UIImage-BlurredFrame

UIImage-BlurredFrame是一个强大的iOS开发工具，它作为UIImage的分类，允许开发者对图片的特定区域应用模糊效果。这个轻量级库提供了多种模糊样式和自定义选项，让你轻松实现专业级的图片模糊效果，提升应用的视觉体验。

为什么选择UIImage-BlurredFrame？

在移动应用设计中，图片模糊效果已成为提升用户界面美感的重要元素。UIImage-BlurredFrame通过以下优势脱颖而出：

精准区域模糊：支持对图片的特定矩形区域进行模糊处理，而非整张图片
多种模糊效果：内置多种预设效果，满足不同设计需求
高度可定制：可调整模糊半径、饱和度、色调等参数
简单易用：通过分类方法扩展UIImage，调用方式直观自然

快速安装步骤

使用CocoaPods安装（推荐）

UIImage-BlurredFrame提供了Podspec，可通过CocoaPods轻松集成到你的项目中：

在你的Podfile中添加以下行：
```
pod 'UIImage+BlurredFrame', '~> 0.0.4'
```
运行安装命令：
```
pod install
```

手动安装

如果你偏好手动集成，可以按照以下步骤操作：

克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/ui/UIImage-BlurredFrame

将以下核心文件添加到你的Xcode项目中：
- UIImage+BlurredFrame.h
- UIImage+BlurredFrame.m
- UIImage+ImageEffects.h
- UIImage+ImageEffects.m
确保你的项目已链接UIKit框架。

基础使用指南

UIImage-BlurredFrame的使用非常简单，只需导入头文件后，就可以直接对UIImage对象调用模糊方法。

导入头文件

#import "UIImage+BlurredFrame.h"

应用预设模糊效果

库中提供了几种常用的预设模糊效果，可直接使用：

// 应用浅色模糊效果 UIImage *lightBlurredImage = [originalImage applyLightEffectAtFrame:CGRectMake(0, 0, 320, 100)]; // 应用超浅色模糊效果 UIImage *extraLightBlurredImage = [originalImage applyExtraLightEffectAtFrame:CGRectMake(50, 50, 200, 200)]; // 应用深色模糊效果 UIImage *darkBlurredImage = [originalImage applyDarkEffectAtFrame:CGRectMake(0, image.size.height-60, image.size.width, 60)];

这些方法接受一个CGRect参数，指定需要模糊的区域。例如，在iOS应用中，你可能想要模糊图片的顶部区域来放置导航栏内容，或者模糊底部区域来显示工具栏：

高级自定义选项

对于需要更多控制权的场景，UIImage-BlurredFrame提供了高度可定制的模糊方法。

应用带色调的模糊效果

你可以为模糊区域添加自定义色调：

UIColor *tintColor = [UIColor colorWithRed:0.2 green:0.5 blue:0.8 alpha:0.3]; UIImage *tintedBlurredImage = [originalImage applyTintEffectWithColor:tintColor atFrame:CGRectMake(0, 0, 320, 100)];

完全自定义模糊参数

最灵活的方法是使用applyBlurWithRadius:tintColor:saturationDeltaFactor:maskImage:atFrame:，它允许你调整多个参数：

UIImage *customBlurredImage = [originalImage applyBlurWithRadius:10.0 tintColor:[UIColor colorWithWhite:1.0 alpha:0.2] saturationDeltaFactor:1.5 maskImage:nil atFrame:CGRectMake(20, 20, 280, 150)];

参数说明：

blurRadius：模糊半径，值越大模糊效果越明显
tintColor：应用于模糊区域的色调
saturationDeltaFactor：饱和度调整因子（1.0为原始饱和度）
maskImage：可选的遮罩图像，用于创建非矩形模糊区域
atFrame：指定要模糊的区域

多次迭代模糊

对于需要更强烈模糊效果的场景，可以使用带迭代次数的方法：

UIImage *strongBlurredImage = [originalImage applyBlurWithRadius:5.0 iterationsCount:3 tintColor:nil saturationDeltaFactor:1.0 maskImage:nil atFrame:CGRectMake(0, 0, image.size.width, 80)];

iterationsCount参数指定模糊处理的次数，多次迭代可以产生更平滑的模糊效果。

实际应用场景

UIImage-BlurredFrame可以应用于多种场景，提升你的iOS应用UI设计：

1. 导航栏背景

为导航栏下方的图片特定区域应用模糊，使导航栏内容更清晰可见：

UIImage *navBarImage = [originalImage applyLightEffectAtFrame:CGRectMake(0, 0, self.view.frame.size.width, 64)]; self.navigationController.navigationBar.backgroundImage = navBarImage;

2. 卡片式设计

在卡片底部应用渐变模糊，突出卡片内容：

CGRect blurFrame = CGRectMake(0, cardImage.size.height-80, cardImage.size.width, 80); UIImage *cardImageWithBlur = [originalImage applyDarkEffectAtFrame:blurFrame];

3. 图片标注

为图片中的特定区域应用模糊，突出显示标注内容：

UIColor *tintColor = [UIColor colorWithRed:0.9 green:0.2 blue:0.2 alpha:0.25]; UIImage *imageWithHighlight = [originalImage applyTintEffectWithColor:tintColor atFrame:objectFrame];