ZYW.ZYWImage 1.0.7

IMGHelper - 图片处理辅助类库

介绍

IMGHelper 是一个基于 .NET Framework 开发的图片处理辅助类库，提供了一系列便捷的图片操作方法，包括图片缩放、裁剪、格式转换、字节数组/流转换、Base64 编解码、图片压缩、缩略图生成、长图切割等功能，可满足日常图片处理的大部分场景需求。

功能特性

• ✅ 图片按比例缩放（支持指定目标宽高）
• ✅ 图片区域裁剪
• ✅ 图片格式转换（默认转为JPEG）
• ✅ 图片与字节数组/内存流互转
• ✅ Base64 编码/解码（支持文件路径和图片对象）
• ✅ 图片质量压缩（指定目标大小自动调整压缩质量）
• ✅ 缩略图生成（按比例裁剪后缩放）
• ✅ 长图片垂直切割（按指定高度分割为多张）
• ✅ 无锁加载图片（避免文件占用问题）

安装

通过 NuGet 包管理器安装：

Install-Package IMGHelper

或通过 .NET CLI 安装：

dotnet add package IMGHelper

快速开始

命名空间引用

using Helper;
using System.Drawing;
using System.Drawing.Imaging;
using System.IO;

核心功能示例

1. 图片缩放

// 加载图片
Bitmap originalImg = new Bitmap("test.jpg");
// 缩放到 720x1440（按比例缩放，居中显示）
Bitmap scaledImg = originalImg.Zoom(720, 1440);
// 保存缩放后的图片
scaledImg.Save("scaled.jpg", ImageFormat.Jpeg);

2. 图片裁剪

Image originImg = Image.FromFile("test.jpg");
// 裁剪左上角 200x200 区域
Rectangle cropRegion = new Rectangle(0, 0, 200, 200);
Image croppedImg = originImg.Crop(cropRegion);
croppedImg.Save("cropped.jpg", ImageFormat.Jpeg);

3. 图片压缩（指定目标大小）

Image img = Image.FromFile("large.jpg");
// 压缩至 100KB 以内（默认目标大小 102400 字节）
Image compressedImg = img.Zip(ImageFormat.Jpeg, 1024 * 100);
compressedImg.Save("compressed.jpg", ImageFormat.Jpeg);

4. 图片转 Base64

// 从文件路径转 Base64
string base64Str = "test.jpg".ToBase64FromImage();
// 从图片对象转 Base64
Image img = Image.FromFile("test.jpg");
string base64FromImg = img.ToBase64();

5. Base64 转图片

string base64Str = "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAAAAAAAD/...";
// 移除前缀（如需）
base64Str = base64Str.Split(',')[1];
Image img = base64Str.ToImgFromBase64();
img.Save("fromBase64.jpg", ImageFormat.Jpeg);

6. 生成缩略图

Image img = Image.FromFile("original.jpg");
// 生成 200x200 缩略图（按比例裁剪）
Image thumbnail = img.CreateThumbnail(200, 200);
thumbnail.Save("thumbnail.jpg", ImageFormat.Jpeg);

7. 长图切割

Image longImg = Image.FromFile("long.jpg");
// 按高度 500 切割为多张图片
List<Image> slicedImgs = longImg.SplitWithVertically(500);
// 保存切割后的图片
for (int i = 0; i < slicedImgs.Count; i++)
{
    slicedImgs[i].Save($"slice_{i}.jpg", ImageFormat.Jpeg);
}

8. 无锁加载图片

// 避免文件锁定，安全加载图片
Image img = "test.jpg".LoadImgNoLock();
if (img != null)
{
    img.Save("unlocked.jpg", ImageFormat.Jpeg);
}

API 参考

扩展方法（所有方法均为 Image/Bitmap/string 扩展方法）

注意事项

1. 依赖：该类库基于 System.Drawing，需确保项目引用 System.Drawing.Common 包（.NET Framework 已内置，.NET Core/.NET 5+ 需手动安装）。
2. 资源释放：使用图片对象后建议手动释放（Dispose()），避免内存泄漏。
3. 异常处理：部分方法包含基础异常捕获，建议业务层增加额外的异常处理逻辑。
4. 格式支持：默认优先处理 JPEG 格式，支持 GIF/PNG/BMP 等格式的识别与转换。

版本历史

许可证

本项目采用 MIT 许可证开源，详情请参考 LICENSE 文件。

问题反馈

如有 bug 或功能建议，请通过 GitHub Issues 反馈，或联系作者邮箱：[your-email@example.com]。