OpenCV中cv::grabCut函数需手动构造含GC_BGD=0、GC_FGD=1、GC_PR_BGD=2、GC_PR_FGD=3四类标记的mask，初始化须确保至少一个GC_FGD和GC_BGD，结果提取应合并GC_FGD与GC_PR_FGD。
GrabCut在OpenCV中对应的函数是cv::grabCut
它本身不提供交互界面，必须配合鼠标事件手动收集前景/背景种子点。OpenCV的cv::grabCut只做图像分割计算，输入依赖你构造的mask（掩码图）和可能的矩形ROI。常见错误是直接传入全0或全1的mask，结果要么全黑要么无分割——它需要明确的“已知前景”（GC_FGD=1）、“已知背景”（GC_BGD=0）、“可能前景”（GC_PR_FGD=3）三类标记。
典型使用流程是：
- 先用矩形粗略框出目标（cv::Rect），初始化mask为GC_PR_FGD
- 调用一次cv::grabCut，模式设为cv::GC_INIT_WITH_RECT
- 再通过鼠标左键画前景、右键画背景，把对应像素设为GC_FGD或GC_BGD
- 每次修改mask后，用cv::GC_INIT_WITH_MASK模式重运行
鼠标交互时mask值必须严格按OpenCV定义设置
OpenCV的cv::grabCut内部只识别4个整数值：GC_BGD=0、GC_FGD=1、GC_PR_BGD=2、GC_PR_FGD=3。任何其他值（比如用true/false、或误写成1/2混用）都会导致未定义行为，常见现象是输出mask全为0或程序卡死。
实操建议：
- 声明mask用cv::Mat mask(img.size(), CV_8UC1, cv::Scalar(cv::GC_PR_FGD))初始化
- 鼠标回调中，用mask.at<uchar>(y,x) = cv::GC_FGD</uchar>或cv::GC_BGD赋值
- 切勿用mask.at<int>()</int>或mask.at<vec3b>()</vec3b>——类型错配会静默破坏内存
调用cv::grabCut前必须确保mask含至少一个GC_FGD和一个GC_BGD
即使你用矩形初始化，OpenCV也要求迭代前mask里存在明确的已知前景与背景区域。否则会报错Assertion failed (bgdSamples.size() > 0 && fgdSamples.size() > 0)，或返回空结果。这不是bug，是算法数学前提：GrabCut基于高斯混合模型（GMM），需要两类样本初始化参数。
安全做法：
- 矩形初始化后，手动将矩形内中心小块设为GC_FGD，矩形外一圈边缘像素设为GC_BGD
- 或更稳妥：首次调用前，用cv::rectangle(mask, rect, cv::Scalar(cv::GC_FGD), -1)填前景矩形，再用cv::rectangle(mask, enlarged_rect, cv::Scalar(cv::GC_BGD), -1)扩大一圈填背景
- 每次鼠标标注后，用cv::countNonZero(mask == cv::GC_FGD)和cv::countNonZero(mask == cv::GC_BGD)检查是否两类都存在
抠图结果提取要过滤掉GC_PR_BGD和GC_BGD像素
最终mask输出包含4种值，但只有GC_FGD和GC_PR_FGD属于“前景候选”。直接用mask == 1会漏掉大量实际前景（因为多数像素被标为GC_PR_FGD=3）。正确做法是合并这两类：cv::Mat foreground_mask = (mask == cv::GC_FGD) | (mask == cv::GC_PR_FGD)。
立即学习“C++免费学习笔记（深入）”；
后续合成时注意：
- 用cv::bitwise_and提取前景需先转为CV_8UC1单通道掩码
- 若需透明通道（RGBA），得把foreground_mask归一化到[0,255]再作为alpha通道
- 不要用mask.copyTo(result, foreground_mask)——这会把非前景区域留黑，不是“抠图”，是“挖洞”
最易被忽略的是：GrabCut对纹理单一、边缘模糊或前景背景颜色相近的图像效果很差，此时手动多标几处典型前景/背景点比调参更有效；另外，每次cv::grabCut调用耗时约几十毫秒，频繁重算（如鼠标拖动实时更新）会导致卡顿，应加节流逻辑，比如仅在松开鼠标后执行一次。
