定位

直线查找

在 ROI 内先做 Canny 边缘检测，再用概率霍夫变换检出直线段，输出每条直线的两端点、倾斜角与边缘支撑度，并叠加绘制结果图
LineFinder · v1.0 · by system

输入参数 9

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待检直线的图像序列，逐帧独立处理；空帧原样透传且不参与检测，其余帧输出叠加直线的可视化图
矩形ROI	`roiRect`	roi	[]	否	矩形 ROI 条目数组，把直线查找限定在矩形外接框内；未绘制任何 ROI 时自动退化为整幅图像查找
圆ROI	`roiCircle`	roi	[]	否	圆形 ROI 条目数组，按圆的外接框裁剪后再找线；可与矩形、多边形 ROI 同时生效并汇总结果
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆 ROI 条目数组，以椭圆外接框限定检测范围；旋转椭圆按投影外接框裁剪以免两端被切掉
多边形ROI	`roiPolygon`	roi	[]	否	多边形 ROI 条目数组，以顶点外接框限定查找区域；多个 ROI 的命中结果会一并汇总到输出数组
边缘阈值	`edgeThreshold`	int	50	否	Canny 边缘检测的高阈值，低阈值自动取其一半；取值越大只保留越强边缘，直线更少但抗噪更强
最小长度	`minLength`	double	50	否	概率霍夫变换的投票阈值兼最小线段长度，短于该值的候选直线被直接丢弃，单位为像素
最大间隔	`maxGap`	double	10	否	同一直线上允许的最大断点间隔，用于把断开的共线线段连成一条；过大易把无关线段误连
归一化角度	`normalizeAngle`	bool	true	否	是否把直线角度收敛到 -90~90 度；开启后方向相反的同一条直线角度一致，关闭则保留 -180~180 度

输出参数 11

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功并输出直线结果与叠加图；-1=输入图像为空、ROI 越界或 OpenCV 处理异常，此时不产出结果
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时给出具体原因（输入图像为空、OpenCV 处理异常或内存不足），便于排查连线与参数
图像	`images`	vec_img	—	否	与输入逐帧对应的可视化图像，用绿色画出检出的直线段；帧数保持一致，空帧原样透传不叠加
直线数	`lineCount`	int	—	否	本次运行累计检出的直线总条数，等于各端点坐标数组的长度；没有任何直线命中时为 0
起点X	`startX`	vec_double	—	否	每条检出直线起点的 X 坐标数组，已换算回整幅图像坐标，与 startY、endX、endY 按同一顺序对应
起点Y	`startY`	vec_double	—	否	每条检出直线起点的 Y 坐标数组，顺序与 startX 一致，以图像左上角为原点向下增长
终点X	`endX`	vec_double	—	否	每条检出直线终点的 X 坐标数组，与起点成对描述同一条线段，元素个数与 lineCount 相同
终点Y	`endY`	vec_double	—	否	每条检出直线终点的 Y 坐标数组，配合其余三个坐标数组还原完整线段；空结果时为空数组
角度	`angle`	vec_double	—	否	每条直线的倾斜角度数组，单位为度；开启角度归一化后落在 -90~90 度，否则保留 -180~180 度
分数	`score`	vec_double	—	否	每条直线的边缘支撑度数组，取值 0~1，越接近 1 表示线段上真实边缘像素占比越高、结果越可信
直线区域	`roiLineOut`	roi	—	否	检出直线的几何条目数组，格式为 [6,x1,y1,x2,y2]，可直接作为下游工具需要的直线 ROI 输入

接入方式

在 FlowDesigner 中将「直线查找」节点加入流程画布，把上游图像或数据连接至「图像」，并将「运行结果」接至下游节点。运行后可通过 VisionQuick 的数据绑定将结果呈现在界面组件上。

完整操作步骤参见使用文档；安装与使用问题可通过联系页反馈。

← 灰度匹配返回定位圆查找 →

联系与反馈

获取安装包与技术反馈

安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。

安装包获取与部署说明
界面组态与工具配置
功能建议与问题反馈

微信扫码 · 安装包与问题反馈