C# WPF 独立开发看图工具 PixSight 经验介绍（二）—— 水印模块开发实录

1. 前言上篇《C# WPF 独立开发看图工具 PixSight 经验介绍》介绍了整体技术架构、图片浏览/查看/编辑/OCR/格式转换以及几个最耗时的性能坑大图内存溢出、多格式兼容、启动速度、2000 图片假死、OCR 语言选择等。原文链接https://blog.csdn.net/weixin_53483426/article/details/162941010本文作为续篇记录最近新增的核心模块——「添加水印」。需求很朴素日常要把证件、材料照片发给别人时最怕被拿去乱用于是需要给图片批量铺上平铺文字水印含用途、限制等且要所见即所得、能一次处理一堆图。下面就从功能、原理到开发踩坑完整讲一遍重点依然是那些“文档里搜不到、只能自己踩出来”的坑。2. 功能介绍入口在主界面的「添加水印」。典型流程添加图片支持对话框多选也可从浏览视图直接选择带入→ 设置水印参数 →实时预览 → 批量保存到各自原目录同名自动加序号不覆盖原图。面向普通用户做了几处易用性处理字体下拉显示中文名微软雅黑 / 黑体 / 宋体 / 楷体 / 微软雅黑 UI…内部再映射到真正的字体名普通用户无需懂英文/拼音。颜色既可用预设色板红橙黄绿青蓝紫黑白灰也能点「取色」打开系统取色器完全不需要了解十六进制。参数改完自动持久化下次进入沿用上次设定。授权添加水印累计 50 次整批成功计 1 次足够日常使用超出后可购买激活码解锁。默认参数WatermarkOptions参数默认值说明水印文字Text空必填整段平铺文字例如“仅限办理XX业务使用”字体FontFamilyMicrosoft YaHei下拉显示中文名渲染用真实字体名字号FontSize00 按图宽自适应字号 图宽 / 27颜色ColorHex红色#FF0000可用取色器任意选不透明度Opacity45≈ alpha 115/255半透明不挡内容角度Angle30°整数度负值向左上倾斜行数Rows6纵向平铺密度参考常见证件照水印后缀OutputSuffix_水印输出文件名附加如 photo_水印.jpg3. 水印原理平铺整段文字而不是单字很多人以为“平铺水印”是让每个小瓦片只写一个字其实不是。本项目每个瓦片写的就是整段水印文字比如“仅限办理业务使用”。做法是先算出单个瓦片的尺寸文字宽 × 行高把整段文字栅格化到一张小透明瓦片上字体只栅格化一次把这张小瓦片整体旋转到目标角度只旋转一次然后在源图上按“旋转后的网格”逐块 Composite 这张小瓦片铺满整张图。因为旋转是线性变换逐块旋转放置等价于“先把整层旋转好再和原图合成”视觉上完全一致。预览图会先把长边限制到 1280px 降采样避免超大图旋转带来的内存/性能问题。4. 开发踩坑总结4.1 超大旋转画布的性能灾难最耗时的一坑最初的直观写法建一张覆盖整张图的巨大透明层 → 在上面写好所有文字 → 把整层旋转 → 裁切 → 放大回原图尺寸 → 再和原图整体合成。问题在水印是斜铺的要覆盖原图四角这张“巨大透明层”必须比原图大不少约 1.4 倍对角线。在 6000×4000 原图上这一步要 6~11 秒/张批量几百张根本没法用。新方案关键思路完全不创建超大画布、不做放大上采样。文字栅格化到一张几十~几百像素的小瓦片 → 旋转瓦片一次 → 直接在源图上按“旋转后的网格”逐块合成小瓦片一张图约 100 次廉价操作。速度提升一个数量级以上效果肉眼无差别。核心网格合成代码如下// 直接在源图上按“旋转后的网格”逐块合成小瓦片不再建超大画布 // 旋转矩阵与 Magick Rotate(angle) 一致图像坐标系 y 向下正角顺时针 // x cx ux·cosθ - uy·sinθ // y cy ux·sinθ uy·cosθ double rad angle * Math.PI / 180.0; double cosR Math.Cos(rad); double sinR Math.Sin(rad); int tw (int)rotated.Width, th (int)rotated.Height; double cx W / 2.0, cy H / 2.0; // 覆盖范围取旋转后外接矩形在网格空间的半幅 余量确保整图被覆盖 double absCos Math.Abs(cosR), absSin Math.Abs(sinR); int halfX (int)((W * absCos H * absSin) / 2.0) stepX; int halfY (int)((W * absSin H * absCos) / 2.0) stepY; int nx (int)(halfX / (double)stepX) 1; int ny (int)(halfY / (double)stepY) 1; for (int ix -nx; ix nx; ix) { for (int iy -ny; iy ny; iy) { double ux ix * stepX, uy iy * stepY; double rx ux * cosR - uy * sinR; double ry ux * sinR uy * cosR; int px (int)(cx rx - tw / 2.0); int py (int)(cy ry - th / 2.0); src.Composite(rotated, px, py, CompositeOperator.Over); } }4.2 Magick.NET Q16 下颜色变“暗红”的坑用 new MagickColor((byte)255, 0, 0) 想画纯红结果出来是暗红肉眼都能看出不对。原因是本项目用的是 Q16 版本16 位色深Quantum 范围 0~65535而 new MagickColor(byte,byte,byte) 这个构造函数会把 0~255 当作 Quantum 的“小值”直接填进去没有映射到 Quantum 全范围于是红色被压到很暗。修复用 MagickColor.FromRgb(r, g, b)它会正确地把 0~255 映射到 Quantum 全范围。同理不透明度也统一在合成水印层时用 Evaluate(Channels.Alpha, Multiply, alpha) 处理保证整层一致// Q16 下 new MagickColor(byte,byte,byte) 会把 255 当成 Quantum 小值导致颜色极暗 // 必须用 FromRgb 才能将 0-255 正确映射到 Quantum 全范围。 var opaqueColor MagickColor.FromRgb(r, g, b); // 在小瓦片上统一处理不透明度平铺后整体一致 double alphaFactor opacity / 100.0; if (alphaFactor 1.0) tile.Evaluate(Channels.Alpha, EvaluateOperator.Multiply, alphaFactor);4.3 中文与字体名处理ImageMagick 不吃「微软雅黑」这种中文显示名它要么认字体名Microsoft YaHei要么认字体文件路径。另外反复枚举 MagickNET.FontFamilies 会触发字体缓存重建偶发卡顿甚至异常。本项目的解法下拉用 FontOption 类Name 显示中文名给用户看Family 存真实字体名供渲染选中后再把 Family 写回渲染参数。ResolveFont 优先到 Windows\Fonts 找字体文件路径微软雅黑→msyh.ttc[0]、黑体→simhei.ttf 等绕过 ImageMagick 的字体名缓存都找不到才回退到字体名字符串。字体列表用 Lazy 只枚举一次避免反复触发缓存重建。// 字体选项Name中文显示名给用户看Family真实字体名供渲染 public class FontOption { public string Name { get; set; } public string Family { get; set; } } // 在 Windows 字体目录中查找字体文件优先 .ttf再 .ttc/.otf // .ttc 集合字体加 [0] 帮助 ImageMagick 选第一个 private static string FindFontFile(params string[] names) { string fontsDir Path.Combine( Environment.GetFolderPath(Environment.SpecialFolder.Windows), Fonts); foreach (var name in names) { string lower name.ToLowerInvariant(); string[] candidates; if (lower.Contains(yahei) || lower.Contains(微软雅黑)) candidates new[] { msyh.ttc, msyh.ttc[0], msyhbd.ttc, msyhl.ttc }; else if (lower.Contains(heiti) || lower simhei) candidates new[] { simhei.ttf, simhei.ttc, simhei.ttc[0] }; else if (lower.Contains(sun) || lower simsun) candidates new[] { simsun.ttc, simsun.ttc[0], simsunb.ttf }; else if (lower.Contains(kai) || lower kaiti) candidates new[] { simkai.ttf }; else if (lower arial) candidates new[] { arial.ttf }; else if (lower times new roman) candidates new[] { times.ttf, timesbd.ttf }; else candidates new[] { ${lower}.ttf, ${lower}.ttc[0], ${lower}.ttc, ${lower}.otf }; foreach (var c in candidates) { string raw c.Contains([) ? c.Substring(0, c.IndexOf([)) : c; string full Path.Combine(fontsDir, raw); if (File.Exists(full)) return Path.Combine(fontsDir, c); } } return null; }4.4 预览与保存分离 防抖/取消预览RenderPreview不写盘且长边限 1280px 降采样保存ApplyAndSave才真正落盘。难点在于拖动滑块时如果每次都重渲染队列会堆积导致界面假死。处理手段参数变更走 200ms 防抖停手后才重建一次预览并后台持久化默认参数预览在后台 Task.Run 渲染每次请求带递增 token旧的请求完成后若 token 已过期就丢弃结果避免乱序/堆积角度/不透明度/行数这类滑块拖动过程中只更新数字松手CommitSliderChange才触发一次预览重建避免持续重渲染。// 防抖停手 200ms 后才重建预览 持久化默认参数 _debounceTimer new DispatcherTimer { Interval TimeSpan.FromMilliseconds(200) }; _debounceTimer.Tick (s, e) { _debounceTimer.Stop(); RebuildPreview(); Task.Run(() PersistDefaults()); }; // 重建预览后台渲染 token 取消陈旧任务避免队列堆积假死 private void RebuildPreview() { var item CurrentItem; if (item null) { PreviewImage null; return; } _previewCts?.Cancel(); // 取消上一次 _previewCts new CancellationTokenSource(); var cts _previewCts; int token _previewToken; // 递增 token Task.Run(() { var (bmp, error) ServiceLocator.Watermark.RenderPreview(item.SourcePath, opt); lock (_previewLock) { if (token ! _previewToken) return; // 已被新请求接管丢弃 } Application.Current?.Dispatcher?.Invoke(() { if (cts.IsCancellationRequested) return; if (bmp ! null) PreviewImage bmp; else StatusText $预览失败{error}; }); }, cts.Token); }4.5 批量保存的并发与授权额度保存阶段逐张并行限制并发 3既利用多核又避免内存峰值过高MagickImage 各实例独立、线程安全。原格式不可写水印时自动回退 PNG/JPG。授权额度按“整批”计只有整批全部成功才扣 1 次中途失败不扣符合用户预期。4.6 顺带填的坑清理 ImageMagick 临时文件Magick.NET 处理超大图时像素缓存可能溢出到 %TEMP% 的 magick-* 文件无扩展名。程序正常退出会释放但若强关/中断这些文件会遗留——曾一次堆积 40GB 占满系统盘。于是在 App 启动时加了一段自清理删除「最后写入早于 5 分钟前、且当前没被占用独占打开失败」的孤儿文件单文件失败跳过、整体异常兜底绝不阻塞启动。5. 软件获取与授权更新本工具提供 30 天免费试用正式授权为一次性买断无年费正式版与试用版是同一程序首次运行即 30 天试用激活后转为正式版。相比上篇授权项增加「添加水印累计 50 次」整批成功计 1 次。激活采用「机器码 激活码」方式一台机器对应一个授权便于离线使用。获取方式请关注作者后续动态同前篇网盘链接。6. 结尾水印模块从“想要”到“好用”最值钱的经验是平铺水印不要建超大旋转画布改成「小瓦片旋转一次 网格逐块合成」以及 Magick.NET Q16 下务必用 FromRgb 设色。后续会持续更新文章、迭代功能欢迎开发同行交流 WPF 图像开发相关问题。