Clipper1/Clipper2 教程形态学内容优化设计

日期：2026-08-13
状态：已获用户批准（方案 B：就地优化，不动目录结构）
依据仓库：https://github.com/znlgis/Clipper1 、https://github.com/AngusJohnson/Clipper2

背景与目标

站点在 cad/（使用教程）与 sci/（源码解读）下各有 Clipper1、Clipper2 两个系列。现有教程对形态学（膨胀/腐蚀/开运算/闭运算）覆盖零散且存在错误。本任务依据两个 GitHub 仓库的最新状态，优化完善形态学相关内容，修正错误，保持各系列既有文风与目录结构。

腐蚀 ≠ 闵可夫斯基差。闵可夫斯基差 A ⊖ B = A ⊕ (−B) 用于碰撞检测；形态学腐蚀定义为 A ⊖ B = {x : x + B ⊆ A}，实现走补集法：A ⊖ B = (Aᶜ ⊕ Bʳ)ᶜ，其中 Bʳ 为 B 关于原点的反射，Aᶜ 为 A 在足够大包围盒内的补集。B 关于原点对称时 Bʳ = B。
偏移即特殊形态学。JoinType.Round 偏移对应圆盘结构元素，JoinType.Square 对应方形结构元素；Clipper2 的 InflatePaths/DeflatePaths 是偏移的简化 API。
形态学组合：开运算 = 先腐蚀后膨胀；闭运算 = 先膨胀后腐蚀；形态学梯度 = 膨胀 − 腐蚀（布尔差集）。
Clipper1 v6.4.2（znlgis/Clipper1 镜像）存在 Clipper.MinkowskiSum(Path pattern, Path path, bool pathIsClosed)、MinkowskiSum(Path pattern, Paths paths, bool pathIsClosed)、MinkowskiDiff(Path poly1, Path poly2)——已核对仓库源码确认。sci/Clipper1 第19章 19.4 的签名文档是正确的，无需修复，只补形态学内容。
Clipper2 当前 main 分支（已核对源码）：MinkowskiSum(PathD, PathD, bool, int precision) 旧签名已移除，现为 3 参版本（内部委托 Minkowski.Sum，其 PathD 重载带 decimalPlaces = 2 默认参数）；DeflatePaths 方法不存在，收缩用负 delta；ClipperOffset.Execute 在 Clipper1 是 Execute(ref Paths solution, double delta)，Clipper2 是 Execute(double delta, Paths64 solution)，参数顺序相反。

位置	问题
sci/Clipper2 第18章 18.6.3	Erode 用 `MinkowskiDiff` 实现，数学上错误；且实现残缺（注释"需要更复杂的处理"）
sci/Clipper2 第18章 18.3.1、18.8.3	`MinkowskiSum` PathD 版签名含已移除的 `precision` 参数（18.3.1 声明、18.8.3 调用 `..., true, 3`），与当前 main 分支不符
cad/Clipper2 第05章 5.3.7	标题为 C# 版但代码为 C++（`std::vector`、`const auto&`、`std::cout`）；且全章代码混用 `MinkowskiSum(...)` 裸调用与 `Clipper.` 前缀
各系列	形态学内容零散，未形成"膨胀/腐蚀/开/闭/梯度"完整框架；腐蚀公式缺失

第04章-多边形偏移操作.md：新增形态学小节（编号顺延插入）：膨胀/腐蚀（正负偏移）、开运算、闭运算、形态学梯度（差集）、结构元素选择（jtRound=圆盘、jtSquare=方形）、应用（小图斑剔除、窄桥断开、凹口填充、地图综合）。
第06章-实际应用案例与最佳实践.md：应用案例处轻量交叉引用形态学小节。
第01章-Clipper1概述与安装.md：补充 GitHub 仓库 znlgis/Clipper1 信息（SourceForge 镜像、含 Documentation 与 Clipper2 beta 目录）。

第04章-多边形偏移操作.md：新增形态学小节（InflatePaths/DeflatePaths + SimplifyPaths 迭代；可引用官方 README 兔子收缩示例）。
第05章-矩形裁剪与闵可夫斯基操作.md：修复 5.3.7 C++/C# 混用（统一为 C#）；将"形态学膨胀"扩充为完整小节：膨胀 = MinkowskiSum；腐蚀 = 补集法（附完整可运行 C# 实现，含取补集辅助函数）；开/闭运算；任意结构元素。
第01章-Clipper2概述与安装.md：补充官方 README 的三角剖分 bug 警告（一句话）。

第17章-ClipperOffset详解.md：新增小节：JoinType ↔ 结构元素对应关系（源码角度）。
第19章-辅助函数与工具.md：19.4 现有 MinkowskiSum/MinkowskiDiff 签名文档与 v6.4.2 一致（无需修复），补充 MinkowskiSum(Path, Paths, bool) 重载说明；新增小节：补集法腐蚀辅助函数 + 开闭运算实现。
第20章-实际应用与最佳实践.md：20.4.2 "先膨胀后收缩"标注为闭运算并扩充；新增形态学应用小节（开闭运算、梯度、地图综合）。

第16章-ClipperOffset偏移类详解.md：新增小节：JoinType ↔ 结构元素 + InflatePaths/DeflatePaths 简化 API 说明。
第18章-Minkowski和与差.md：修复 18.6.3 错误 Erode；18.6.3 扩充为完整形态学小节（补集法腐蚀完整实现、开闭运算、梯度、结构元素对称性简化）；修复 18.3.1/18.8.3 中已移除的 precision 参数。
第20章-实际应用与最佳实践.md：20.6.5 处交叉引用形态学小节。

匹配各系列现有文风：cad 教程 = 概念 + 代码 + 练习/小结；sci 解读 = 源码逐行 + 算法分析 + 注意事项。
新增代码全部为可运行 C#：sci/Clipper1 用 ClipperLib API；其余用 Clipper2Lib。
形态学小节统一结构：数学定义 → Clipper 实现 → 完整示例 → 应用场景 → 注意事项（自交、路径方向、缩放因子、结构元素选择）。
实现前核对 Clipper2 仓库 CSharp 源码中 InflatePaths、MinkowskiSum、MinkowskiDiff、PointInPolygon 等当前签名，保证教程与现仓库一致。