ImageCropper: 实现iOS图片裁剪功能的Swift库

ImageCropper: 实现iOS图片裁剪功能的Swift库

ImageCropper 是一个用于 iOS 平台的 Swift 库，能够帮助开发者轻松实现图片的裁剪功能。它支持自定义裁剪框形状、大小和旋转等操作，提供了一套简洁易用的 API 和界面设计，适用于各种应用场景。

功能特性

1. 支持矩形、圆形和其他自定义形状的裁剪框。
2. 可以设置裁剪框的宽高比例和大小范围限制。
3. 裁剪框可以自由平移、缩放和旋转。
4. 提供了丰富的回调函数，方便获取裁剪结果和操作状态。
5. 界面简洁大方，易于集成到已有项目中。

使用场景

ImageCropper 可广泛应用于以下场景：

1. 用户头像上传时进行裁剪。
2. 照片分享或保存前进行裁剪美化。
3. 图片编辑应用中的裁剪功能模块。

快速上手

将 ImageCropper 添加到 Xcode 工程中，可以通过 CocoaPods 或 Carthage 进行安装：

使用 CocoaPods 安装

在 Podfile 中添加依赖：

pod 'ImageCropper'

执行 pod install 命令并导入库文件即可开始使用。

使用 Carthage 安装

在 Cartfile 中添加依赖：

github "iosdeveloper/ImageCropper"

运行 carthage update 并手动将生成的框架添加到项目中。

示例代码如下所示：

import UIKit
import ImageCropper

class ViewController: UIViewController, UIImagePickerControllerDelegate, UINavigationControllerDelegate {
    
    @IBOutlet weak var imageView: UIImageView!
    
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 设置初始图片
        let img = UIImage(named: "example")
        imageView.image = img
    }
    
    @IBAction func selectPhoto(_ sender: UIButton) {
        if UIImagePickerController.isSourceTypeAvailable(.photoLibrary) {
            let picker = UIImagePickerController()
            picker.sourceType = .photoLibrary
            picker.delegate = self
            present(picker, animated: true, completion: nil)
        }
    }
}

extension ViewController: UIImagePickerControllerDelegate, UINavigationControllerDelegate {
    
    func imagePickerController(_ picker: UIImagePickerController, didFinishPickingMediaWithInfo info: [UIImagePickerController.InfoKey : Any]) {
        picker.dismiss(animated: true, completion: nil)
        
        guard let selectedImage = info[.originalImage] as? UIImage else { return }
        cropImage(image: selectedImage)
    }
    
    func imagePickerControllerDidCancel(_ picker: UIImagePickerController) {
        picker.dismiss(animated: true, completion: nil)
    }
    
    func cropImage(image: UIImage) {
        let croppingVC = ImageCropperViewController(sourceImage: image, cropperFrame: CGRect(x: 0, y: 0, width: view.bounds.width, height: view.bounds.height))
        croppingVC.delegate = self
        presentingViewController?.present(croppingVC, animated: true, completion: nil)
    }
}

extension ViewController: ImageCropperDelegate {
    
    func imageCropper(_cropper: ImageCropperViewController, didCropTo image: UIImage, withRect rect: CGRect, angle: Int) {
        imageView.image = image
    }
}

结语

ImageCropper 是一个强大的图片裁剪工具，提供了多种定制选项，适用于各种需求。我们诚挚邀请您尝试使用该库，并欢迎通过 GitHub 提交问题或建议。