UIImage 尺寸调整工具技术文档

1. 安装指南

1.1 环境要求

• Xcode 版本：10.0 及以上
• iOS 版本：9.0 及以上

1.2 安装步骤

1. 打开你的 Xcode 项目。
2. 将项目中的 UIImage+Resize.h 和 UIImage+Resize.m 文件拖入你的项目中。
3. 确保在需要使用该功能的文件中导入头文件：

   #import "UIImage+Resize.h"
   

2. 项目的使用说明

2.1 功能概述

该项目提供了一个 UIImage 的分类，允许你根据给定的 CGSize 调整图像的大小。你可以选择将图像调整到指定的大小，或者按比例调整图像，使其适应给定的 CGSize。

2.2 使用示例

以下是使用该分类调整图像大小的示例代码：

// 假设你有一个 UIImage 对象
UIImage *image = [UIImage imageNamed:@"example.jpg"];

// 调整图像到指定大小
CGSize targetSize = CGSizeMake(300, 300);
UIImage *resizedImage = [image resizedImageToSize:&targetSize];

// 按比例调整图像，使其适应给定的 CGSize
BOOL scaleIfSmaller = YES;
UIImage *proportionalResizedImage = [image resizedImageToFitInSize:&targetSize scaleIfSmaller:scaleIfSmaller];

3. 项目API使用文档

3.1 resizedImageToSize: 方法

• 描述: 将图像调整到指定的大小。
• 参数:
  • size: 目标大小，类型为 CGSize*。
• 返回值: 调整后的 UIImage 对象。

3.2 resizedImageToFitInSize:scaleIfSmaller: 方法

• 描述: 按比例调整图像，使其适应给定的 CGSize。如果 scaleIfSmaller 为 YES，则即使图像小于目标大小也会进行缩放。
• 参数:
  • size: 目标大小，类型为 CGSize*。
  • scaleIfSmaller: 是否在图像小于目标大小时进行缩放，类型为 BOOL。
• 返回值: 调整后的 UIImage 对象。

4. 项目安装方式

4.1 手动安装

1. 下载项目文件。
2. 将 UIImage+Resize.h 和 UIImage+Resize.m 文件添加到你的 Xcode 项目中。
3. 在需要使用该功能的文件中导入头文件：

   #import "UIImage+Resize.h"
   

4.2 使用 CocoaPods 安装（可选）

1. 在 Podfile 中添加以下内容：

   pod 'UIImage+Resize', :git => 'https://github.com/your-repo/UIImage-Resize.git'
   

2. 运行 pod install。
3. 在需要使用该功能的文件中导入头文件：

   #import <UIImage+Resize/UIImage+Resize.h>
   

通过以上步骤，你可以在项目中轻松使用该工具来调整 UIImage 的大小。