OpenCV(C++)中与MATLAB imfill(BW,locations,conn)等效的实现是什么

你判断的方向完全正确，针对带locations（指定填充种子点）、conn（连通规则）入参的imfill特定变体，OpenCV中直接调用floodFill即可实现行为对齐，不需要手写连通域遍历逻辑。

参数映射规则 #

MATLAB该版本imfill的核心行为是：从传入的种子点出发，按照指定连通规则，将被前景包围的背景连通域全部填充为前景，和floodFill的填充逻辑完全匹配，参数对应关系如下：

• 输入输出图像：传入原二值图的副本即可，floodFill支持就地修改，填充结果直接写入输出图。
• 种子点：对应locations传入的坐标，注意OpenCV坐标体系为(x=列号, y=行号)，和MATLAB默认的(行号, 列号)索引顺序相反，需要做顺序转换。
• 连通规则：对应floodFill的flags参数低8位，conn=4传值4，conn=8传值8，连通判定规则和MATLAB完全一致。
• 填充值：8位单通道二值图的前景值通常为255，newVal参数传入Scalar(255)即可。
• 填充范围限制：将loDiff、upDiff两个阈值参数均设为Scalar(0)，保证仅填充和种子点（背景值0）同值的连通区域，不会误覆盖原有前景。
• 掩膜：floodFill要求传入的掩膜比原图宽2像素、高2像素，初始化全0Mat传入即可；多种子点场景下复用同一个掩膜可自动跳过已填充区域，提升执行效率。

可直接复用的实现代码 #

#include <opencv2/opencv.hpp>

/**
 * @brief 等效实现MATLAB imfill(BW, locations, conn) 带种子点、指定连通规则的填充功能
 * @param inputBW 输入8位单通道二值图，背景为0，前景为255
 * @param locations 填充种子点列表，若为MATLAB导出的(row, col)格式，传入时需交换x/y顺序
 * @param conn 连通规则，仅支持4连通、8连通
 * @return 填充后的二值图
 */
cv::Mat imfillWithSeeds(const cv::Mat& inputBW, const std::vector<cv::Point>& locations, int conn = 8)
{
    CV_Assert(inputBW.type() == CV_8UC1);
    CV_Assert(conn == 4 || conn == 8);

    cv::Mat filledRes = inputBW.clone();
    // 初始化符合floodFill尺寸要求的全0掩膜
    cv::Mat floodMask = cv::Mat::zeros(inputBW.rows + 2, inputBW.cols + 2, CV_8UC1);

    for (const auto& rawSeed : locations)
    {
        // 坐标转换：如果rawSeed是MATLAB风格(行,列)，请保留下面这行交换x/y；如果已经是OpenCV风格(列,行)，直接用rawSeed即可
        cv::Point seed(rawSeed.y, rawSeed.x);
        
        cv::floodFill(
            filledRes,
            floodMask,
            seed,
            cv::Scalar(255),    // 填充为前景值255
            nullptr,
            cv::Scalar(0),      // 低阈值：仅填充值和种子点（0）差值为0的像素
            cv::Scalar(0),      // 高阈值
            conn | (255 << 8)   // flags：低8位设连通数，高8位设掩膜填充值为255，避免重复填充
        );
    }

    return filledRes;
}

常见踩坑点 #

• 坐标顺序错误是最高发问题：如果直接把MATLAB读取的(row, col)坐标按顺序传入OpenCV的Point，会导致种子点偏移，甚至落在图像外触发报错。
• 若传入的种子点本身落在前景（值为255）区域，floodFill不会执行任何填充操作，和MATLAB原生行为一致，无需额外做前置判断。
• 不要省略阈值参数：如果不设置loDiff和upDiff，默认的浮动范围填充可能会误覆盖原有前景区域，导致结果和MATLAB不一致。

内容的提问来源于stack exchange，提问作者Ori Hirshfeld