ASP.NET 圖片浮水印元件完整實作（支援透明度、位置、多格式）

功能特色

• 支援主流圖片格式：JPG、PNG、GIF、BMP、TIFF、WMF、ICO。
• 水印圖片可設定透明度（0~100%）、右下角偏移座標。
• 可選擇覆蓋原檔或輸出新檔，自動保留原圖格式。
• 使用 ColorMatrix 實作 Alpha 混合，效能佳、品質高。

核心類別：PicMark

public class PicMark {
    public string ModifyImagePath { get; set; }   // 來源圖片路徑
    public string DrawedImagePath { get; set; }   // 水印圖片路徑
    public int RightSpace { get; set; }           // 距右邊界像素
    public int BottomSpace { get; set; }          // 距下邊界像素
    public int LucencyPercent { get; set; } = 70; // 透明度 0-100
    public string OutPath { get; set; }           // 輸出路徑，null 覆蓋原檔

    public void DrawImage() { ... }
}

使用範例

// 前台上傳
<asp:FileUpload ID="fuImg" runat="server" />
<asp:Button ID="btnMark" Text="加浮水印" OnClick="btnMark_Click" />

// 後台處理
protected void btnMark_Click(object sender, EventArgs e) {
    string ext = Path.GetExtension(fuImg.FileName).ToUpper();
    string fileName = Guid.NewGuid().ToString("N") + ext;
    string savePath = Server.MapPath("~/upfile/" + fileName);

    Directory.CreateDirectory(Path.GetDirectoryName(savePath));
    fuImg.SaveAs(savePath);

    var wm = new PicMark {
        ModifyImagePath = savePath,
        DrawedImagePath = Server.MapPath("~/upfile/backlogo.gif"),
        RightSpace = 145,
        BottomSpace = 17,
        LucencyPercent = 50,
        OutPath = Server.MapPath("~/upfile/" + fileName + "_wm" + ext)
    };
    wm.DrawImage();

    // 刪除原始上傳檔，保留加浮水印後的檔案
    if (File.Exists(savePath)) File.Delete(savePath);
}

關鍵技術細節

ColorMatrix 透明度混合

float[][] matrix = {
    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, lucency/100f, 0}, // Alpha 縮放
    new float[] {0, 0, 0, 0, 1}
};
ColorMatrix cm = new ColorMatrix(matrix);
ImageAttributes attr = new ImageAttributes();
attr.SetColorMatrix(cm, ColorMatrixFlag.Default, ColorAdjustType.Bitmap);

g.DrawImage(watermark, destRect, 0, 0, wm.Width, wm.Height, GraphicsUnit.Pixel, attr);

Alpha 值 1.0 = 完全不透明，0.0 = 完全透明。lucency/100f 直接對應使用者設定的百分比。

格式自動偵測與儲存

string[] allow = { ".jpg", ".gif", ".png", ".bmp", ".tif", ".wmf", ".ico" };
ImageFormat fmt = ImageFormat.Gif; // 預設
switch (ext.ToLower()) {
    case ".jpg": fmt = ImageFormat.Jpeg; break;
    case ".png": fmt = ImageFormat.Png; break;
    // ...
}

// 先存 MemoryStream 再寫檔，避免 GDI+ 通用錯誤
using (MemoryStream ms = new MemoryStream()) {
    img.Save(ms, fmt);
    byte[] data = ms.ToArray();
    // 寫入 FileStream
}

資源釋放模式

• 所有 Image、Graphics、Stream 均在 finally 區塊呼叫 Dispose()。
• 儲存前先 Dispose 來源 Image，釋放檔案鎖定，才能覆蓋寫入。

擴充建議

1. 文字水印：取消註解程式碼中的 G.DrawString 區段，加入字型、顏色、陰影參數。
2. 多水印疊加：DrawImage 回傳 Bitmap，支援鏈式呼叫疊加多層水印。
3. 非同步處理：大量上傳時，將水印邏輯移至 Task.Run 或背景佇列（Hangfire/Quartz）。
4. 雲端儲存：OutPath 改為 Stream 參數，直接上傳至 Azure Blob / AWS S3。

常見問題