【原创】图片批量加水印文本/图片，支持透明度，缩放比，位置

一款基于 C# WinForms + AntdUI 的本地批量图片水印工具，支持文本水印与 PNG 图片水印，可一次性为整个文件夹（含子目录）下的图片批量加盖水印，并支持位置、偏移、透明度、缩放等精细化控制。

运行环境：Windows + .NET 6.0（net6.0-windows）。界面语言：中文。

一、功能特点

二、使用优点

1. 本地离线、数据安全：纯本地运行，图片不离开本机，无云上传、无隐私泄露风险。
2. 批量高效：一个文件夹上千张图可一次处理，后台线程执行不卡界面。
3. 可随时停止：处理过程中点击“停止处理”即可中断，已处理的不回滚、未处理的保持不变。
4. 误操作有兜底：开启 *.bak 备份后，原图可随时找回。
5. 透明度准确：使用 CompositingQuality.AssumeLinear 线性合成，滑块 50% 即真正半透明，不受 Gamma 校正影响。
6. JPEG 友好：透明 PNG 水印叠加到 JPG 时自动铺白底，不会出现黑块。
7. 预览式参数回显：拖动滑块、切换位置即时在提示条看到最终生效值，所见即所得。
8. 冲突自动处理：水印图片若放目标目录内，会被自动排除，不会被自己“盖自己”。

三、使用方法

1. 启动

运行发布包中的可执行文件（或直接 dotnet run 调试）。

2. 设置水印内容（二选一）

• 文本水印：在“水印文本”框输入 2-30 个字符；用颜色选择器设定文字颜色（默认红色）；可填“字号(px)”，留空则按图片尺寸自适应。
• 图片水印：点击“选择水印图片”选取一张 PNG（建议自带透明通道）；用“不透明度”滑块调透明；勾选“高度等比缩放”并用滑块设定缩放百分比。

⚠ 文本和图片都填时，本次只使用图片水印，文本会被忽略（界面会提示）。

3. 设置位置与偏移

点击九宫格中任一位置按钮，输入偏移量（像素）。中心点无需偏移。

4. 选择目标

• 点击“选择文件夹”选定被加水印的目录；勾选“包含子目录”可递归处理。
• 勾选需要处理的目标类型：png / jpeg（至少一种）。
• 如需保险，勾选“加水印前备份 *.bak”。

5. 执行

点击“添加水印”，在确认框核对参数（方式 / 位置 / 偏移 / 不透明度 / 缩放 / 是否备份），点“确定”开始。 底部提示条实时显示进度（第 N / 总数），完成后汇总成功/失败张数。

四、注意事项

1. 备份优先：批量覆盖原图不可逆，首次使用或处理重要图片务必勾选 *.bak 备份。备份文件名如 photo.png.bak，恢复原图时删除 .bak 后缀即可。
2. 图片水印仅支持 PNG：需要透明背景，JPG 水印会被拒（界面会提示）。
3. 文本长度限制：2-30 个字符，否则会拦截并提示。
4. 透明度仅作用于图片水印：当前版本的“不透明度”滑块针对 PNG 图片水印；文本水印暂不支持透明度调节（如需半透明文字可改用半透明 PNG 水印图）。
5. 缩放只缩小不放大：滑块 100% 为保持原图；低于 100% 按比例缩小，避免小图被放大变糊。
6. 停止不会回滚：处理中点击“停止”后，已成功写入的图片不会撤销，请确认备份开关。
7. 中心点忽略偏移：选“中心”位置时，偏移量输入框不生效，水印水平垂直居中。
8. JPEG 白底处理：原图透明区域在导出 JPG 时会填白，若需保留透明请仅勾选 png。
9. 范围建议：偏移量 0-5000px，字号 8-400px，缩放 10-100%，超出会被自动钳制到合法区间。
10. 运行依赖：需目标机装有 .NET 6.0 运行时；AntdUI 控件在 Windows 下渲染最佳。

五、常见问题

• 水印图片被一起改了？ 不会。工具会自动排除你指定的水印 PNG 自身。
• 原图找不回来？ 检查是否勾选了备份；若勾选，在同目录找 原名.扩展名.bak。
• 透明度看着不对？ 确认用的是“图片水印”且滑块生效；文本水印无透明度选项（见注意事项第 4 条）。
• 处理失败？ 底部提示条会列出失败文件名与原因（如文件损坏、格式不支持），其余图片仍正常处理。