POI
POI 在当前系统里是一套共享点位原语,不是单个“检测算法”。它保存点集和模板配置,被布点、过滤、修正、分析、AOI、SFR 和 Flow 节点共同消费。
先查什么
| 现象 | 优先看 |
|---|---|
| 点位丢失 | PoiMasterDao / PoiDetailDao 是否有对应 Pid,LoadPoiDetailFromDB 是否回填 |
| 位置或 overlay 偏移 | PixX、PixY、PixWidth、PixHeight 和当前图像坐标系是否一致 |
| JSON 算法没有带点位 | 是否传入 POITemplateParam,模板是否选中 |
| Flow 里没有模板选择 | 常规字段检查节点的 PropertyEditor 类型和 FlowPropertyEditorRegistry;BuildPOI 的多模板入口再查 POINodeConfigurators.cs |
| Build POI 后没保存 | SavePOITempName、LayoutROI、CADMapping 和回写模板是否正确 |
| 过滤/修正结果异常 | TemplatePoiFilterParam、TemplatePoiReviseParam、TemplatePoiOutputParam 是否被联动选中 |
标准 CIE 批量测量的原生参数、32 位浮点布局、V1/V2 选项与返回值见 opencv_helper POI Batch API。这里的模板过滤/修正配置不能直接等同于原生 V2 options 的调用入口。
数据模型
| 对象 | 当前作用 |
|---|---|
PoiPoint | 点位实体,保存 Id、Name、PointType、PixX、PixY、PixWidth、PixHeight |
PoiParam | POI 模板参数,保存尺寸、类型、四角坐标、点集、CfgJson、PoiConfig |
TemplatePoi | 主模板入口 |
PoiMasterDao | POI 主记录 |
PoiDetailDao | POI 点明细 |
CfgJson 不是普通备注字段,当前会和 PoiConfig 相互序列化、反序列化。修改配置结构时要同时验证数据库读取、保存和旧模板兼容性。
矩形/四边形点阵按行列方向插值。某一方向数量为 1 时,该方向固定取区域中线;1×1 因而位于区域中心。相对边距把四角同时缩进 50% 后形成的重合点只允许生成 1×1 点阵,不能作为多点区域继续插值。
编辑器自动适配尺寸
在主 POI 编辑器 EditPoiParam 中选择“四边形”,设置四角、行列数和下方的圆形/矩形采样窗,再点击“自动适配尺寸”:
- 矩形宽度由上下边平均长度除以列数估算,高度由左右边平均长度除以行数估算;圆形以两者较小值的一半估算半径。
- 估算尺寸若无法用于区域内布点,会按比例缩小并向下取整数;单行、单列、
1×1也需保留有效的内缩布点区域,不追求完全贴边。 - 操作只回填当前形状的半径或宽高,并将位置选择改为
Internal(区域内);不修改其它形状尺寸、不覆盖已有点位,也不自动绘制。仍可手动微调,点击“绘制”后才生成点位;修改四角或行列数后需重新点击适配。 - 这是近似填充,不保证无缝、无重叠;圆和倾斜四边形尤其可能留有间隙。尺寸和数据库中的坐标继续遵循现有整数存储,不改变数据库结构。
- 无效四边形、非正行列数、无法容纳整数采样窗的区域会提示失败且不改当前设置;缩进到单点的区域使用手动尺寸和既有
1×1布点。
“边距设置”与“设置布点区域”位于四角坐标下方,同一操作区在宽度不足时换行;边距弹窗仍锚定“边距设置”按钮。
普通四边形布点可用“按比例计算”预览并回填采样窗的像素尺寸。参考尺寸可取当前布点四边形的对边平均长度,也可取整张图像或画布的宽高。矩形宽高各按对应方向换算,圆形半径可选择按参考宽度或高度换算。若要以原始发光区为基准,在设置边距前换算。点击“绘制”才生成点位,模板继续保存像素尺寸。
手动框出布点区域可使用默认白色/矢量画布,不必先导入位图;这只绘制几何区域,不执行像素计算。选区有效期与换图取消遵循 ImageEditor 临时 ROI 契约。自动寻找发光区等图像算法仍要求真实像素图。
EditPoiParam 的 native 图像处理入口保留源更新与纯预览两种语义:需要替换 WriteableBitmap 源的分支先生成独立冻结副本,再以 CommitSourcePixels 提交;仅预览分支使用 ImagePresentation.Publish。不能原地改写已有源却遗漏 revision 通知,也不能将纯显示结果隐式升级为源提交。
存储方式
POI 有专门的主从表结构,不只是普通模板明细:
- 主记录通过
PoiMasterDao保存。 - 点明细通过
PoiDetailDao保存。 PoiParam.LoadPoiDetailFromDB(...)按Pid回填点集合。Save2DB(...)会清空旧明细后整批写入新点。
消费链
下游算法里,POI 通常作为输入模板引用:
AlgorithmSFRFindROI会附带POITemplateParamAlgorithmOLEDAOI也会附带POITemplateParam
Flow 的模板字段、BuildPOI 多模板入口及分析节点对应关系,统一见POI 模板的 Flow 消费。
原“实时关注点算法”节点也可随校正服务的“使用本地校正”开关走内部测量;该分支保留配置,但忽略过滤、修正、亚像素和文件输出等高级参数。关闭开关后恢复原服务对全部参数的处理。路由、支持范围和兼容契约见 Flow 转换与校准节点。
修改边界
- POI 不是单一检测算法的结果结构,它同时用于检测、布点、分析、AOI 和 Flow。
- 主模板通过
PoiMasterDao和PoiDetailDao保存点集。 - 过滤、修正、标定、输出模板都是当前系统的一等成员。
PoiAnalysis、SFR_FindROI、OLEDAOI是消费 POI,不是创建 POI 的主入口。
关键文件
| 文件 | 作用 |
|---|---|
Engine/ColorVision.Engine/Templates/POI/PoiPoint.cs | 点位实体 |
Engine/ColorVision.Engine/Templates/POI/PoiParam.cs | 模板参数、点集加载和保存 |
Engine/ColorVision.Engine/Templates/POI/TemplatePoi.cs | POI 主模板 |
Engine/ColorVision.Engine/FlowProcessing/Nodes/Compatibility/POI/POINode.cs | Flow POI 模板和请求参数 |
Engine/ColorVision.Engine/FlowProcessing/Nodes/Compatibility/POI/BuildPOINode.cs | Flow 布点与模板选择 |
Engine/ColorVision.Engine/Templates/POI/POIFilters/TemplatePoiFilterParam.cs | 过滤模板 |
Engine/ColorVision.Engine/Templates/POI/POIRevise/TemplatePoiReviseParam.cs | 修正模板 |
Engine/ColorVision.Engine/Templates/POI/POIOutput/TemplatePoiOutputParam.cs | 输出模板 |
Engine/ColorVision.Engine/Templates/POI/POIGenCali/TemplatePOICalParam.cs | 标定生成模板 |
Engine/ColorVision.Engine/Templates/Jsons/PoiAnalysis/TemplatePoiAnalysis.cs | JSON POI 分析模板 |
Engine/ColorVision.Engine/Templates/Jsons/SFRFindROI/AlgorithmSFRFindROI.cs | SFR ROI 查找 |
Engine/ColorVision.Engine/Templates/Jsons/OLEDAOI/AlgorithmOLEDAOI.cs | OLED AOI |
Engine/ColorVision.Engine/FlowProcessing/Editor/NodeConfiguration/POINodeConfigurators.cs | BuildPOINode 的多模板补充面板 |
验证入口与缺口
旧模板、整批保存、文件模式和远端 POI 协议应使用目标环境回放。
