萬盛學電腦網

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

C# 圖片加浮水印完整實作指南

前言

圖片浮水印是保護版權、品牌曝光的常用手段。本文提供一個通用的 Watermarker 類別,支援:

  • 圖片水印 (Logo、QR Code 等)
  • 文字水印 (版權聲明、用戶 ID、時間戳)
  • 九宮格位置 / 自定義座標 / 平鋪模式
  • 透明度、旋轉、縮放比例
  • 高品質輸出與記憶體安全

核心介面設計

public enum WatermarkPosition
{
    TopLeft, TopCenter, TopRight,
    MiddleLeft, Center, MiddleRight,
    BottomLeft, BottomCenter, BottomRight,
    Custom, Tile // 平鋪
}

public class WatermarkOptions
{
    public Image WatermarkImage { get; set; }        // 圖片水印 (二擇一)
    public string WatermarkText { get; set; }        // 文字水印
    public Font TextFont { get; set; } = new Font("Microsoft JhengHei", 24, FontStyle.Bold);
    public Color TextColor { get; set; } = Color.White;
    public int Opacity { get; set; } = 50;           // 0-100
    public WatermarkPosition Position { get; set; } = WatermarkPosition.BottomRight;
    public Point CustomOffset { get; set; } = Point.Empty;
    public float Rotation { get; set; } = 0f;        // 角度
    public float Scale { get; set; } = 1f;           // 水印相對目標圖寬度比例
    public bool Tile { get; set; } = false;          // 是否平鋪
}

完整實作 (基於 System.Drawing.Common)

using System;
using System.Drawing;
using System.Drawing.Drawing2D;
using System.Drawing.Imaging;
using System.IO;

public static class Watermarker
{
    public static void Apply(string sourcePath, string destPath, WatermarkOptions opts)
    {
        using (Image src = Image.FromFile(sourcePath))
        using (Bitmap canvas = new Bitmap(src.Width, src.Height, PixelFormat.Format32bppArgb))
        using (Graphics g = Graphics.FromImage(canvas))
        {
            g.CompositingQuality = CompositingQuality.HighQuality;
            g.SmoothingMode = SmoothingMode.HighQuality;
            g.InterpolationMode = InterpolationMode.HighQualityBicubic;
            g.DrawImage(src, 0, 0, src.Width, src.Height);

            // 準備水印圖片
            Image wmImg = null;
            if (opts.WatermarkImage != null)
            {
                wmImg = opts.WatermarkImage;
            }
            else if (!string.IsNullOrEmpty(opts.WatermarkText))
            {
                wmImg = CreateTextWatermark(opts.WatermarkText, opts.TextFont, opts.TextColor, src.Width);
            }

            if (wmImg != null)
            {
                DrawWatermark(g, src.Width, src.Height, wmImg, opts);
            }

            // 儲存
            SaveWithQuality(canvas, destPath, src.RawFormat);
        }
    }

    private static Image CreateTextWatermark(string text, Font font, Color color, int maxWidth)
    {
        // 先量測文字大小
        using (Bitmap tmp = new Bitmap(1, 1))
        using (Graphics g = Graphics.FromImage(tmp))
        {
            SizeF sz = g.MeasureString(text, font);
            int w = (int)Math.Ceiling(sz.Width);
            int h = (int)Math.Ceiling(sz.Height);
            Bitmap bmp = new Bitmap(w, h, PixelFormat.Format32bppArgb);
            using (Graphics gg = Graphics.FromImage(bmp))
            {
                gg.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAliasGridFit;
                using (SolidBrush brush = new SolidBrush(color))
                    gg.DrawString(text, font, brush, 0, 0);
            }
            return bmp;
        }
    }

    private static void DrawWatermark(Graphics g, int srcW, int srcH, Image wm, WatermarkOptions o)
    {
        // 計算水印繪製尺寸
        float scale = o.Scale;
        if (scale <= 0) scale = 0.2f; // 預設佔寬 20%
        int wmW = (int)(srcW * scale);
        int wmH = (int)(wm.Height * (wmW / (float)wm.Width));

        // 旋轉處理:建立旋轉後的水印圖片
        Image finalWm = wm;
        if (o.Rotation != 0)
        {
            finalWm = RotateImage(wm, o.Rotation, wmW, wmH);
            wmW = finalWm.Width;
            wmH = finalWm.Height;
        }

        // 透明度色彩矩陣
        float alpha = o.Opacity / 100f;
        ColorMatrix cm = new ColorMatrix(new float[][]
        {
            new float[]{1,0,0,0,0},
            new float[]{0,1,0,0,0},
            new float[]{0,0,1,0,0},
            new float[]{0,0,0,alpha,0},
            new float[]{0,0,0,0,1}
        });
        ImageAttributes ia = new ImageAttributes();
        ia.SetColorMatrix(cm, ColorMatrixFlag.Default, ColorAdjustType.Bitmap);

        // 計算位置
        var positions = CalculatePositions(srcW, srcH, wmW, wmH, o);

        foreach (Point pt in positions)
        {
            g.DrawImage(finalWm,
                new Rectangle(pt.X, pt.Y, wmW, wmH),
                0, 0, finalWm.Width, finalWm.Height,
                GraphicsUnit.Pixel, ia);
        }

        if (finalWm != wm) finalWm.Dispose();
    }

    private static Image RotateImage(Image img, float angle, int targetW, int targetH)
    {
        Bitmap bmp = new Bitmap(targetW, targetH, PixelFormat.Format32bppArgb);
        using (Graphics gg = Graphics.FromImage(bmp))
        {
            gg.TranslateTransform(targetW / 2f, targetH / 2f);
            gg.RotateTransform(angle);
            gg.TranslateTransform(-targetW / 2f, -targetH / 2f);
            gg.DrawImage(img, new Rectangle(0, 0, targetW, targetH));
        }
        return bmp;
    }

    private static System.Collections.Generic.IEnumerable CalculatePositions(int srcW, int srcH, int wmW, int wmH, WatermarkOptions o)
    {
        if (o.Tile || o.Position == WatermarkPosition.Tile)
        {
            for (int y = -wmH; y < srcH + wmH; y += wmH)
                for (int x = -wmW; x < srcW + wmW; x += wmW)
                    yield return new Point(x, y);
        }
        else
        {
            int x = 0, y = 0;
            switch (o.Position)
            {
                case WatermarkPosition.TopLeft: x = 10; y = 10; break;
                case WatermarkPosition.TopCenter: x = (srcW - wmW) / 2; y = 10; break;
                case WatermarkPosition.TopRight: x = srcW - wmW - 10; y = 10; break;
                case WatermarkPosition.MiddleLeft: x = 10; y = (srcH - wmH) / 2; break;
                case WatermarkPosition.Center: x = (srcW - wmW) / 2; y = (srcH - wmH) / 2; break;
                case WatermarkPosition.MiddleRight: x = srcW - wmW - 10; y = (srcH - wmH) / 2; break;
                case WatermarkPosition.BottomLeft: x = 10; y = srcH - wmH - 10; break;
                case WatermarkPosition.BottomCenter: x = (srcW - wmW) / 2; y = srcH - wmH - 10; break;
                case WatermarkPosition.BottomRight: x = srcW - wmW - 10; y = srcH - wmH - 10; break;
                case WatermarkPosition.Custom: x = o.CustomOffset.X; y = o.CustomOffset.Y; break;
            }
            yield return new Point(Math.Max(0, x), Math.Max(0, y));
        }
    }

    private static void SaveWithQuality(Image img, string path, ImageFormat originalFormat)
    {
        string ext = Path.GetExtension(path).ToLowerInvariant();
        if (ext == ".jpg" || ext == ".jpeg")
        {
            var jpeg = GetEncoder("image/jpeg");
            if (jpeg != null)
            {
                var ep = new EncoderParameters(1);
                ep.Param[0] = new EncoderParameter(Encoder.Quality, 90L);
                img.Save(path, jpeg, ep);
                return;
            }
        }
        img.Save(path, originalFormat);
    }

    private static ImageCodecInfo GetEncoder(string mime) =>
        Array.Find(ImageCodecInfo.GetImageEncoders(), c => c.MimeType == mime);
}

使用範例

// 圖片水印
Watermarker.Apply("photo.jpg", "photo_wm.jpg", new WatermarkOptions
{
    WatermarkImage = Image.FromFile("logo.png"),
    Position = WatermarkPosition.BottomRight,
    Opacity = 60,
    Scale = 0.15f
});

// 文字水印 + 旋轉 + 平鋪
Watermarker.Apply("doc.pdf.png", "doc_wm.png", new WatermarkOptions
{
    WatermarkText = "CONFIDENTIAL - User123",
    TextFont = new Font("Arial", 36, FontStyle.Bold),
    TextColor = Color.FromArgb(255, 200, 200, 200),
    Opacity = 15,
    Rotation = -30,
    Tile = true
});

ASP.NET Core 中介軟體整合範例

[HttpPost("upload")]
public async Task Upload(IFormFile file)
{
    using (var ms = new MemoryStream())
    {
        await file.CopyToAsync(ms);
        ms.Position = 0;
        byte[] watermarked = Watermarker.GenerateToBytes(ms, 1200, 1200, new WatermarkOptions
        {
            WatermarkText = $"© {DateTime.Now:yyyy} MyApp",
            Position = WatermarkPosition.BottomRight,
            Opacity = 40
        });
        return File(watermarked, "image/jpeg", "watermarked_" + file.FileName);
    }
}

遷移至 ImageSharp (跨平台)

// ImageSharp 版本片段
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.Processing;
using SixLabors.ImageSharp.PixelFormats;
using SixLabors.Fonts;

public static Image ApplyWatermarkSharp(Image source, WatermarkOptions opts)
{
    var watermark = opts.WatermarkImage != null
        ? Image.Load(opts.WatermarkImage.Path)
        : CreateTextImageSharp(opts.WatermarkText, opts.TextFont, opts.TextColor);

    source.Mutate(ctx =>
    {
        float alpha = opts.Opacity / 100f;
        if (opts.Tile)
        {
            ctx.DrawImage(watermark, new Point(0,0), new GraphicsOptions { BlendPercentage = alpha });
            // 平鋪需自行迴圈計算位置
        }
        else
        {
            Point loc = CalculatePositionSharp(source.Width, source.Height, watermark.Width, watermark.Height, opts);
            ctx.DrawImage(watermark, loc, new GraphicsOptions { BlendPercentage = alpha });
        }
    });
    return source;
}
copyright © 萬盛學電腦網 all rights reserved