测量

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

涉及模块如下:

说明:

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

线圆测量

表 1 线圆测量的输出结果

参数

类型

描述

模块状态

int

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

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

测量直线

-

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

测量直线角度

float

输入或查找到的测量直线角度(相对于X轴方向的旋转角度,顺时针为正,逆时针为负)

测量圆环

-

包含圆心点、内径、圆半径等,详情参见测量圆环

交点

-

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

垂足点

-

包含垂足点X和垂足点Y,详情参见垂足点

距离

float

测量圆圆心垂直于测量直线的距离

角度

float

测量圆圆心指向垂足的角度

卡尺检测区

-

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

圆圆测量

表 2 圆圆测量的输出结果

参数

类型

描述

模块状态

int

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

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

测量圆环

-

包含圆心点、内径、圆半径等,详情参见测量圆环

交点

-

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

角度

float

输入或查找到的圆0和圆1的圆心点连线的角度

距离

float

输入或查找到的圆0和圆1的圆心点的距离

卡尺检测区

-

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

点圆测量

表 3 点圆测量的输出结果

参数

类型

描述

模块状态

int

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

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

测量点

-

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

测量圆环

-

包含圆心点、内径、圆半径等,详情参见测量圆环

角度

float

输入测量点与输入测量圆圆心点连线的角度

中心距离

float

输入测量点到输入测量圆圆心的距离

最远距离

float

输入测量点到输入测量圆上最远的距离

最近距离

float

输入测量点到输入测量圆上最近的距离

点线测量

表 4 点线测量的输出结果

参数

类型

描述

模块状态

int

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

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

测量直线

-

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

测量直线角度

float

输入或查找到的测量直线角度(相对于X轴方向的旋转角度,顺时针为正,逆时针为负)

垂足点

-

包含垂足点X和垂足点Y,详情参见垂足点

垂足角度

float

输入测量点垂直于输入测量直线的角度

垂足距离

float

输入测量点到垂足点的距离

最近距离

float

输入测量点到输入测量直线的最近距离

最远距离

float

输入测量点到输入测量直线的最远距离

线线测量

表 5 线线测量的输出结果

参数

类型

描述

模块状态

int

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

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

测量直线

-

输入/查找到的直线的起点和终点,详情参见测量直线

测量直线角度

float

输入/查找到的直线的角度(相对于X轴方向的旋转角度,顺时针为正,逆时针为负)

交点

-

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

夹角

float

输入或查找到的直线0与直线1的夹角

绝对距离

float

两条直线4个端点到另一条直线的距离的平均值

角度标识点

-

包含角度标识点X和Y,详情参见角度标识点

卡尺检测区

-

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

表 6 角度标识点

参数

类型

描述

角度标识点*X

float

  • 点1:直线向量1的起点X轴坐标

  • 点2:直线向量1的终点X轴坐标

  • 点3:直线向量1和直线向量2的交点X轴坐标

  • 点4:直线向量2的起点X轴坐标

  • 点5:直线向量2的终点X轴坐标

角度标识点*Y

float

  • 点1:直线向量1的起点Y轴坐标

    点2:直线向量1的终点Y轴坐标

    点3:直线向量1和直线向量2的交点Y轴坐标

    点4:直线向量2的起点Y轴坐标

    点5:直线向量2的终点Y轴坐标

点点测量

表 7 点点测量的输出结果

参数

类型

描述

模块状态

int

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

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

测量点

-

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

中点

-

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

角度

float

输入的两个测量点连线相对于X轴方向的旋转角度,顺时针旋转则为正,逆时针为负

距离

float

输入的两个测量点的距离

表 8 中点

参数

类型

描述

中点X

float

输入的两个测量点的连线的中点的X轴坐标

中点Y

float

输入的两个测量点的连线的中点的Y轴坐标

亮度测量

表 9 亮度测量的输出结果

参数

类型

描述

模块状态

int

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

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

最小值

int

检测区域图像像素灰度值的最小值

最大值

int

检测区域图像像素灰度值的最大值

均值

float

检测区域图像像素灰度值的平均值

标准差

float

检测区域图像像素灰度值的标准差

直方图

int

256定长数组,检测区域内每一个灰度值所存在的像素点数

对比度

float

使用自动二值化将区域分为较亮部分和较暗部分,分别计算两个部分的灰度均值。两个灰度均值差即为对比度

检测区域

-

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

ROI圆弧

-

包含检测圆弧中心点、内径、外径等,详情参见ROI圆弧

输出掩膜

-

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

间距检测

表 10 间距检测的输出结果

参数

类型

描述

模块状态

int

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

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

边缘状态

int

0:未定位到边缘;1:定位到边缘

边缘个数

int

检测到的边缘对个数

测量宽度

float

检测到的间距的宽度(单位通常为像素)

分数

float

间距检测的得分

边缘*极性(*代表0-1)

int

1表示从灰度从黑到白,2表示从白到黑

边缘*位置(*代表0-1)

float

边缘点的偏移量

边缘点

-

包含边缘点X和Y,详情参见边缘点

直线起点(*代表0-1)

-

包含直线起点X和Y,详情参见直线起点(*代表0-1)

直线终点(*代表0-1)

-

包含直线终点X和Y,详情参见直线终点(*代表0-1)

直线*角度

float

边缘*所在直线的角度(相较于X轴方向的旋转角度,顺时针为正,逆时针为负)

检测区域

-

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

表 11 边缘点

参数

类型

描述

边缘点*X

float

边缘*上用于测量间距的点的X轴坐标

边缘点*Y

float

边缘*上用于测量间距的点的Y轴坐标

表 12 直线*起点(*代表0-1)

参数

类型

描述

直线*起点X

float

边缘*所在直线的起点的X轴坐标

直线*起点Y

float

边缘*所在直线的起点的Y轴坐标

表 13 直线*终点(*代表0-1)

参数

类型

描述

直线*终点Y

float

边缘*所在直线的终点的Y轴坐标

直线*终点X

float

边缘*所在直线的终点的X轴坐标

像素统计

表 14 像素统计的输出结果

参数

类型

描述

模块状态

int

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

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

像素数量

int

检测区域内在指定阈值范围内的像素点数

比率

float

检测区域内在指定阈值范围内的像素点数与总的像素点数的比值

检测区域

-

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

ROI圆弧

-

包含检测圆弧中心点、内径、外径等,详情参见ROI圆弧

输出掩膜

-

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

直方图工具

表 15 直方图工具的输出结果

参数

类型

描述

模块状态

int

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

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

像素数量

int

检测区域内总的像素点数

最小值

int

检测区域内像素灰度值的最小值

最大值

int

检测区域内像素灰度值的最大值

中值

int

检测区域内像素灰度值的中值

峰值

int

检测区域内出现次数最多的像素值

均值

float

检测区域内所有像素灰度值的平均值

标准差

float

检测区域内所有像素灰度值的标准差

对比度

float

使用自动二值化将区域分为较亮部分和较暗部分,分别计算该两个部分的灰度均值。该两个灰度均值差即为对比度

直方图

int

256定长数组,检测区域内每一个灰度值所存在的像素点数

累积直方图

int

256定长数组,检测区域内从0开始递增累计的像素点数

检测区域

-

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

ROI圆弧

-

包含检测圆弧中心点、内径、外径等,详情参见ROI圆弧

输出掩膜

-

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

共用数据结构

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

表 16 测量直线

参数

类型

描述

测量直线起点

-

  • 测量直线起点X:float型,输入或查找到的测量直线起点的X轴坐标

  • 测量直线起点Y:float型,输入或查找到的测量直线起点的Y轴坐标

测量直线终点

-

  • 测量直线起点X:float型,输入或查找到的测量直线终点的X轴坐标

  • 测量直线起点Y:float型,输入或查找到的测量直线终点的Y轴坐标

表 17 测量圆环

参数

类型

描述

圆心点

-

  • 圆心X:输入或查找到的圆的圆心点的X轴坐标

  • 圆心Y:输入或查找到的圆的圆心点的Y轴坐标

圆半径

float

输入或查找到的圆半径

内径

float

输入或查找到的测量圆内径(默认为0)

圆角度范围

float

输入或查找到的测量圆角度范围(默认为360)

圆起始角度

float

输入或查找到的测量圆起始角度(默认为0)

表 18 交点

参数

类型

描述

交点X

float

两个目标形状的交点的X轴坐标,例如:

  • 线圆测量:测量直线与测量圆相交点X轴坐标

  • 圆圆测量:输入或查找到的圆0和圆1的交点的X轴坐标

交点Y

float

两个目标形状的交点的Y轴坐标,例如:

  • 线圆测量:测量直线与测量圆相交点Y轴坐标

  • 圆圆测量:输入或查找到的圆0和圆1的交点的Y轴坐标

表 19 垂足点

参数

类型

描述

垂足点X

float

测量圆圆心点垂直于测量直线的交点的X轴坐标

垂足点Y

float

测量圆圆心点垂直于测量直线的交点的Y轴坐标

表 20 卡尺检测区

参数

类型

描述

卡尺检测区中心点

-

  • 卡尺检测区中心点X:float型,用于查找直线或圆的卡尺框矩形中心的X轴坐标

  • 卡尺检测区中心点Y:float型,用于查找直线或圆的卡尺框矩形中心的Y轴坐标

卡尺检测区高度*

float

用于查找直线或圆的卡尺框矩形高度

卡尺检测区角度*

float

用于查找直线或圆的卡尺框矩形旋转角度

卡尺检测区宽度*

float

用于查找直线或圆的卡尺框矩形宽度

表 21 测量点

参数

类型

描述

测量点X

float

输入测量点的X轴坐标

测量点Y

float

输入测量点的Y轴坐标

表 22 检测区域

参数

类型

描述

检测区域中心点

float

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

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

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

检测区域宽度

float

ROI的宽度

检测区域高度

float

ROI的高度

检测区域角度

float

ROI旋转为正准位姿的角度。顺时针旋转则角度为正,逆时针旋转则角度为负

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

表 23 ROI圆弧

参数

类型

描述

检测圆弧中心点

-

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

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

检测圆弧内径

float

圆弧ROI的内径

检测圆弧外径

float

圆弧ROI的外径

检测圆弧起始角度

float

圆弧ROI的起始边与X轴正方向的夹角

检测圆弧角度范围

float

圆弧ROI从起始边开始至终止边结束所跨过的角度范围

表 24 输出掩膜

参数

类型

描述

输出掩膜图像

image

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

输出掩膜宽度

int

输出掩膜图像的宽度

输出掩膜高度

int

输出掩膜图像的高度

输出掩膜像素格式

int

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