萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 在圖片上加浮水印文字完整實作 (HttpHandler + GDI+)

前言

透過 IHttpHandler 攔截圖片請求,在伺服器端以 GDI+ 繪製浮水印後再輸出,可實現「不修改原圖、動態加浮水印、支援快取」的保護機制。本文提供完整可用的 ImageHandler.ashx 實作,涵蓋多種圖片格式、索引色處理、浮水印位置/字型/透明度設定。

一、完整 Handler 程式碼

<%@ WebHandler Language="C#" Class="ImageHandler" %>
using System;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Drawing.Imaging;
using System.IO;
using System.Web;

public class ImageHandler : IHttpHandler
{
    public bool IsReusable => true;

    public void ProcessRequest(HttpContext context)
    {
        string physicalPath = context.Request.PhysicalPath;
        if (!File.Exists(physicalPath))
        {
            context.Response.StatusCode = 404;
            context.Response.End();
            return;
        }

        // 1. 設定輸出 Content-Type
        context.Response.ContentType = GetContentType(physicalPath);
        // 2. 可選:設定快取 (ETag/Last-Modified)
        context.Response.Cache.SetCacheability(HttpCacheability.Public);
        context.Response.Cache.SetLastModified(File.GetLastWriteTimeUtc(physicalPath));

        // 3. 產生含浮水印的圖片位元組
        byte[] watermarked = AddWatermark(physicalPath, context);

        // 4. 輸出
        context.Response.BinaryWrite(watermarked);
    }

    private byte[] AddWatermark(string imagePath, HttpContext context)
    {
        string watermarkText = "浮水印文字"; // 可從 config/DB 讀取
        Font font = new Font("微軟雅黑", 18, FontStyle.Bold);
        Color watermarkColor = Color.FromArgb(128, 255, 0, 0); // 半透明紅
        StringAlignment align = StringAlignment.Far; // 右下角

        using (Image original = Image.FromFile(imagePath))
        {
            // 處理索引色圖片 (GIF/8bpp PNG) 無法直接建立 Graphics
            Image workingImage = original;
            if (IsIndexedPixelFormat(original.PixelFormat))
            {
                workingImage = new Bitmap(original.Width, original.Height, PixelFormat.Format32bppArgb);
                using (Graphics g = Graphics.FromImage(workingImage))
                    g.DrawImage(original, 0, 0, original.Width, original.Height);
            }

            using (Graphics g = Graphics.FromImage(workingImage))
            {
                g.SmoothingMode = SmoothingMode.AntiAlias;
                g.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit;

                // 計算浮水印尺寸
                SizeF textSize = g.MeasureString(watermarkText, font);
                float margin = 10;
                float x, y;

                // 九宮格定位邏輯 (此處示範右下)
                x = workingImage.Width - textSize.Width - margin;
                y = workingImage.Height - textSize.Height - margin;

                // 繪製陰影 (可選)
                using (Brush shadowBrush = new SolidBrush(Color.FromArgb(80, 0, 0, 0)))
                    g.DrawString(watermarkText, font, shadowBrush, x + 2, y + 2);

                // 繪製主浮水印
                using (Brush brush = new SolidBrush(watermarkColor))
                    g.DrawString(watermarkText, font, brush, x, y);
            }

            // 輸出至 MemoryStream 保持原格式
            using (MemoryStream ms = new MemoryStream())
            {
                ImageFormat fmt = GetImageFormat(imagePath);
                workingImage.Save(ms, fmt);
                return ms.ToArray();
            }
        }
    }

    private bool IsIndexedPixelFormat(PixelFormat fmt)
    {
        return (fmt & PixelFormat.Indexed) != 0;
    }

    private string GetContentType(string path)
    {
        return Path.GetExtension(path).ToLowerInvariant() switch
        {
            ".bmp" => "image/bmp",
            ".gif" => "image/gif",
            ".jpg" => "image/jpeg",
            ".jpeg" => "image/jpeg",
            ".png" => "image/png",
            _ => "application/octet-stream"
        };
    }

    private ImageFormat GetImageFormat(string path)
    {
        return Path.GetExtension(path).ToLowerInvariant() switch
        {
            ".bmp" => ImageFormat.Bmp,
            ".gif" => ImageFormat.Gif,
            ".jpg" => ImageFormat.Jpeg,
            ".jpeg" => ImageFormat.Jpeg,
            ".png" => ImageFormat.Png,
            _ => ImageFormat.Png
        };
    }
}

二、Web.config 註冊 (IIS 7+ 整合模式)

<system.webServer>
  <handlers>
    <add name="ImageWatermarkHandler" path="*.jpg;*.jpeg;*.png;*.gif;*.bmp" verb="GET"
         type="ImageHandler" preCondition="integratedMode" />
  </handlers>
</system.webServer>

或針對特定資料夾:path="/WatermarkedImages/*.jpg"。

三、前端使用方式

<!-- 直接引用原圖路徑,Handler 自動攔截加浮水印 -->
<img src="/Images/Products/photo1.jpg" alt="產品圖" />

<!-- 若需原圖不加浮水印,可加查詢字串略過 -->
<img src="/Images/Products/photo1.jpg?nowm=1" alt="原圖" />

在 ProcessRequest 中檢查 context.Request.QueryString["nowm"] 若為 1 則直接 TransmitFile 原圖。

四、效能優化關鍵

  1. 記憶體快取:對相同圖片+相同浮水印參數的結果快取至 MemoryCache (Key: 檔案路徑+最後寫入時間+浮水印文字),避免重複 GDI+ 運算。
  2. 非同步 I/O:.NET 4.5+ 可改實作 IHttpAsyncHandler 或改用 ASP.NET Core Middleware。
  3. 輸出快取:設定 Cache.SetMaxAge、ETag,讓瀏覽器/CDN 快取結果。
  4. 字型快取:Font 物件建立昂貴,建議靜態唯讀單例。

五、常見問題排查

問題原因解決
GIF 透明背景變黑索引色無法直接 DrawString轉為 Format32bppArgb 再繪製 (程式碼已處理)
中文顯示方塊伺服器缺字型安裝「微軟雅黑」或改用系統保有字型 (Arial Unicode MS)
CPU 飆高大量並發即時繪圖啟用記憶體快取、限制並發、考慮預先批次產生
浮水印位置錯誤圖片 DPI 不同導致 Graphics 單位差異使用 g.PageUnit = GraphicsUnit.Pixel 統一像素座標

六、擴充:支援圖片浮水印 (Logo)

private void DrawImageWatermark(Graphics g, Image watermarkImg, Image target)
{
    float x = target.Width - watermarkImg.Width - 10;
    float y = target.Height - watermarkImg.Height - 10;
    // 設定透明度
    ImageAttributes attr = new ImageAttributes();
    ColorMatrix matrix = new ColorMatrix { Matrix33 = 0.5f }; // 50% 透明
    attr.SetColorMatrix(matrix);
    g.DrawImage(watermarkImg, new Rectangle((int)x, (int)y, watermarkImg.Width, watermarkImg.Height),
                0, 0, watermarkImg.Width, watermarkImg.Height, GraphicsUnit.Pixel, attr);
}
copyright © 萬盛學電腦網 all rights reserved