萬盛學電腦網

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

ASP.NET 文字浮水印產生器 (GDI+ 繪圖實作)

運作原理

建立一個獨立 `.aspx` (或 `.ashx`),接收圖片路徑、浮水印文字、字體、位置、透明度等參數,使用 `System.Drawing` 繪製文字於圖片上,直接輸出二進位影像串流 (`image/jpeg`),`` 即可嵌入頁面。

完整 Generic Handler 實作 (Watermark.ashx)

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

public class WatermarkHandler : IHttpHandler
{
    public bool IsReusable => false;

    public void ProcessRequest(HttpContext context)
    {
        // 1. 參數解析與驗證
        string imgPath = context.Request.QueryString["img"];
        string text = context.Request.QueryString["text"] ?? "Copyright";
        string fontName = context.Request.QueryString["font"] ?? "Microsoft JhengHei";
        int fontSize = int.TryParse(context.Request.QueryString["size"], out var fs) ? fs : 24;
        int x = int.TryParse(context.Request.QueryString["x"], out var px) ? px : 20;
        int y = int.TryParse(context.Request.QueryString["y"], out var py) ? py : 20;
        float opacity = float.TryParse(context.Request.QueryString["opacity"], out var op) ? Math.Clamp(op, 0, 1) : 0.5f;
        string colorHex = context.Request.QueryString["color"] ?? "FFFFFF";

        if (string.IsNullOrEmpty(imgPath)) { context.Response.StatusCode = 400; return; }

        string physicalPath = context.Server.MapPath(imgPath);
        if (!File.Exists(physicalPath)) { context.Response.StatusCode = 404; return; }

        // 2. 繪製浮水印
        using (var srcImg = Image.FromFile(physicalPath))
        using (var bmp = new Bitmap(srcImg.Width, srcImg.Height, PixelFormat.Format32bppArgb))
        using (var g = Graphics.FromImage(bmp))
        {
            g.InterpolationMode = System.Drawing.Drawing2D.InterpolationMode.HighQualityBicubic;
            g.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;
            g.TextRenderingHint = TextRenderingHint.AntiAliasGridFit;

            // 繪製原圖
            g.DrawImage(srcImg, 0, 0, srcImg.Width, srcImg.Height);

            // 繪製文字浮水印
            using (var font = new Font(fontName, fontSize, FontStyle.Bold, GraphicsUnit.Pixel))
            using (var brush = new SolidBrush(Color.FromArgb((int)(opacity * 255), ColorTranslator.FromHtml("#" + colorHex))))
            {
                g.DrawString(text, font, brush, x, y);
            }

            // 3. 輸出 JPEG
            context.Response.ContentType = "image/jpeg";
            context.Response.Cache.SetCacheability(HttpCacheability.Public);
            context.Response.Cache.SetMaxAge(TimeSpan.FromDays(30));
            var encoderParams = new EncoderParameters(1);
            encoderParams.Param[0] = new EncoderParameter(Encoder.Quality, 85L);
            var jpegCodec = GetEncoderInfo("image/jpeg");
            bmp.Save(context.Response.OutputStream, jpegCodec, encoderParams);
        }
    }

    private static ImageCodecInfo GetEncoderInfo(string mimeType)
    {
        return ImageCodecInfo.GetImageEncoders().FirstOrDefault(c => c.MimeType == mimeType);
    }
}

前端呼叫範例

<!-- 靜態參數 -->
<img src="Watermark.ashx?img=~/Images/photo.jpg&text=©2025 MyCompany&x=20&y=20&size=28&opacity=0.6&color=FF0000" />

<!-- 動態產生 (C#) -->
string url = $"Watermark.ashx?img={Server.UrlEncode("~/Images/photo.jpg")}" +
             $"&text={Server.UrlEncode("機密文件")}&x=50&y=100&size=32&opacity=0.4&color=0000FF";
imgWatermarked.ImageUrl = url;

效能優化建議

  • 快取輸出:相同參數組合產生相同圖片,啟用 `OutputCache` (VaryByParam="*") 或自行快取至記憶體/Redis。
  • 非同步處理:大量請求時改用 `IHttpAsyncHandler` 或 ASP.NET Core Middleware 避免阻塞執行緒。
  • 字體授權:確認伺服器安裝的字體具備商業使用授權,或改用開源字體 (Noto Sans TC, Source Han Sans)。
  • Linux/Docker 部署:安裝 `libgdiplus` 並掛載字體目錄,或改用跨平台庫 ImageSharp / SkiaSharp 完全移除 GDI+ 依賴。

進階:圖片浮水印 (Logo 疊加)

// 在 g.DrawImage(srcImg...) 之後加入
using (var logo = Image.FromFile(context.Server.MapPath("~/Images/logo.png")))
{
    int lx = bmp.Width - logo.Width - 10;
    int ly = bmp.Height - logo.Height - 10;
    g.DrawImage(logo, lx, ly, logo.Width, logo.Height); // 支援 PNG 透明通道
}
copyright © 萬盛學電腦網 all rights reserved