定位
边缘查找
在 ROI 内按设定条数布置水平扫描线，逐线找梯度峰定位边缘点，可按极性筛选并做亚像素细化，输出坐标、分数与极性EdgeFinder · v1.0 · by system
输入参数 11
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 图像 | images | vec_img | [] | 是 | 待检边缘的图像序列，逐帧独立处理；空帧原样透传且不参与定位，其余帧输出叠加边缘点的可视化图 |
| 矩形ROI | roiRect | roi | [] | 否 | 矩形 ROI 条目数组，把扫描线布置范围限定在矩形外接框内；未绘制 ROI 时退化为整幅图像 |
| 圆ROI | roiCircle | roi | [] | 否 | 圆形 ROI 条目数组，按圆的外接框裁剪后再布置扫描线；可与其它形状 ROI 同时生效 |
| 椭圆ROI | roiEllipse | roi | [] | 否 | 椭圆 ROI 条目数组，以椭圆外接框限定扫描区域；旋转椭圆按投影外接框裁剪以免两端被切掉 |
| 多边形ROI | roiPolygon | roi | [] | 否 | 多边形 ROI 条目数组，以顶点外接框限定扫描区域；多个 ROI 命中的边缘点会一并汇总 |
| 卡尺数量 | caliperCount | int | 10 | 否 | 在每个 ROI 内均匀布置的水平扫描线条数，越多采样越密、检出边缘点越多，默认 10 条 |
| 扫描宽度 | scanWidth | int | 50 | 否 | 单条扫描线在水平方向的有效搜索宽度（以区域中心为中点），越大覆盖越宽但可能纳入干扰边缘 |
| 边缘阈值 | edgeThreshold | int | 30 | 否 | 判定边缘点的最小梯度幅值，梯度峰低于该值的扫描线不输出结果；调大可抑制弱边缘噪声 |
| 滤波尺寸 | filterSize | int | 3 | 否 | 定位前高斯平滑的核尺寸，自动取为不小于该值的奇数；越大去噪越强但边缘位置可能偏移 |
| 亚像素 | subpixel | bool | false | 否 | 是否用抛物线插值把边缘 X 坐标细化到亚像素；开启后定位更精细，关闭则为整数像素坐标 |
| 极性 | polarity | enum | 0 | 否 | 边缘极性筛选档位，可选任意、上升沿或下降沿，用于只保留特定明暗过渡方向的边缘点 |
输出参数 8
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 0=成功并输出边缘点与叠加图；-1=输入图像为空、ROI 越界或 OpenCV 处理异常，此时不产出结果 |
| 运行信息 | resultInfo | string | — | 否 | 成功时固定为 Success；失败时给出具体原因（输入图像为空、OpenCV 处理异常或内存不足），便于排查连线与参数 |
| 图像 | images | vec_img | — | 否 | 与输入逐帧对应的可视化图像，用红色圆点标出检出的边缘点；帧数保持一致，空帧原样透传 |
| 边缘数 | edgeCount | int | — | 否 | 本次运行累计检出的边缘点总数，等于各坐标数组的长度；没有任何扫描线命中时为 0 |
| 边缘X | edgeX | vec_double | — | 否 | 每个检出边缘点的 X 坐标数组，已换算回整幅图像坐标；开启亚像素时可为小数 |
| 边缘Y | edgeY | vec_double | — | 否 | 每个检出边缘点的 Y 坐标数组，取各扫描线所在行的图像坐标，与 edgeX 顺序一致 |
| 边缘分 | edgeScore | vec_double | — | 否 | 每个边缘点的归一化梯度强度数组，取值 0~1，越接近 1 表示该处明暗跳变越强烈 |
| 边缘极性 | edgePolarity | vec_int | — | 否 | 每个边缘点对应的极性筛选档位数组，记录命中时所用的 polarity 设置（0 任意、1 上升沿、2 下降沿） |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈