图像掩码操作是用二值矩阵控制图像像素保留与否，c++中最常用实现是cv::bitwise_and函数，要求掩码为cv_8uc1类型、值为0或255、尺寸与原图一致，该函数自动广播单通道掩码至多通道并安全处理roi。
什么是图像掩码操作，C++里最常用的实现方式是什么
图像掩码操作本质是用一个二值（或单通道）矩阵控制另一个图像的像素是否保留——对应位置为 1（或非零）则保留原图像素，为 0 则置为背景色（如黑色）。在 C++ 中，不依赖 OpenCV 就很难做；cv::bitwise_and 是最直接、最稳定的入口函数，它底层做了类型对齐和 ROI 处理，比手写循环安全得多。
常见错误是直接用 cv::Mat 的 operator[] 或 at<uchar>()</uchar> 遍历掩码并赋值，结果因通道数不匹配（比如掩码是单通道，原图是三通道）导致越界或全黑。OpenCV 的位运算函数会自动广播单通道掩码到多通道目标，这是关键优势。
如何用 cv::bitwise_and 正确做掩码，参数要注意什么
cv::bitwise_and 不是“把掩码画上去”，而是按位与运算：只有原图像素和掩码值都非零时，结果才保留原值。所以掩码必须是 CV_8UC1 类型（单通道 8 位），且值应为 0 或 255（不是 0/1）——OpenCV 内部按字节处理，传入 1 会被当 1，但很多绘图函数（如 cv::circle）默认画 255。
- 原图和掩码必须尺寸一致，否则运行时报错
OpenCV(4.10.0) ... error: (-215:Assertion failed) src1.size == src2.size - 掩码若为浮点型（
CV_32F），需先convertScaleAbs转成CV_8U，否则结果全零 - 想保留透明背景？得先把原图转成四通道（
cv::cvtColor(img, img_bgra, cv::COLOR_BGR2BGRA)），再用cv::bitwise_and，否则 alpha 通道不会被影响
自己生成掩码时，cv::Mat::setTo 和 cv::rectangle 哪个更可靠
两者都行，但行为不同：cv::Mat::setTo 是整图赋值，适合全白/全黑掩码；cv::rectangle 等绘图函数默认在 ROI 上操作，且会自动处理类型转换——即使你传的是 cv::Scalar(255)，它也会塞进 CV_8UC1 掩码里。
容易踩的坑是：用 cv::Mat mask = cv::Mat::zeros(img.size(), CV_8UC1) 创建掩码后，直接 mask.at<uchar>(y,x) = 255</uchar> 逐点设值。这在小图上没问题，但大图性能差，且极易因 y/x 反了（OpenCV 是 row, col 即 y, x）导致掩码偏移。绘图函数内部已做边界检查，更鲁棒。
为什么掩码后图像变暗或发灰，是不是函数用错了
大概率是掩码本身没做好：比如用 cv::threshold 得到的掩码是 CV_8UC1，但阈值设太低，大量区域被误判为 0；或者原图是 CV_8UC3（BGR），而你拿 CV_32FC1 的浮点掩码去算，OpenCV 不报错但结果不可控。
调试建议：用 cv::imshow("mask", mask) 单独看掩码窗口——如果一片黑，说明全是 0；如果灰蒙蒙，说明值不是严格的 0/255。此时加一句 mask.convertScaleAbs(mask) 再试。另外，cv::bitwise_and 对输入不做归一化，它只认字节值，不认语义。
掩码操作看着简单，但类型、通道、数值范围三个维度只要错一个，结果就完全不对；别信“差不多”，OpenCV 的位运算是精确字节级的。
C++免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 C++ 的入门与实战技巧！
