提取四边形

## 提取四边形

找到符合梯度响应值的边缘点，利用ransac拟合四条直线

## 参数配置说明

### 主界面参数
![](/media/202602/2026-02-10_175342_9790810.280608145039557.png)

【**直线设置**】
    直线1：选择直线1的参数进行设置
    直线2：选择直线2的参数进行设置
    直线3：选择直线3的参数进行设置
    直线4：选择直线4的参数进行设置
【**梯度阈值**】边缘位置沿着扫描方向的灰度梯度，大于该阈值的点被保留。图像清晰、边缘明显时：设置较高的值（ >40)，图像模糊或边缘不明显时：设置较低值（10-30）
![](/media/202601/tidu_1769762616.png)
【**直线扫描方向**】从上到下或者从下到上扫描，由ROI上箭头指示。

【**直线极性**】
    由黑到白：沿矩形箭头，由低灰度区域指向高灰度区域。
    由白到黑：沿矩形箭头，由高灰度区域指向低灰度区域。
    全部：既可以检测由黑到白，也可以检测由白到黑。
![](/media/202601/jixing_1769766940.png)
【**拟合点选择**】
    全部点：使用所有检测到的边缘点。
    最强点：使用扫描方向上遇到的梯度值最大的边缘点。
    第一排点：使用扫描方向上遇到的第一个边缘点。
    最后一排点：使用扫描方向上遇到的最后一个边缘点。

![](/media/202602/拟合点选择_1770083578.png)
【**直线筛选**】
    最优拟合：综合考虑拟合最优的直线；
    最多拟合点：拟合的直线中，符合条件的拟合点的数量最多的直线；
    最强拟合：拟合的直线中，拟合点的梯度值最强的直线；
    第一条：沿着扫描方向拟合的第一条直线；
    最后一条：沿着扫描方向拟合的最后一条直线；
    指定ID条：沿着扫描方向，筛选出指定第ID条直线。

### 高级参数
![](/media/202602/2026-02-10_175434_9054050.14687503191355578.png)
筛选参数：
【**直线同步修改**】当勾选时，修改任意一条直线的参数，其余三条直线的参数也会同步修改

【**高斯滤波阈值**】高斯函数中的σ，此处可以理解为过渡区域像素宽度的一半。(值越大，噪点影响越小，但边缘也会变得模糊，值越小，保留更多细节，但噪点影响也越大)
![](/media/202602/滤波阈值_1770111631.png)
【**与ROI角度范围**】拟合直线时允许的直线偏移角度。如下图，将与ROI角度范围设置为16，直线角度-ROI角度  = 9，在16以内，直线符合

![](/media/202602/与ROI角度_1770110521.png)
【**采样点数**】对ROI扫描线垂直的方向均匀等分的数量

![](/media/202602/采样点数_1770016300.png)
【**采样点宽度**】按照采样点数均分的中心点，取采样点宽度，形成一个个小的矩形区域，在这些小的矩形区域中沿着扫描方向计算和判断，检查是否有符合条件的边缘点。

![](/media/202602/采样点宽度_1770017004.png)
【**拟合点数**】拟合直线中最少的拟合点数量，小于该值被认为拟合失败。如下图，拟合点数设置为5，白圈标示的总共6个
![](/media/202602/最少拟合点数_1770111223.png)
【**距离阈值**】边缘点到拟合直线垂直距离小于该值的点，会被用来拟合直线。如下图，检测到的边缘点与直线距离小于距离阈值，显示为蓝色，大于距离阈值，显示为红色。

![](/media/202602/距离阈值_1770630645.png)
【**最大迭代次数**】需要不断迭代的最大次数，如果提前拟合出了符合条件的直线，则可以提前停止拟合。

【**迭代无提升次数**】在拟合时，直线的拟合效果没有继续增强则停止迭代。

【**得分阈值**】最终判断直线的得分，得分小于该阈值时被认为拟合失败，范围是0-1。用所有边缘点到拟合直线的垂直距离求和，值越小，得分越高， 当所有的拟合点都在拟合的直线上时，得分是1。

### 其它参数：

【**尺寸转换**】
    不启用：不进行尺寸转换
    比例尺：手动输入一个数值，进行图像坐标到现实坐标的转换
    标定：连接一个标定数据，进行图像坐标到现实坐标的转换

### ROI设置
![](/media/202601//1767686688.3281448.png)
【ROI类型】默认检测区域的ROI类型为斜矩形。

【ROI来源】手动ROI：可在窗口手动拖动ROI的位置及大小；引用ROI:可在端口连接外部ROI。

【位置修正】选择姿态修正后可连接坐标系使ROI区域跟随坐标系移动。

【位置调整】调整ROI的位置及大小。

### 掩膜设置
![](/media/202602/掩膜设置_1770632097.png)
【**掩膜启用**】
    不启用：掩膜不会生效
    启用：掩膜生效
【**掩膜类型**】
    屏蔽掩膜：不检测掩膜区域。
    检测掩膜：只检测掩膜区域。
【**掩膜来源**】
    手动掩膜： 可用画笔、形状等进行掩膜编辑，绘制掩膜区域。
    引用掩膜：可连接已有端口，导入端口数据，自动绘制掩膜区域。
    
## 输出说明
  运行结果：成功输出真，失败输出假。
  中心点：检测到的四条直线形成的四边形的中心点
  12顶点：直线1和直线2的交点
  23顶点：直线2和直线3的交点
  34顶点：直线3和直线4的交点
  41顶点：直线4和直线1的交点
  12夹角：直线1和直线2的夹角
  23夹角：直线2和直线3的夹角
  34夹角：直线3和直线4的夹角
  41夹角：直线4和直线1的夹角
  直线1角度：检测到的直线1的角度
  直线2角度：检测到的直线2的角度
  直线3角度：检测到的直线3的角度
  直线4角度：检测到的直线4的角度
  直线1：检测到的直线1
  直线2：检测到的直线2
  直线3：检测到的直线3
  直线4：检测到的直线4
  斜矩形ROI1：用来检测的ROI1
  斜矩形ROI2：用来检测的ROI2
  斜矩形ROI3：用来检测的ROI3
  斜矩形ROI4：用来检测的ROI4
  掩膜区域1：输出掩膜1
  掩膜区域2：输出掩膜2
  掩膜区域3：输出掩膜3
  掩膜区域4：输出掩膜4
![](/media/202602/2026-02-10_175752_0488740.1977279399522074.png)

点击此处跳转到对应的中文说明书文章页:&nbsp;[Extract Quadrilateral](/doc/422)