OpenCv漫水填充floodFill详解

最新推荐文章于 2025-08-04 21:50:46 发布

原创

最新推荐文章于 2025-08-04 21:50:46 发布 · 1.9k 阅读

7 ·

CC 4.0 BY-SA版权

文章标签：

#opencv #计算机视觉 #人工智能

本文详细介绍了OpenCV的floodFill函数，包括参数解析、功能说明及示例应用。通过实例展示了如何使用floodFill进行连通区域填充，并对比了FLOODFILL_FIXED_RANGE和FLOODFILL_MASK_ONLY两种填充模式的区别。同时，讨论了flags参数中的邻接性设置对填充效果的影响。

1.函数原型:

 void cvFloodFill (
     IplImage * img,        　// 输入图像
     CvPoint    seedPoint,    // 种子点
     CvScalar newVal,    　　 // 像素点被染色的值
     CvScalar loDiff = cvScalarAll(0),     // 染色边界判定
     CvScalar upDiff = cvScalarAll(0),     // 染色边界判定
     CvConnectedComp * comp = NULL,        // 填充区域统计属性
     int flags = 4,                        // 连通性，相关性等参数设置。
     CvArr * mask = NULL                   // 掩码区域
);

image 【输入/输出】 1或者3通道、 8bit或者浮点图像。仅当参数flags的FLOODFILL_MASK_ONLY标志位被设置时image不会被修改，否则会被修改。
mask 【输入/输出】操作掩码，必须为单通道、8bit，且比image宽2个像素、高2个像素。使用前必须先初始化。Flood-filling无法跨越mask中的非0像素。例如，一个边缘检测的结果可以作为mask来阻止边缘填充。在输出中，mask中与image中填充像素对应的像素点被设置为1，或者flags标志位中设置的值(详见flags标志位的解释)。此外，该函数还用1填充了mask的边缘来简化内部处理。因此，可以在多个调用中使用同一mask，以确保填充区域不会重叠。
seedPoint 起始像素点
newVal 重绘像素区域的新的填充值(颜色)
rect 可选输出参数，返回重绘区域的最小绑定矩形。
loDiff 当前选定像素与其连通区中相邻像素中的一个像素，或者与加入该连通区的一个seedPoint像素，二者之间的最大下行差异值。
upDiff 当前选定像素与其连通区中相邻像素中的一个像素，或者与加入该连通区的一个seedPoint像素，二者之间的最大上行差异值。
flags flags标志位是一个32bit的int类型数据，其由3部分组成： 0-7bit表示邻接性(4邻接、8邻接)；8-15bit表示mask的填充颜色；16-31bit表示填充模式（详见填充模式解释）

flood fill填充模式:


//! floodfill algorithm flags

enum FloodFillFlags {
   
   

    /** If set, the difference between the current pixel andseed pixel is considered. Otherwise,

   the difference between neighbor pixels is considered (that is, the rangeis floating). */

   FLOODFILL_FIXED_RANGE = 1 << 16,

    /** If set, the function does not change the image ( newValis ignored), and only fills the

   mask with the value specified in bits 8-16 of flags as described above.This option only make

   sense in function variants that have the mask parameter. */

   FLOODFILL_MASK_ONLY   = 1 <<17

};

FLOODFILL_FIXED_RANGE：如果设置了该值，则考虑当前像素与seed像素之间的差异，否则考虑相邻像素之间的差异(即浮动区间)。

FLOODFILL_MASK_ONLY：如果设置了该值，floodFill函数不会修改image的内容(newVal被忽略)，只使用flags标志中bit8-15的值填充mask。该选项仅在含mask参数的floodFill函数中有效。

2.函数作用：

用给定的颜色填充一个连通区域。

示例：
先创建一个 20*10 像素的灰度图像，为了便于观察，我们以 60 个灰度为一个等级填充图片：

import cv2
import numpy as np
 
img = np.zeros((20,10), dtype=np.uint8)
i = 0 
for v in img:
    v[:] = i//5 * 60
    i += 1
    
cv2.imshow('img', img)
cv2.waitKey(0)
cv2.destroyAllWindows()