FIX 父子 ROI 检测系统说明

概述

父子 ROI 系统允许在一个大的检测区域（父 ROI）内划定若干小区域（子 ROI），并为每个子区域指定不同的检测策略。父 ROI 执行 AI 推理获得焊锡/空洞等分割结果后，子 ROI 可以选择继承、剪切或屏蔽父区域中属于自己的那部分结果。

典型场景：一块 PCB 焊盘上有若干芯片区域，希望对整块焊盘做统一推理，但对每个芯片区域采用不同的评判标准或检测方式。

四种角色

在 ROI 的右键菜单中，可以为选中的 ROI 设置以下角色：

Copy / Cut / Clear 三者互斥 — 一个子 ROI 只能选其中一种角色。

操作步骤

1. 设置父 ROI

1. 画一个覆盖整个检测区域的大 ROI
2. 右键点击该 ROI → 在菜单中勾选 推理 ROI（父）
3. 该 ROI 底部会显示 "inference" 标签

2. 设置子 ROI

1. 在父 ROI 内部画一个或多个小 ROI（子 ROI 必须完全在父 ROI 范围内）
2. 右键点击子 ROI → 根据需求选择：
   • 复制继承 ROI（子） — 复制继承
   • 剪切继承 ROI（子） — 剪切继承
   • 清除继承 ROI（子） — 清除屏蔽
3. 子 ROI 底部会分别显示"复制继承"、"剪切继承"或"清除继承"标签

3. 通过 Tab 面板设置（替代方式）

在检测参数的 General Tab 中，也可以通过复选框设置：

• Inference ROI — 勾选设为父 ROI
• Copy Inherit ROI — 勾选设为 Copy 子
• Cut Inherit ROI — 勾选设为 Cut 子
• Clear Inherit ROI — 勾选设为 Clear 子
• Hide Inference Labels — 隐藏底部标签

Tab 中 Copy / Cut / Clear 同样互斥，勾选一个会自动取消其他两个。

工作原理

检测顺序

系统按以下顺序执行检测：

1. 父 ROI 执行 AI 推理，获得焊锡/空洞分割结果
2. 根据子 ROI 类型处理父的分割结果：
   - Cut 子区域  → 从父结果中清零
   - Clear 子区域 → 从父结果中清零
   - Copy 子区域  → 父结果保持不变
3. 父 ROI 在处理后的结果上执行完整检测（焊锡率、空洞率、QFN 等）
4. 子 ROI 按类型获取各自的结果：
   - Copy 子 → 从父的原始结果中拷贝自己区域的数据，执行独立检测
   - Cut 子  → 从父的原始结果中拷贝自己区域的数据，执行独立检测
   - Clear 子 → 不做任何检测，完全跳过

三种子角色的区别

用一个直观的比喻：父 ROI 的推理结果是一张完整的图。

选择指南

• 需要父和子分别检测同一区域，各自出结果 → 用 复制继承
• 需要把区域从父中剥离出来，由子单独检测 → 用 剪切继承
• 需要完全忽略某个区域，不产生任何检测结果 → 用 清除继承

注意事项

1. 子 ROI 必须在父 ROI 内部 — 系统通过几何包含关系自动识别父子关系，子 ROI 的范围必须完全落在父 ROI 之内。

2. 父 ROI 必须勾选"推理 ROI（父）" — 只有标记为 Inference ROI 的 ROI 才会被识别为父。

3. 子 ROI 不执行 AI 推理 — 所有子 ROI（Copy / Cut / Clear）都不会单独执行 AI 推理，它们的数据来源于父 ROI 的推理结果。

4. 每个子 ROI 只能选一种角色 — Copy、Cut、Clear 三者互斥，勾选一个会自动取消其他两个。

5. Clear 子完全不产生检测结果 — 不会出现在检测报告中。适合用于标记连接器、散热片等非检测区域。

6. 子 ROI 可以设置独立的检测参数 — Copy 和 Cut 子虽然从父继承推理数据，但可以设置不同的焊锡率标准、空洞率标准等评判参数，实现同一推理结果下的差异化评判。

7. Mask as Non-Object / Mask as Non-Void 仍然可用 — 这些遮罩功能与父子 ROI 系统独立，可以组合使用。