文章目录
- org.openpnp.vision.pipeline.stages.FilterContours
- 功能
- 参数
- 例子
- 生成测试图片
- cv-pipeline config
- 效果
- END
org.openpnp.vision.pipeline.stages.FilterContours
功能
根据轮廓面积对轮廓进行过滤。它从前序阶段获取轮廓列表（List），计算每个轮廓的面积，只保留面积在指定范围内的轮廓，输出过滤后的轮廓列表。
该阶段常用于去除噪声、小斑点或过大干扰区域，只保留感兴趣的目标轮廓，以便后续处理（如拟合椭圆、旋转矩形等）。
参数
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
contoursStageName | String | 否 | 指定流水线中提供轮廓列表（List<MatOfPoint>）的那个阶段的名称。如果为空或找不到对应结果，则跳过处理。 |
minArea | double | 是 | 轮廓的最小面积阈值。只有面积 ≥minArea的轮廓才被保留。设置为-1表示无下限。 |
maxArea | double | 是 | 轮廓的最大面积阈值。只有面积 ≤maxArea的轮廓才被保留。设置为-1表示无上限。 |
propertyName | String | 否 | 用于动态覆盖minArea和maxArea的属性名前缀。格式：propertyName.minArea、propertyName.maxArea。默认值为"FilterContours"。 |
例子
生成测试图片
importcv2importnumpy as np# 创建白色背景 (600x600)img=np.ones((600,600,3),dtype=np.uint8)*255# 绘制三个不同面积的黑色圆形（实心）# 小圆 (面积 ≈ π*20² ≈ 1256)cv2.circle(img,(150,150),20,(0,0,0), -1)# 中圆 (面积 ≈ π*40² ≈ 5026)cv2.circle(img,(300,300),40,(0,0,0), -1)# 大圆 (面积 ≈ π*70² ≈ 15394)cv2.circle(img,(500,500),70,(0,0,0), -1)# 添加一个极小的噪声点（面积很小，用于演示过滤）cv2.circle(img,(100,500),3,(0,0,0), -1)# 保存图片cv2.imwrite("filter_test.png", img)print("测试图片已生成: filter_test.png (包含小圆、中圆、大圆和一个小噪点)")cv-pipeline config
<cv-pipeline><stages><cv-stageclass="org.openpnp.vision.pipeline.stages.ImageRead"name="read"enabled="true"file="D:\3rd\openpnp_prj\openpnp-official\openpnp-test-images\my_test\filter_test.png"color-space="Bgr"handle-as-captured="false"/><cv-stageclass="org.openpnp.vision.pipeline.stages.ConvertColor"name="gray"enabled="true"conversion="Bgr2Gray"/><cv-stageclass="org.openpnp.vision.pipeline.stages.Threshold"name="thresh"enabled="true"threshold="127"auto="false"invert="true"/><cv-stageclass="org.openpnp.vision.pipeline.stages.FindContours"name="contours"enabled="true"retrieval-mode="External"approximation-method="Simple"/><cv-stageclass="org.openpnp.vision.pipeline.stages.ImageRecall"name="recall"enabled="true"image-stage-name="read"/><cv-stageclass="org.openpnp.vision.pipeline.stages.DrawContours"name="draw"enabled="true"contours-stage-name="contours"thickness="2"index="-1"><colorr="255"g="0"b="0"a="255"/></cv-stage><cv-stageclass="org.openpnp.vision.pipeline.stages.ImageWrite"name="save"enabled="true"file="output_one_contour.png"/></stages></cv-pipeline>效果
index = -1， 圈住所有目标
index = 0 圈住第1个目标。
index = n - 1, 圈住最后一个目标
index >= n, 报错
