萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

C# 高品質縮略圖生成:保持清晰度與壓縮品質控制

需求背景

電商、CMS、相簿系統常需從原圖生成多種尺寸縮略圖。單純 GetThumbnailImage 品質差、無法控制壓縮率。本文實作高品質縮略圖生成器,支援:

  • 雙三次插值 (HighQualityBicubic) 保持銳度
  • JPEG 壓縮品質可調 (1-100)
  • 自動保持原圖格式或統一輸出 JPEG
  • 正確釋放非受控資源

核心實作

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;
        }
    }
}

使用範例

進階:串流版本 (適合 Web 上傳即時處理)

跨平台遷移建議 (.NET Core / Linux / Docker)

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 + BicubicWindows高中中
ImageSharp (Lanczos3)跨平台極高較慢低
SkiaSharp跨平台極高快低
Magick.NET (ImageMagick)跨平台最高快中
copyright © 萬盛學電腦網 all rights reserved