定位

卡尺工具

在 ROI 中间一行沿水平方向扫描灰度跳变定位边缘，支持单条边缘与边缘对两种测量方式
CaliperTool · v1.0 · by system

输入参数 10

名称	keyId	类型	默认值	可连接	说明
图像	`images`	vec_img	[]	是	待测量的图像序列，逐帧在 ROI 内做水平梯度扫描；空帧原样透传，不参与边缘检测也不报错
矩形ROI	`roiRect`	roi	[]	否	矩形 ROI 条目集合，用于限定每条扫描线所在的检测区域；多个条目会逐一处理并累加结果
圆ROI	`roiCircle`	roi	[]	否	圆形 ROI 条目集合，按其外接框裁出子图后取中间行扫描，可与矩形 ROI 同时存在并一并生效
椭圆ROI	`roiEllipse`	roi	[]	否	椭圆 ROI 条目集合，按外接矩形裁剪子图后沿中间行检测边缘，留空时不额外限定检测范围
多边形ROI	`roiPolygon`	roi	[]	否	多边形 ROI 条目集合，按外接矩形裁剪后扫描，与其余形状的 ROI 合并为同一批检测区域
扫描宽度	`scanWidth`	int	200	否	以 ROI 子图中心列为中点、沿中间一行向两侧延伸的扫描跨度，决定单条卡尺覆盖的水平范围
边缘阈值	`edgeThreshold`	int	30	否	判定边缘的最小梯度幅值，只有水平梯度不低于该值的像素才被记为边缘；调高漏检弱边、调低易引入噪声
滤波尺寸	`filterSize`	int	3	否	高斯平滑核的边长，实际按奇数使用；越大噪声抑制越强但边缘被展宽、定位偏粗
亚像素	`subpixel`	bool	true	否	是否在单边模式下用相邻三点对边缘位置做亚像素插值修正，开启后坐标可带小数；边缘对模式不使用该开关
边缘模式	`edgeMode`	enum	0	否	选择按单条边缘输出还是把相邻边缘两两配对输出，决定边缘对间距与中心是否有数据

输出参数 9

名称	keyId	类型	默认值	可连接	说明
运行结果	`resultCode`	int	—	否	0=成功并输出边缘坐标与边缘对数据；-1=输入帧容器缺失或处理抛错（ROI 越界、内存不足），不产出结果
运行信息	`resultInfo`	string	—	否	成功时固定为 Success；失败时返回可读原因（输入图像为空、OpenCV 处理异常或处理失败），用于定位边缘扫描的连线与取值问题
图像	`images`	vec_img	—	否	原样输出输入图像序列，工具不在图上绘制标记，帧数与输入一致，空帧原样透传
边缘数	`edgeCount`	int	—	否	累计检出的边缘记录条数，单边模式下等于边缘点数，边缘对模式下等于参与配对的记录数
边缘X	`edgeX`	vec_double	—	否	各边缘记录的 X 坐标数组，已换算为整幅图的全局坐标，单边模式下为亚像素修正后的数值
边缘Y	`edgeY`	vec_double	—	否	各边缘记录的 Y 坐标数组，取自各 ROI 子图的中间行并换算为全局坐标，与 edgeX 一一对应
边缘对数	`edgePairCount`	int	—	否	成功配对的边缘对数量，仅边缘对模式下可能大于 0，单边模式下恒为 0
边缘间距	`edgePairDist`	vec_double	—	否	各边缘对两条边缘之间的像素间距数组，长度与 edgePairCount 一致
边缘中心	`edgePairCenter`	vec_double	—	否	各边缘对两条边缘中点对应的 X 坐标数组，按配对顺序排列并换算为全局坐标

接入方式

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

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

← 矩形检测返回定位矩形查找 →

联系与反馈

获取安装包与技术反馈

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

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

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