Skip to content

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
PoiParamPOI 模板参数,保存尺寸、类型、四角坐标、点集、CfgJson、PoiConfig
TemplatePoi主模板入口
PoiMasterDaoPOI 主记录
PoiDetailDaoPOI 点明细

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 有专门的主从表结构,不只是普通模板明细:

  1. 主记录通过 PoiMasterDao 保存。
  2. 点明细通过 PoiDetailDao 保存。
  3. PoiParam.LoadPoiDetailFromDB(...) 按 Pid 回填点集合。
  4. Save2DB(...) 会清空旧明细后整批写入新点。

消费链 ​

下游算法里,POI 通常作为输入模板引用:

  • AlgorithmSFRFindROI 会附带 POITemplateParam
  • AlgorithmOLEDAOI 也会附带 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.csPOI 主模板
Engine/ColorVision.Engine/FlowProcessing/Nodes/Compatibility/POI/POINode.csFlow POI 模板和请求参数
Engine/ColorVision.Engine/FlowProcessing/Nodes/Compatibility/POI/BuildPOINode.csFlow 布点与模板选择
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.csJSON POI 分析模板
Engine/ColorVision.Engine/Templates/Jsons/SFRFindROI/AlgorithmSFRFindROI.csSFR ROI 查找
Engine/ColorVision.Engine/Templates/Jsons/OLEDAOI/AlgorithmOLEDAOI.csOLED AOI
Engine/ColorVision.Engine/FlowProcessing/Editor/NodeConfiguration/POINodeConfigurators.csBuildPOINode 的多模板补充面板

验证入口与缺口 ​

旧模板、整批保存、文件模式和远端 POI 协议应使用目标环境回放。

基于 MIT License 发布。