docs: document nonuniform stamp matching

2026-06-24 09:47:28 +08:00
parent 56e8907f28
commit f3e07b1e32
2 changed files with 78 additions and 8 deletions
@@ -1591,3 +1591,18 @@
 - [x] 找不到高可信结果时打印低分提示；不保存 CSV，不修改任何图片
 - [x] 支持命令行覆盖 `--image`、`--stamp-dir`、`--top`
 - [x] 验证：`python -m py_compile match_stamp.py` 通过；临时构造一张合并图和两个候选印花，Top 1 命中正确印花
+
+### 19.33 合并图印花匹配：宽高不等比例变形方案文档
+
+背景：
+
+实际合成衣服和印花时，印花可能不按原始宽高比缩放。例如原始印花 `1000x1000`，合成到衣服上时被设置为 `1000x800`。这种非等比例变形不是单一 `scale` 能覆盖的，当前脚本只做等比例多尺度搜索时匹配稳定性会下降。
+
+任务：
+
+- [x] 更新 `docs/12-stamp-template-matching.md`，明确 `matchTemplate` 对宽高不等比例变形敏感
+- [x] 将推荐方案扩展为“多尺度模板匹配 + 有限宽高比变形 + alpha mask + 边缘辅助分数”
+- [x] 明确不做完整 `scale_x × scale_y` 暴力搜索，优先用基础 `scale` 加少量 `aspect_y` 候选控制耗时
+- [x] 明确 `1000x1000 -> 1000x800` 可由 `scale_x=1.00`、`scale_y=0.80`、`aspect_y=0.80` 覆盖
+- [x] 更新输出字段建议：从单一 `scale` 改为 `scale_x`、`scale_y`、`aspect_y`
+- [x] 验证：文档路径、标题、示例和验收点检查通过