C# 使用 System.Drawing.Common (GDI+ wrapper) 進行圖片縮放、壓縮是常見需求。本文提供三種等級的實作:基本高品質縮放、等比例裁切縮放、可調品質 JPEG 壓縮。
public static Image ResizeImage(Image source, int width, int height)
{
var dest = new Bitmap(width, height);
using (var g = Graphics.FromImage(dest))
{
g.InterpolationMode = InterpolationMode.HighQualityBicubic;
g.SmoothingMode = SmoothingMode.HighQuality;
g.CompositingQuality = CompositingQuality.HighQuality;
g.PixelOffsetMode = PixelOffsetMode.HighQuality;
g.DrawImage(source, new Rectangle(0, 0, width, height));
}
return dest;
}
⚠️ 直接指定寬高會導致長寬比改變 (變形)。
public static Bitmap ResizeKeepAspect(Image source, Size targetSize, bool crop = true, Color? backColor = null)
{
double srcRatio = (double)source.Width / source.Height;
double dstRatio = (double)targetSize.Width / targetSize.Height;
int drawW, drawH, x = 0, y = 0;
if (srcRatio > dstRatio) // 來源較寬
{
drawH = targetSize.Height;
drawW = (int)(drawH * srcRatio);
if (crop) x = (targetSize.Width - drawW) / 2;
}
else // 來源較高
{
drawW = targetSize.Width;
drawH = (int)(drawW / srcRatio);
if (crop) y = (targetSize.Height - drawH) / 2;
}
var dest = new Bitmap(targetSize.Width, targetSize.Height);
using (var g = Graphics.FromImage(dest))
{
g.InterpolationMode = InterpolationMode.HighQualityBicubic;
g.SmoothingMode = SmoothingMode.HighQuality;
g.CompositingQuality = CompositingQuality.HighQuality;
g.PixelOffsetMode = PixelOffsetMode.HighQuality;
if (backColor.HasValue) g.Clear(backColor.Value);
g.DrawImage(source, new Rectangle(x, y, drawW, drawH),
new Rectangle(0, 0, source.Width, source.Height), GraphicsUnit.Pixel);
}
return dest;
}
crop=true:等比縮放後超出部分裁切 (適合縮圖)。crop=false:等比縮放置中,空白處填 backColor (適合商品圖)。public static void SaveJpegWithQuality(Image image, string path, long quality = 85L)
{
// quality: 1-100,建議 75-90 平衡大小/品質
var encoder = Encoder.Quality;
var params = new EncoderParameters(1);
params.Param[0] = new EncoderParameter(encoder, quality);
var jpegCodec = ImageCodecInfo.GetImageEncoders()
.First(c => c.FormatID == ImageFormat.Jpeg.Guid);
image.Save(path, jpegCodec, params);
}
using (var src = Image.FromFile(@"C:\Original\photo.jpg"))
{
// 產生 300x300 置中裁切縮圖,品質 80
var thumb = ResizeKeepAspect(src, new Size(300, 300), crop: true);
SaveJpegWithQuality(thumb, @"C:\Thumbs\photo_thumb.jpg", 80);
// 產生 800x600 留白縮圖,白底,品質 90
var preview = ResizeKeepAspect(src, new Size(800, 600), crop: false, backColor: Color.White);
SaveJpegWithQuality(preview, @"C:\Previews\photo_preview.jpg", 90);
}
Image.GetThumbnailImageAbort 或第三方庫 (ImageSharp、SkiaSharp) 串流處理。System.Drawing.Common 僅支援 Windows。Linux/Docker 請改用 ImageSharp 或 SkiaSharp。Image、Bitmap、Graphics 用完必須 Dispose() 或包在 using 中。// NuGet: SixLabors.ImageSharp
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.Formats.Jpeg;
using (var img = Image.Load("input.jpg"))
{
img.Mutate(x => x.Resize(new ResizeOptions
{
Size = new Size(300, 300),
Mode = ResizeMode.Crop // 等比裁切
}));
img.Save("output.jpg", new JpegEncoder { Quality = 80 });
}
ImageSharp 純 managed、跨平台、記憶體安全、API 現代,新專案首選。