Galosys.Foundation.ImageSharp 26.7.31.1

Galosys.Foundation.ImageSharp

成熟度: 🟡 可用 — 功能完整，测试或文档可能不完善

基于 SixLabors.ImageSharp 的图像处理扩展库，提供图像加载、缩放、裁剪、格式转换、水印等常用功能。

功能概览

1. 图像加载与保存

using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Formats.Jpeg;
using SixLabors.ImageSharp.Formats.Png;

// 加载图像
using var image = await Image.LoadAsync("input.jpg");

// 保存为不同格式
await image.SaveAsync("output.png", new PngEncoder());
await image.SaveAsync("output.webp", new WebpEncoder { Quality = 80 });

2. 图像缩放

// 按比例缩放
image.Mutate(ctx => ctx.Resize(new ResizeOptions
{
    Size = new Size(800, 600),
    Mode = ResizeMode.Max
}));

// 指定宽高缩放（保持比例）
image.Mutate(ctx => ctx.Resize(400, 0)); // 宽度400，高度自适应

3. 图像裁剪

// 裁剪指定区域
image.Mutate(ctx => ctx.Crop(new Rectangle(100, 100, 400, 400)));

// 从中心裁剪
image.Mutate(ctx => ctx.Resize(new ResizeOptions
{
    Size = new Size(200, 200),
    Mode = ResizeMode.Crop
}));

4. 图像旋转与翻转

// 旋转指定角度
image.Mutate(ctx => ctx.Rotate(90));
image.Mutate(ctx => ctx.RotateRounded(45));

// 翻转
image.Mutate(ctx => ctx.FlipHorizontal());
image.Mutate(ctx => ctx.FlipVertical());

5. 添加水印

using SixLabors.ImageSharp.Drawing.Processing;
using SixLabors.Fonts;

// 添加文字水印
var font = SystemFonts.Get("Arial", 12);
image.Mutate(ctx => ctx.DrawText("Galosys", font, Color.White, new PointF(10, 10)));

// 添加图片水印
using var watermark = await Image.LoadAsync("logo.png");
image.Mutate(ctx => ctx.DrawImage(watermark, 0.5f));

6. 图像滤镜

using SixLabors.ImageSharp.Processing;

// 灰度
image.Mutate(ctx => ctx.Grayscale());

// 模糊
image.Mutate(ctx => ctx.GaussianBlur(5));

// 锐化
image.Mutate(ctx => ctx.GaussianSharpen(3));

// 亮度调整
image.Mutate(ctx => ctx.Brightness(1.2f));

// 对比度调整
image.Mutate(ctx => ctx.Contrast(1.1f));

7. 格式转换

// 获取图像信息（不加载完整图像）
var imageInfo = await Image.IdentifyAsync("input.jpg");
Console.WriteLine($"Width: {imageInfo.Width}, Height: {imageInfo.Height}");

// 转换为 Base64
using var ms = new MemoryStream();
await image.SaveAsPngAsync(ms);
var base64 = Convert.ToBase64String(ms.ToArray());

8. 生成缩略图

public static async Task<byte[]> GenerateThumbnailAsync(byte[] source, int width, int height)
{
    using var input = new MemoryStream(source);
    using var image = await Image.LoadAsync(input);
    
    image.Mutate(ctx => ctx.Resize(new ResizeOptions
    {
        Size = new Size(width, height),
        Mode = ResizeMode.Crop
    }));
    
    using var output = new MemoryStream();
    await image.SaveAsJpegAsync(output, new JpegEncoder { Quality = 80 });
    return output.ToArray();
}

安装

<PackageReference Include="Galosys.Foundation.ImageSharp" Version="x.x.x" />

目录结构

Galosys.Foundation.ImageSharp/
└── (依赖 SixLabors.ImageSharp 库)

依赖

• SixLabors.ImageSharp
• SixLabors.ImageSharp.Drawing
• Galosys.Foundation.Core