定位

本章节对定位相关模块的模块结果进行介绍。

说明:

以下模块输出的数据结果中包含多个模块共用的数据结构,详情参见共用数据结构

轮廓匹配/高精度匹配

表 1 快速匹配模块的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

匹配状态

int

是否在图像中找到与模板相同或相似的对象。如果为空,则表示无匹配对象。如匹配到对象,会显示为具体个数的“1”。

示例:“1;1;1;1;1”,表示匹配到5个对象

匹配个数

int

在图像中找到与模板相同或相似对象的个数

匹配模板编号

int

匹配所使用的模板的编号

匹配模板名称

string

匹配所使用的模板的名称

匹配框

-

将匹配对象框起来的矩形,包括匹配框中心、高度、宽度等子参数,详情参见匹配框

匹配点

-

包括匹配点X和匹配点Y,详情参见匹配点

尺度

float

匹配对象相对于已创建模板的等比例缩放倍数

分数

float

匹配到的图像的得分,1表示与模板图像完全相同

检测区域

-

包括检测区域中心点、检测区域宽度、检测区域角度等子参数,详情参见检测区域

匹配轮廓信息

pointset

轮廓的点集信息,该输出结果不显示

匹配轮廓点个数

int

图像中与模板相同或相似的图像的轮廓点个数

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

输出掩膜

-

包含输出掩膜图像、输出掩膜高度、输出掩膜像素格式等子参数,详情参见输出掩膜

快速匹配

表 2 快速匹配模块的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

匹配状态

int

是否在图像中找到与模板相同或相似的对象。如果为空,则表示无匹配对象。如匹配到对象,会显示为具体个数的“1”。

示例:“1;1;1;1;1”,表示匹配到5个对象

匹配个数

int

在图像中找到与模板相同或相似对象的个数

匹配模板编号

int

匹配所使用的模板的编号

匹配模板名称

string

匹配所使用的模板的名称

匹配框

-

将匹配对象框起来的矩形,包括匹配框中心、高度、宽度等子参数,详情参见匹配框

匹配点

-

包括匹配点X和匹配点Y,详情参见匹配点

尺度

float

匹配对象相对于已创建模板的等比例缩放倍数

分数

float

匹配到的图像的得分,1表示与模板图像完全相同

检测区域

-

包括检测区域中心点、检测区域宽度、检测区域角度等子参数,详情参见检测区域

匹配轮廓信息

pointset

轮廓的点集信息,该输出结果不显示

匹配轮廓点个数

int

图像中与模板相同或相似的图像的轮廓点个数

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

输出掩膜

-

包含输出掩膜图像、输出掩膜高度、输出掩膜像素格式等子参数,详情参见输出掩膜

灰度匹配

表 3 灰度匹配的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

匹配状态

int

是否在图像中找到与模板相同或相似的对象。如果为空,则表示无匹配对象。如匹配到对象,会显示为具体个数的“1”。

示例:“1;1;1;1;1”,表示匹配到5个对象

匹配个数

int

图像中与模板相同或相似对象的个数

匹配模板编号

int

匹配所使用的模板的编号

匹配模板名称

string

匹配所使用的模板的名称

匹配框

-

将匹配对象框起来的矩形,包括匹配框中心、高度、宽度等子参数,详情参见匹配框

匹配点

-

包括匹配点X和匹配点Y,详情参见

分数

float

匹配到的图像的得分,1表示与模板图像完全相同

检测区域

-

包括检测区域中心点、检测区域宽度、检测区域角度等子参数,详情参见检测区域

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

输出掩膜

-

包含输出掩膜图像、输出掩膜高度、输出掩膜像素格式等子参数,详情参见输出掩膜

图形定位

表 4 图形定位的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

匹配状态

int

  • 1:匹配成功

  • 0:匹配失败

直线状态

int

  • 1:匹配成功

  • 0:匹配失败

匹配个数

int

图像中与模板相同或相似的对象的个数

匹配框

-

将匹配对象框起来的矩形,包括匹配框中心、高度、宽度等子参数,详情参见匹配框

输出直线

-

包含直线起点、直线终点和直线角度,详情参见输出直线

尺度X

float

匹配对象在X轴方向上的缩放尺度

尺度Y

float

匹配对象在Y轴方向上的缩放尺度

分数

float

匹配到的图像的得分,1表示与模板图像完全相同

检测区域

-

包括检测区域中心点、检测区域宽度、检测区域角度等子参数,详情参见检测区域

匹配轮廓点个数

int

图像中与模板相同或相似的图像的轮廓点个数

匹配轮廓信息

pointset

轮廓的点集信息,该输出结果不显示

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

输出掩膜

-

包含输出掩膜图像、输出掩膜高度、输出掩膜像素格式等子参数,详情参见输出掩膜

阵列圆查找

表 5 阵列圆查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

单个圆查找状态

int

阵列中每个圆的查找状态:
  • 1:查找到圆

  • 0:未查找到圆

输出圆环个数

int

阵列中找到的圆的个数

输出圆环

-

包括圆心、内径、圆角度范围等子参数,详情参见输出圆环

拟合误差

float

查找到的阵列圆中单个圆由边缘点拟合出输出圆过程的误差

圆轮廓点

-

  • 轮廓点X:float型,查找到的阵列圆中单个圆中查找到的边缘点的X轴坐标

  • 轮廓点Y:float型,查找到的阵列圆中单个圆中查找到的边缘点的Y轴坐标

轮廓点状态

int

  • 0:该点所在的圆查找失败

  • 1:该点所在的圆查找成功

边缘点个数

int

阵列圆卡尺中各个子圆卡尺所匹配到的边缘点个数

检测区域

-

包含检测区域中心点、检测区域宽度、检测区域角度等子参数,详情参见检测区域

ROI圆弧

-

包含检测圆弧中心点、检测圆弧内径、检测圆弧起始角度等子参数,详情参见ROI圆环

卡尺框个数

int

分别显示用于查找阵列圆中单个圆的卡尺数量

卡尺框

-

包含卡尺中心点、卡尺宽度、卡尺角度等子参数,详情参见卡尺框

卡尺框检测区

-

包含卡尺框检测中心点、卡尺框检测区高度、卡尺框检测区角度等,详情参见卡尺框检测区

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

位置修正

表 6 位置修正模块的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

位置修正信息

-

包含基准点、基准角度、运行点等,详情参见位置修正信息

表 7 位置修正信息

参数

类型

描述

基准点

-

  • 基准点X:float型,设置的基准点X轴坐标

  • 基准点Y:float型,设置的基准点Y轴坐标

基准角度

float

基准点相对于水平线的角度,顺时针为正,逆时针为负

基准尺度X

float

基准点在X轴方向上的缩放尺度

基准尺度Y

float

基准点在Y轴方向上的缩放尺度

运行点

-

  • 运行点X:float型,查找到的运行点的X轴坐标

  • 运行点Y:float型,查找到的运行点的X轴坐标

运行角度

float

运行点相对于水平线的角度,顺时针为正,逆时针为负

运行尺度X

float

运行点在X轴方向上的缩放尺度

运行尺度Y

float

运行点在Y轴方向上的缩放尺度

BLOB分析

表 8 BLOB分析的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

单体状态

int

各个blob的状态,1表示blob识别成功。1的个数表示检测出的blob的个数

BLOB个数

int

图像中blob的个数

面积

float

各个blob的面积大小

总面积

float

所有blob加起来的总面积

质心点

-

包含质心X和质心Y,详情参见质心点

最小外接矩形

-

包含中心点、矩形宽度、矩形高度等,详情参见最小外接矩形

BLOB矩形框

-

包含矩形框原点、bob矩形框宽度和bob矩形框高度,详情参见BLOB矩形框

BLOB矩形框左上点X

float

blob矩形框左上点的X轴坐标

BLOB矩形框左上点Y

float

blob矩形框左上点的Y轴坐标

BLOB矩形框右下点X

float

blob矩形框右下点的X轴坐标

BLOB矩形框右下点Y

float

blob矩形框右下点的Y轴坐标

主轴角度

float

blob矩形框基于水平线旋转的角度,顺时针为正,逆时针为负

周长

float

检测出的blob的轮廓周长

长轴

float

blob最小外接矩形较长的边

最小外接矩形定义参见图 13

短轴

float

blob最小外接矩形较短的边

圆形度

float

检测出的blob的圆形度。圆形度定义参见圆形度使能

矩形度

float

blob面积与最小外接矩形面积的比值

分数

float

检测出的blob的特征加权得分

二值化图像数据

-

包含二值化图像高度、宽度、像素格式等,详情参见二值化图像数据

BLOB图像数据

-

包含blob图像的宽度、高度和像素格式,详情参见BLOB图像数据

检测区域

-

包含检测区域中心点、宽度、高度等,详情参见检测区域

ROI圆弧

-

检测圆弧,包含检测圆弧中心点、内径、起始角度等,详情参见ROI圆弧

轮廓点集

-

轮廓的点集,包含轮廓信息和轮廓点个数,详情参见轮廓点集

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

输出掩膜

-

以二值图输出的掩膜图像,包含图像宽度、高度和像素格式等,详情参见输出掩膜

表 9 质心点

参数

类型

描述

质心X

float

blob质心的X轴坐标

质心Y

float

blob质心的Y轴坐标

表 10 BLOB矩形框

参数

类型

描述

矩形框原点

-

  • BLOB矩形框原点X:float型,矩形框中心点的X轴坐标

  • BLOB矩形框原点X:float型,矩形框中心点的X轴坐标

blob矩形框详情参见图 14

BLOB矩形框宽度

float

矩形框的宽度

BLOB矩形框高度

float

矩形框的高度

表 11 二值化图像数据

参数

类型

描述

二值化图像数据

image

二值化图像,为二进制形式故不显示任何数据,可在输出图像中调出该图像

二值化图像宽度

int

二值化图像的宽度

二值化图像高度

int

二值化图像的高度

二值化图像像素格式

int

二值图的像素格式,一般为17301505,代表MONO 8(黑白图)

表 12 BLOB图像数据

参数

类型

描述

BLOB图像数据

image

通过blob分析之后输出的图像,二进制形式故不显示任何数据,可在输出图像中调出该图像

BLOB图像宽度

int

输出的blob图像的宽度

BLOB图像高度

int

输出的blob图像的高度

BLOB图像像素格式

int

输出的blob图像的像素格式,一般为17301505,代表MONO 8(黑白图)

表 13 轮廓点集

参数

类型

描述

轮廓信息

pointset

轮廓的点集信息,该输出结果不显示

轮廓点个数

int

图像的轮廓点个数

BLOB标签分析

表 14 BLOB分析的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

单体状态

int

各个blob的状态,1表示blob检测成功。1的个数表示blob的个数

BLOB个数

int

图像中blob的个数

面积

float

各个blob的面积大小

总面积

float

所有blob加起来的总面积

质心点

-

包含质心X和质心Y,详情参见质心点

最小外接矩形

-

包含中心点、矩形宽度、矩形高度等,详情参见最小外接矩形

主轴角度

float

blob矩形框相对于水平线旋转的角度,顺时针为正,逆时针为负

周长

float

检测出的blob的轮廓周长

长轴

float

blob最小外接矩形较长的边

最小外接矩形定义参见图 13

短轴

float

blob最小外接矩形较短的边

圆形度

float

检测出的blob的圆形度,详情参见圆形度使能

矩形度

float

blob面积与最小外接矩形面积的比值

分数

float

检测出的blob的特征加权得分

二值化图像数据

-

包含二值化图像高度、宽度、像素格式等,详情参见二值化图像数据

BLOB图像

-

包含Blob图像的宽度、高度和像素格式,详情参见BLOB图像数据

输出掩膜

-

以二值图输出的掩膜图像,包含图像宽度、高度和像素格式等,详情参见输出掩膜

检测区域

-

包含检测区域中心点、宽度、高度等,详情参见检测区域

ROI圆弧

-

检测圆弧,包含检测圆弧中心点、内径、起始角度等,详情参见ROI圆弧

轮廓点集

-

轮廓的点集,包含轮廓信息和轮廓点个数,详情参见轮廓点集

类别标签

string

blob的类别标签

灰度值

int

blob的灰度值

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

圆查找

表 15 圆查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

输出圆环

-

包括圆心、内径、圆角度范围等子参数,详情参见输出圆环

拟合误差

float

实际值与拟合值的误差

圆轮廓点

-

  • 轮廓点X:float型,圆的轮廓点的X轴坐标

  • 轮廓点Y:float型,圆的轮廓点的Y轴坐标

轮廓点状态

int

每个轮廓点是否检测到:

  • 0:未检测到

  • 1:检测到

边缘点个数

int

输出的边缘点个数

检测区域

-

包含检测区域中心点、检测区域宽度、检测区域角度等子参数,详情参见检测区域

ROI圆弧

-

包含检测圆弧中心点、检测圆弧内径、检测圆弧起始角度等子参数,详情参见ROI圆弧

卡尺框

-

包含卡尺中心点、卡尺宽度、卡尺角度等子参数,详情参见卡尺框

卡尺框检测区

-

包含卡尺框检测中心点、卡尺框检测区高度、卡尺框检测区角度等,详情参见卡尺框检测区

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

表 16 输出圆环

参数

类型

描述

圆心

float

  • 圆心X:float型,查找到的圆的X轴坐标

  • 圆心Y:float型,查找到的圆的Y轴坐标

内径

float

分别显示查找到的阵列圆中单个圆的内径。若为圆而非圆环,则一般为0

圆半径

float

分别显示查找到的阵列圆中单个圆的半径

圆起始角度

float

分别显示查找到的阵列圆中单个圆(不完整的圆)的起始边与水平方向夹角,若为完整的圆或圆环则为0

圆角度范围

float

分别显示查找到的阵列圆中单个圆的起始边与终止边跨过的角度范围,若为完整的圆或圆环则为360

椭圆查找

表 17 圆查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

椭圆轮廓点

-

  • 轮廓点X:轮廓点的X轴坐标

  • 轮廓点Y:轮廓点的Y轴坐标

输出椭圆

-

包含圆心点、椭圆长半轴、短半轴等,详情参见输出椭圆

椭圆环

-

包含圆心点、椭圆长半轴、短半轴等,详情参见椭圆环

检测区域

-

包含检测区域中心点、检测区域宽度、检测区域角度等子参数,详情参见检测区域

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

表 18 输出椭圆

参数

类型

描述

圆心点

-

  • 中心X:float型,圆心点的X轴坐标

  • 中心点Y:float型,圆心点的Y轴坐标

椭圆长半轴

float

椭圆的长半轴长度

椭圆短半轴

float

椭圆的短半轴长度

椭圆角度

float

椭圆的角度

表 19 椭圆环

参数

类型

描述

圆心点

-

  • 中心X:float型,圆心点的X轴坐标

  • 中心Y:float型,圆心点的Y轴坐标

椭圆短半轴

float

椭圆的短半轴长度

椭圆长半轴

float

椭圆的长半轴长度

椭圆角度

float

椭圆的角度

直线查找

表 20 直线查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

输出直线

-

包含直线起点和终点,详情参见输出直线

中点

-

  • 中点X:float型,直线中点的X轴坐标

  • 中点Y:float型,直线中点的Y轴坐标

直线角度

float

输出直线的相对于水平线的旋转角度,顺时针旋转为正,逆时针为负

拟合误差

float

输出拟合误差

直线轮廓点

-

  • 轮廓点X:float型,轮廓点的X轴坐标

  • 轮廓点Y:float型,轮廓点的Y轴坐标

边缘点个数

int

输出的边缘点个数

轮廓点状态

int

1表示提取的轮廓点符合拟合要求,0表示不符合。表示1的个数表示符合要求的轮廓点个数

检测区域

-

包含检测区域中心点、宽度、高度等,详情参见检测区域

卡尺框

-

包含卡尺中心点、宽度、高度等,详情参见2表 53

卡尺框检测区

-

包含卡尺框检测中心点、宽度、高度、角度等,详情参见卡尺框检测区

屏蔽区多边形

-

包含多边形点数和多边形点集,详情参见屏蔽区多边形

直线查找组合

表 21 直线查找组合的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

输出直线

-

包含直线起点和终点,详情参见输出直线

输出拟合点

-

  • 输出拟合点X:float型,输出的拟合点的X轴坐标

  • 输出拟合点Y:float型,输出的拟合点的Y轴坐标

拟合误差

float

实际值与拟合值的差异

拟合状态

int

  • 1:拟合成功

  • 0:拟合失败

拟合点数

int

实际的拟合点个数

拟合距离

float

相邻拟合点之间的距离

匹配点

int

点是否匹配成功:
  • 1:成功

  • 2:失败

匹配点数

int

匹配成功的点数

最小外接矩形

-

包含中心点、矩形宽度、高度等,详情参见最小外接矩形

卡尺框检测区

-

包含卡尺框检测中心点、宽度、高度、角度等,详情参见卡尺框检测区

多直线查找

表 22 多直线查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

直线个数

int

定位到的直线的数量

边缘点个数

int

定位到的边缘点的个数

直线段信息

-

包含直线起点和终点,详情参见直线段信息

直线角度

float

输出直线相对于水平方向的旋转角度,顺时针为正,逆时针为负

拟合误差

float

实际值与拟合值的差异

直线对比度强度

float

图像中直线边缘的明暗变化程度。该值越大,图像中的直线边缘越清晰

覆盖率分数

float

指拟合直线在整个图像中直线的占比或覆盖程度的评估指标

在群点数量

int

图像中聚集在一起的点的数量

线段索引

int

从上到下每个线段的索引

边缘点

-

  • 轮廓点X:float型,边缘轮廓点的X轴坐标

  • 轮廓点Y:float型,边缘轮廓点的Y轴坐标

边缘极性

int

目标对象边缘的亮度变化方向或极性

梯度幅值

float

图像上某一点处的梯度的大小或强度

梯度方向

float

图像上某一点处的梯度的方向

边缘距离

float

图像上某一点到最近边缘的距离

边缘状态

int

图像上某个点是否位于边缘:
  • 1:位于边缘

  • 0:不在边缘

投影区域索引

int

边缘点所处的投影区域的索引值

所属线段索引

int

边缘点所处的线段的索引值

检测区域

-

包含检测区域中心点、区域宽度、高度等,详情参见检测区域

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

表 23 直线段信息

参数

类型

描述

直线起点

-

  • 直线起点X:float型,直线起点的X轴坐标

  • 直线起点Y:float型,直线起点的Y轴坐标

直线终点

-

  • 直线终点X:直线终点的X轴坐标

  • 直线终点Y:直线终点的Y轴坐标

边缘交点

表 24 边缘交点的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

边缘交点

-

  • 边缘交点X:float型,检测到的边缘交点的X轴坐标

  • 边缘交点Y:float型,检测到的边缘交点的Y轴坐标

边缘交点角度

float

两条边缘的夹角角度

边缘直线

-

包含直线起点和终点,详情参见边缘直线

直线角度

float

边缘直线基于水平线角度,顺时针旋转转正为正角度,逆时针转正为负角度

直线轮廓点

-

  • 轮廓点X:float型,用于检测出边缘直线的轮廓点的X轴坐标

  • 轮廓点Y:float型,用于检测出边缘直线的轮廓点的Y轴坐标

直线轮廓点数

int

检测出的边缘直线轮廓点的点数

直线轮廓点状态

int

检测出的边缘直线的轮廓点状态:
  • 符合要求的轮廓点

  • 不符合要求的轮廓点

线段索引

int

从上到下每条线段的索引

边缘点

-

  • 轮廓点X:float型,轮廓点的X轴坐标

  • 轮廓点Y:float型,轮廓点的Y轴坐标

输出掩膜

-

包含输出掩膜图像、掩膜图像宽度、高度等,详情参见输出掩膜

检测区域

-

包含检测区域中心点、宽度、高度等,详情参见检测区域

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

四边形查找

表 25 四边形查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

直线状态

int

是否检测到直线:

  • 1:检测到

  • 0:未检测到

边缘直线

-

包含直线起点和直线终点,详情参见边缘直线

直线角度

float

边缘直线相对于水平线方向的旋转角度,顺时针旋转为正,逆时针旋转为负

直线拟合误差

float

拟合的直线与实际数据之间差距

直线轮廓点

-

  • 轮廓点X:float型,用于检测出边缘直线的轮廓点的X轴坐标

  • 轮廓点Y:float型,用于检测出边缘直线的轮廓点的Y轴坐标

边缘轮廓点数

int

用于检测出边缘直线的轮廓点的点数

边缘轮廓点状态

int

用于检测出边缘直线的轮廓点的状态:
  • 1:轮廓点符合要求

  • 0:轮廓点不符合要求

输出掩膜

-

包含输出掩膜图像、淹膜宽度、高度等,详情参见输出掩膜

检测区域

-

包含检测区域中心点、区域宽度、高度等,详情参见检测区域

对角线

-

包含对角线起点和终点,详情参见对角线

对角线角度

float

四边形对角线相对于水平方向的旋转角度,顺时针旋转为正,逆时针旋转为负

中点线

-

包含中点线起点和终点,详情参见中点线

中点线角度

float

四边形的中点线相对于水平线方向的旋转角度,顺时针旋则为正,逆时针转则为负

临边夹角

float

找出的四边形相邻两边的夹角度数,顺时针为正角度,逆时针为负角度

顶点

-

包含顶点X和顶点Y,详情参见顶点

对角线交点

-

  • 对角线交点X:float型,四边形两条对角线交点的X轴坐标

  • 对角线交点Y:float型,四边形两条对角线交点的Y轴坐标

中点线交点

-

  • 中点线交点X:四边形的中点线的交点的X轴坐标

  • 中点线交点Y:四边形的中点线的交点的Y轴坐标

中心点

-

  • 中心点X:float型,四边形中心点的X轴坐标

  • 中心点Y:float型,四边形中心点的Y轴坐标

对边角平分线交点

-

  • 对边角平分线交点X:float型,四边形对边角平分线交点的X轴坐标

  • 对边角平分线交点Y:float型,四边形对边角平分线交点的Y轴坐标

对边角平分线

-

包含对边角平分线起点和终点,详情参加对边角平分线

对边角平分线角度

float

四边形的对角平分线相对于水平线方向的旋转角度,顺时针旋转则为正,逆时针旋转则为负

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

表 26 对角线

参数

类型

描述

对角线起点

-

  • 对角线起点X:四边形对角线起点的X轴坐标

  • 对角线起点Y:四边形对角线起点的Y轴坐标

对角线终点

-

  • 对角线终点X:四边形对角线终点的X轴坐标

  • 对角线终点Y:四边形对角线终点的Y轴坐标

表 27 对边角平分线

参数

类型

描述

对边角平分线起点

-

  • 对边角平分线起点X :float型,四边形对边角平分线起点的X轴坐标

  • 对边角平分线起点Y:float型,四边形对边角平分线终点的Y轴坐标

对边角平分线终点

-

  • 对边角平分线起点X :float型,四边形对边角平分线终点的X轴坐标

  • 对边角平分线起点Y:float型,四边形对边角平分线终点的Y轴坐标

平行线查找

表 28 平行线查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

检测状态

int

是否检测到平行线,0表示未检测到,1表示检测到

直线宽度

float

平行线的宽度

输出掩膜

-

包含输出掩膜图像、宽度、高度等,详情参见输出掩膜

边缘直线

-

包含直线起点和直线终点,详情参见边缘直线

直线角度

float

边缘直线相对于水平线方向的旋转角度,顺时针旋转则为正,逆时针转则为负

边缘中线

-

包含中线起点和终点,详情参见边缘中线

中线角度

float

中线相对于水平线方向的旋转角度,顺时针旋转则为正,逆时针为负

直线轮廓点

-

  • 边缘轮廓点X:float型,用于找出边缘直线的各个轮廓点的X轴坐标

  • 边缘轮廓点Y:float型,用于找出边缘直线的各个轮廓点的Y轴坐标

边缘点个数

int

用于找出边缘直线的轮廓点点数

边缘轮廓点状态

int

用于找出边缘直线的轮廓点状态,1表示符合要求的轮廓点,0表示不符合

中线轮廓点

-

  • 中线轮廓点X:用于找出中线的各个轮廓点的X轴坐标

  • 中线轮廓点Y:用于找出中线的各个轮廓点的Y轴坐标

中线轮廓点状态

int

用于找出中线的轮廓点状态,1表示符合要求的轮廓点,0表示不符合

检测区域

-

包含检测区域高度、宽度、角度等,详情参见检测区域

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

表 29 边缘中线

参数

类型

描述

边缘中线起点

-

  • 中线起点X:float型,平行线的中线起点的X轴坐标

  • 中线起点Y:float型,平行线的中线起点的Y轴坐标

边缘中线终点

-

  • 中线终点X:float型,平行线的中线终点的X轴坐标

  • 中线终点Y:float型,平行线的中线终点的Y轴坐标

平行线计算

表 30 平行线计算的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

测量点

-

包含测量点X和Y,详情参见测量点

测量直线

-

包含测量直线起点和终点,详情参见表 61

测量直线角度

float

选用与直线相距一定距离的方式时,输入的直线相对于水平线方向的旋转角度,顺时针旋转为正,逆时针旋转为负

平行线

-

包含平行线起点和终点,详情参见平行线

表 31 平行线

参数

类型

描述

平行线起点

-

  • 平行线起点X:float型,选用在直线外一点的方式时,找出平行线起点的X轴坐标

  • 平行线起点Y:float型,选用在直线外一点的方式时,找出平行线起点的Y轴坐标

平行线终点

-

  • 平行线终点X:float型,选用在直线外一点的方式时,找出平行线终点的X轴坐标

  • 平行线终点Y:float型,选用在直线外一点的方式时,找出平行线终点的Y轴坐标

矩形检测

表 32 平行线计算的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

检测状态

int

是否检测到矩形,1表示检测到矩形,0表示未检测到矩形

输出淹膜

-

包含输出掩膜高度、宽度、像素格式等,详情参见输出掩膜

矩形框

-

包含矩形框高度、宽度、角度等,详情参见矩形框

轮廓点

-

  • 轮廓点X:float型,轮廓点的X轴坐标

  • 轮廓点Y:float型,轮廓点的Y轴坐标

边缘点个数

int

用于找出矩形的轮廓点点数

轮廓点状态

int

用于找出矩形的轮廓点状态,1表示符合要求的轮廓点,0表示不符合

检测区域

-

包含检测区域高度、宽度、角度等,详情参见检测区域

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

表 33 矩形框

参数

类型

描述

矩形中心点

-

  • 矩形中心点X:float型,矩形中心点的X轴坐标

  • 矩形中心点Y:float型,矩形中心点的Y轴坐标

矩形宽度

float

找出的矩形的宽度

矩形高度

float

找出的矩形的高度

矩形角度

float

找出的矩形基于水平线回正旋转的角度,顺时针为正角度,逆时针为负角度

中线查找

表 34 中线查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

中线

-

包含中线起点和中线终点,详情参见中线

直线角度

float

中线的基于水平线角度,顺时针旋转转正为正角度,逆时针转正为负角度

测量直线

-

包含直线起点和终点,详情参见测量直线

测量直线角度

float

输入的直线相对于水平线防线的旋转角度,顺时针旋转为正,逆时针旋转为负

表 35 中线

参数

类型

描述

中线起点

-

  • 中线起点X:float型,中线起点的X轴坐标

  • 中线起点Y:float型,中线起点的Y轴坐标

中线终点

-

  • 中线终点X:float型,中线终点的X轴坐标

  • 中线终点Y:float型,中线终点的Y轴坐标

垂线查找

表 36 垂线查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

测量点

-

包含测量点X和Y,详情参见测量点

测量直线

-

包含直线起点和终点,详情参见测量直线

测量直线角度

float

输入的直线相对于水平线防线的旋转角度,顺时针旋转为正,逆时针旋转为负

垂足点

-

  • 垂足点X:float型,垂足点的X轴坐标

  • 垂足点Y:float型,垂足点的Y轴坐标

垂线

-

包含垂线起点和终点,详情参见垂线

表 37 垂线

参数

类型

描述

垂线起点

-

  • 垂线起点X:float型,垂线起点的X轴坐标

  • 垂线起点Y:float型,垂线起点的Y轴坐标

垂线终点

-

  • 垂线起点X:float型,垂线起点的X轴坐标

  • 垂线起点Y:float型,垂线起点的Y轴坐标

角平分线查找

表 38 角平分线查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

测量直线

-

包含直线起点和终点,详情参见测量直线

测量直线角度

float

输入的直线相对于水平线防线的旋转角度,顺时针旋转为正,逆时针旋转为负

交点

-

  • 交点X:float型,输入直线1与输入直线2的交点X轴坐标

  • 垂足点Y:float型,输入直线1与输入直线2的交点X轴坐标

夹角

float

输入直线1与输入直线2相交的锐角大小

角平分线

-

包含角平分线起点和终点,详情参见角平分线

角度标识点

-

  • 角度标识点X:角度标识点的X轴坐标

    角度标识点Y:角度标识点的Y轴坐标

表 39 角平分线

参数

类型

描述

角平分线起点

-

  • 角平分线起点X:float型,输出的角平分线的起点的X轴坐标

  • 角平分线起点Y:float型,输出的角平分线的起点的Y轴坐标

角平分线终点

float

  • 角平分线终点X:float型,输出的角平分线的终点的X轴坐标

  • 角平分线终点Y:float型,输出的角平分线的终点的Y轴坐标

卡尺工具

表 40 卡尺工具的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

边缘状态

int

代表边缘的状态,0表示未定位到边缘,1表示定位到边缘

边缘个数

int

查找到的边缘个数

分数

float

边缘点按照设定的评分方式的得分

边缘极性

int

边缘的灰度变化,1表示从黑到白,2表示从白到黑,3表示任意极性

边缘位置

float

边缘点所在的位置

边缘点*

-

  • 边缘点*X:float型,检测到的第(*+1)个边缘点的X轴坐标

  • 边缘点*Y:float型,检测到的第(*+1)个边缘点的Y轴坐标

测量宽度

float

定位到的两个边缘点,在与投影法线方向的宽度

直线起点

-

  • 直线起点X:float型,直线起点的X轴坐标

  • 直线起点Y:float型,直线起点的Y轴坐标

直线终点

-

  • 直线终点X:float型,直线终点的X轴坐标

  • 直线终点Y:float型,直线终点的Y轴坐标

直线角度

float

直线相对于水平方向的旋转角度,顺时针为正,逆时针为负

检测区域

-

包含检测区域宽度、高度、角度等,详情参见检测区域

边缘查找

表 41 边缘查找的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

边缘状态

int

代表边缘的状态,0表示未定位到边缘,1表示定位到边缘

边缘个数

int

查找到的边缘个数

分数

float

边缘点按照设定的评分方式的得分

边缘极性

int

边缘的灰度变化,1表示从黑到白,2表示从白到黑,3表示任意极性

边缘位置

float

边缘点所处的位置

边缘点

-

  • 边缘点X:float型,检测到的边缘点的X轴坐标

  • 边缘点Y:float型,检测到的边缘点的Y轴坐标

直线起点

-

  • 直线起点X:float型,直线起点的X轴坐标

  • 直线起点Y:float型,直线起点的Y轴坐标

直线终点

-

  • 直线终点X:float型,直线终点的X轴坐标

  • 直线终点Y:float型,直线终点的Y轴坐标

直线角度

float

直线相对于水平方向的旋转角度,顺时针为正,逆时针为负

检测区域

-

包含检测区域宽度、高度、角度等,详情参见检测区域

顶点检测

表 42 顶点检测的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

顶点分数

float

顶点检测中边缘点、顶点及其分数均来自内部卡尺计算,分数可参考卡尺工具中提及的极值点评分

顶点极性

int

顶点边缘的灰度变化,1表示从黑到白,2表示从白到黑,3表示任意极性

顶点距离

float

顶点到ROI区域某一边的距离,跟运行参数中的查找方向相对应

顶点

  • 顶点X:float型,顶点的X轴坐标

  • 顶点Y:float型,顶点的Y轴坐标

边缘状态

int

代表边缘的状态,0表示未定位到边缘,1表示定位到边缘

边缘个数

int

检测区域内查找到的边缘个数

分数

float

边缘点按照设定的评分方式的得分

边缘极性

int

边缘的灰度变化,1表示从黑到白,2表示从白到黑,3表示任意极性

边缘位置

float

边缘点所处的位置

边缘点

-

  • 边缘点X:float型,检测到的边缘点的X轴坐标

  • 边缘点Y:float型,检测到的边缘点的Y轴坐标

输出掩膜

-

包含输出掩膜宽度、高度、像素格式等,详情参见输出掩膜

检测区域

-

包含检测区域宽度、高度、角度等,详情参见检测区域

屏蔽区多边形

-

包含多边形点数和点集,详情参见屏蔽区多边形

路径提取

表 43 路径提取的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

路径点个数

int

检测区域内提取到的路径点个数

路径*(*代表1~10)

int

第*条路径

路径*点状态(*代表1~10)

int

第*条路径各个路径点的状态,1:匹配成功,0:匹配失败

总路径

float

  • 路径点X:全部路径的路径点的X轴坐标集

    路径点Y:全部路径的路径点的Y轴坐标集

路径点状态

int

路径点*点状态

路径点类型

int

1:直线路径点,0:圆弧路径点

目标跟踪

表 44 顶点检测的输出结果

参数

类型

描述

模块状态

int

  • 0:NG,模块显示为红色

  • 1:OK,模块显示为绿色

计数总数

int

过去所有帧跨过检测线的所有目标数累计和

单帧计数

int

当前帧目标在检测线上的个数

目标数

int

当前帧检测区域内跟踪到的目标总数

多边形轮廓点

-

  • 轮廓点X:float型,检测到的目标的轮廓顶点的X轴坐标

  • 轮廓点Y:float型,检测到的目标的轮廓顶点的X轴坐标

目标ID位置

-

  • X坐标:float型,检测到的目标的ID编号的X轴坐标

  • Y坐标:float型,检测到的目标的ID编号的Y轴坐标

边缘点个数

int

分别显示检测到的所有目标的轮廓顶个点数,如4;5;4表示检测到3个目标,他们轮廓分别有4、5、4个顶点

目标ID

int

检测到的目标ID编号

检测区域

-

包含检测区域宽度、高度、角度等,详情参见检测区域

Y方向速度

float

运行参数中设置的Y方向速度

X方向速度

float

运行参数中设置的X方向速度

检测线

-

包含检测线起点和终点,详情参见检测线

直线角度

float

检测线相对于水平方向的旋转角度,顺时针旋转为正,逆时针为负

表 45 检测线

参数

类型

描述

检测线起点

-

  • 检测线起点X:float型,检测线起点的X轴坐标

  • 检测线起点Y:float型,检测线起点的Y轴坐标

检测线终点

-

  • 检测线起点X:float型,检测线起点的X轴坐标

  • 检测线起点Y:float型,检测线起点的Y轴坐标

共用数据结构

以下为多模块共用的输出数据结构。

表 46 匹配框

参数

类型

描述

匹配框中心点

-

  • 匹配框中心X:float型,将匹配对象框起来的矩形的中心点的X轴坐标

  • 匹配框中心Y:float型,将匹配对象框起来的矩形的中心点的Y轴坐标

匹配框宽度

float

将匹配对象框起来的矩形的宽度

匹配框高度

float

将匹配对象框起来的矩形的高度

角度

float

匹配对象相较于模板中特征图像的旋转角度。顺时针旋转则为正,逆时针为

表 47 匹配点

参数

类型

描述

匹配点X

float

匹配点的X坐标

匹配点Y

float

匹配点的Y坐标

表 48 检测区域

参数

类型

描述

检测区域中心点

float

检测区域即感兴趣区域(ROI)

  • 检测区域中心点X:float型,ROI中心点X坐标

  • 检测区域中心点Y:float型,ROI中心点Y坐标

检测区域宽度

float

ROI的宽度

检测区域高度

float

ROI的高度

检测区域角度

float

ROI相对于水平方向(正准位姿)的旋转角度。顺时针旋转则角度为正,逆时针旋转则角度为负

若检测区域处于正准位姿则为0度

表 49 屏蔽区多边形

参数

类型

描述

多边形点数

int

绘制的屏蔽区多边形的顶点的个数

多变形点集

-

  • 多边形点X:float型,绘制的屏蔽区多边形的各个顶点的X坐标

  • 多边形点Y:float型,绘制的屏蔽区多边形的各个顶点的Y坐标

表 50 输出掩膜

参数

类型

描述

输出掩膜图像

image

根据ROI和屏蔽区计算出的掩膜图像,以二值图的形式输出

输出掩膜宽度

int

输出掩膜图像的宽度

输出掩膜高度

int

输出掩膜图像的高度

输出掩膜像素格式

int

输出掩膜图像的像素格式,一般为MONO 8(17301505)

表 51 ROI圆弧

参数

类型

描述

检测圆弧中心点

-

  • 检测圆弧中心点X:float型,圆弧ROI中心点的X轴坐标

  • 检测圆弧中心点Y:float型,圆弧ROI中心点的Y轴坐标

检测圆弧内径

float

圆弧ROI的内径

检测圆弧外径

float

圆弧ROI的外径

检测圆弧起始角度

float

圆弧ROI的起始边与水平方向夹角

检测圆弧角度范围

float

圆弧ROI的起始边与终止边跨过的角度范围

表 52 输出圆环

参数

类型

描述

圆心

float

  • 圆心X:float型,查找到的圆的X轴坐标

  • 圆心Y:float型,查找到的圆的Y轴坐标

内径

float

分别显示查找到的阵列圆中单个圆的内径。若为圆而非圆环,则一般为0

圆半径

float

分别显示查找到的阵列圆中单个圆的半径

圆起始角度

float

分别显示查找到的阵列圆中单个圆(非完整圆)的起始边与水平方向夹角,若为完整的圆或圆环则为0

圆角度范围

float

分别显示查找到的阵列圆中单个圆的起始边与终止边跨过的角度范围,若为完整的圆或圆环则为360

表 53 卡尺框

参数

类型

描述

卡尺中心点

-

  • 卡尺中心X:float型,卡尺框中心点X轴坐标

  • 卡尺中心Y:float型,卡尺框中心点Y轴坐标

卡尺宽度

float

每个卡尺框的宽度,一般相等

卡尺高度

float

每个卡尺框的高度,一般相等

卡尺角度

float

每个卡尺框与水平方向的夹角,一般对应位置角度相差的大小为检测圆弧角度范围

表 54 卡尺框检测区

参数

类型

描述

卡尺框待检测中心点

-

  • 卡尺框检测中心X:float型,卡尺检测区中心点X轴坐标

  • 卡尺框检测中心Y:float型,卡尺检测区中心点Y轴坐标

卡尺框检测区宽度

float

每个卡尺检测区的宽度,一般相等

卡尺框检测区高度

float

每个卡尺检测区的高度,一般相等

卡尺框检测区角度

float

每个卡尺检测区与水平方向的夹角,一般对应位置角度相差的大小为检测圆弧角度范围

表 55 输出直线

参数

类型

描述

直线起点

-

  • 直线起点X:float型,输出直线的起点的X轴坐标

  • 直线起点Y:float型,输出直线的起点的Y轴坐标

直线终点

-

  • 直线终点X:float型,输出直线的终点的X轴坐标

  • 直线终点Y:float型,输出的直线的终点的Y轴坐标

表 56 最小外接矩形

参数

类型

描述

中心点

-

  • 中心X:float型,最小外接矩形的中点X轴坐标

  • 中心Y:float型,最小外接矩形中点的Y轴坐标

矩形宽度

float

最小外接矩形的宽度

矩形高度

float

最小外接矩形的高度

角度

float

矩形的较长边旋转至水平线方向的角度,顺时针为正,逆时针为负

表 57 边缘直线

参数

类型

描述

直线起点

-

  • 直线起点X:float型,边缘直线起点的X轴坐标

  • 直线起点Y:float型,边缘直线起点的Y轴坐标

直线终点

-

  • 直线终点X:float型,边缘直线终点的X轴坐标

  • 直线终点Y:float型,边缘直线终点的Y轴坐标

表 58 顶点

参数

类型

描述

顶点X

float

顶点的X轴坐标

顶点Y

float

顶点的Y轴坐标

表 59 中点线

参数

类型

描述

中点线起点

-

  • 中点线起点X:float型,四边形中点线起点的X轴坐标

  • 中点线起点Y:float,四边形中点线起点的Y轴坐标

中点线终点

-

  • 中点线终点X:float型,四边形中点线终点的X轴坐标

  • 中点线终点Y:float,四边形中点线终点的Y轴坐标

表 60 测量点

参数

类型

描述

测量点X

float

选用在直线外一点的方式时,输入的点的X坐标

测量点Y

float

选用在直线外一点的方式时,输入的点的Y坐标

表 61 测量直线

参数

类型

描述

测量直线起点

-

  • 测量直线起点X:float型,选用与直线相距一定距离的方式时,输入的直线的起点X坐标

  • 测量直线起点Y:float型,选用与直线相距一定距离的方式时,输入的直线的起点Y坐标

测量直线终点

-

  • 测量直线起点X:float型,选用与直线相距一定距离的方式时,输入的直线的终点X坐标

  • 测量直线起点Y:float型,选用与直线相距一定距离的方式时,输入的直线的终点Y坐标