電商、CMS、相簿系統常需從原圖生成多種尺寸縮略圖。單純 GetThumbnailImage 品質差、無法控制壓縮率。本文實作高品質縮略圖生成器,支援:
HighQualityBicubic) 保持銳度using System;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Drawing.Imaging;
using System.IO;
namespace CLB.Utility.Tools
{
public static class ThumbnailGenerator
{
///
/// 生成高品質縮略圖
///
/// 原圖完整路徑
/// 輸出路徑
/// 最大寬度
/// 最大高度
/// JPEG 品質 1-100 (預設 80),其他格式忽略
public static void Generate(string sourcePath, string destPath, int maxWidth, int maxHeight, long jpegQuality = 80)
{
if (jpegQuality < 1 || jpegQuality > 100) jpegQuality = 80;
using (Image src = Image.FromFile(sourcePath))
{
// 計算目標尺寸 (等比例)
Size target = CalculateProportionalSize(maxWidth, maxHeight, src.Width, src.Height);
using (Bitmap canvas = new Bitmap(target.Width, target.Height))
using (Graphics g = Graphics.FromImage(canvas))
{
// 高品質繪圖設定
g.CompositingQuality = CompositingQuality.HighQuality;
g.SmoothingMode = SmoothingMode.HighQuality;
g.InterpolationMode = InterpolationMode.HighQualityBicubic;
g.PixelOffsetMode = PixelOffsetMode.HighQuality;
// 繪製
g.DrawImage(src, new Rectangle(0, 0, target.Width, target.Height),
0, 0, src.Width, src.Height, GraphicsUnit.Pixel);
// 儲存:優先嘗試 JPEG 編碼器控制品質
ImageCodecInfo jpegCodec = GetEncoderInfo("image/jpeg");
if (jpgCodec != null && (Path.GetExtension(destPath).Equals(".jpg", StringComparison.OrdinalIgnoreCase) ||
Path.GetExtension(destPath).Equals(".jpeg", StringComparison.OrdinalIgnoreCase)))
{
EncoderParameters ep = new EncoderParameters(1);
ep.Param[0] = new EncoderParameter(Encoder.Quality, jpegQuality);
canvas.Save(destPath, jpegCodec, ep);
}
else
{
// 非 JPEG 或找不到編碼器,用原格式或 PNG
ImageFormat fmt = src.RawFormat;
canvas.Save(destPath, fmt);
}
}
}
}
private static Size CalculateProportionalSize(int maxW, int maxH, int srcW, int srcH)
{
if (srcW <= maxW && srcH <= maxH) return new Size(srcW, srcH);
double ratio = Math.Min((double)maxW / srcW, (double)maxH / srcH);
return new Size((int)Math.Round(srcW * ratio), (int)Math.Round(srcH * ratio));
}
private static ImageCodecInfo GetEncoderInfo(string mimeType)
{
foreach (var codec in ImageCodecInfo.GetImageEncoders())
if (codec.MimeType == mimeType) return codec;
return null;
}
}
}
System.Drawing.Common 在非 Windows 平台有相依性問題。建議遷移至 ImageSharp:
// ImageSharp 範例
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.Formats.Jpeg;
public static byte[] GenerateSharp(Stream input, int maxW, int maxH, int quality = 80)
{
using (Image img = Image.Load(input))
{
img.Mutate(x => x.Resize(new ResizeOptions
{
Mode = ResizeMode.Max,
Size = new Size(maxW, maxH),
Sampler = KnownResamplers.Lanczos3 // 高品質濾波
}));
using (var ms = new MemoryStream())
{
img.Save(ms, new JpegEncoder { Quality = quality });
return ms.ToArray();
}
}
}
| 方案 | 平台 | 品質 | 速度 | 記憶體 |
|---|---|---|---|---|
| System.Drawing + Bicubic | Windows | 高 | 中 | 中 |
| ImageSharp (Lanczos3) | 跨平台 | 極高 | 較慢 | 低 |
| SkiaSharp | 跨平台 | 極高 | 快 | 低 |
| Magick.NET (ImageMagick) | 跨平台 | 最高 | 快 | 中 |