如何在OpenCV C++中将cv::Mat图像叠加到指定位置？

核心问题分析 #

直接调用addWeighted会因前景与背景尺寸不匹配触发内存错误；仅支持(0,0)位置的代码未处理前景超出背景边缘的边界情况，导致非原点位置操作越界。

通用叠加实现（支持任意位置、边缘部分显示） #

以下代码可处理任意叠加位置，自动裁剪超出背景的前景区域，同时支持自定义透明度：

#include <opencv2/opencv.hpp>
#include <algorithm> // 用于std::max/std::min

void overlayImage(cv::Mat& background, const cv::Mat& foreground, int pos_x, int pos_y, double alpha = 0.5) {
    // 计算背景中可叠加的有效ROI区域，避免越界
    int roi_start_x = std::max(0, pos_x);
    int roi_start_y = std::max(0, pos_y);
    // 计算前景中需要裁剪的起始位置（当pos为负数时，前景从中间开始裁剪）
    int fg_crop_x = std::max(0, -pos_x);
    int fg_crop_y = std::max(0, -pos_y);
    // 计算ROI的实际宽高（取背景剩余空间和前景剩余空间的较小值）
    int roi_width = std::min(background.cols - roi_start_x, foreground.cols - fg_crop_x);
    int roi_height = std::min(background.rows - roi_start_y, foreground.rows - fg_crop_y);

    // 无重叠区域直接返回
    if (roi_width <= 0 || roi_height <= 0) return;

    // 提取背景的ROI和裁剪后的前景区域
    cv::Mat bg_roi = background(cv::Rect(roi_start_x, roi_start_y, roi_width, roi_height));
    cv::Mat fg_roi = foreground(cv::Rect(fg_crop_x, fg_crop_y, roi_width, roi_height));

    // 加权叠加，结果直接写入背景ROI（无需额外内存）
    cv::addWeighted(fg_roi, alpha, bg_roi, 1.0 - alpha, 0.0, bg_roi);
}

// 测试示例
int main() {
    cv::Mat bg = cv::imread("background.jpg");
    cv::Mat fg = cv::imread("foreground.jpg");

    if (bg.empty() || fg.empty()) {
        std::cerr << "图像读取失败！" << std::endl;
        return -1;
    }

    // 叠加位置：(300, 200)，透明度0.6
    overlayImage(bg, fg, 300, 200, 0.6);

    cv::imshow("叠加结果", bg);
    cv::waitKey(0);
    cv::imwrite("overlay_result.jpg", bg);

    return 0;
}

带透明通道的前景叠加（PNG等带Alpha通道的图像） #

如果前景是带Alpha通道的4通道图像，可直接利用Alpha通道控制透明度，无需手动指定alpha值：

void overlayImageWithAlpha(cv::Mat& background, const cv::Mat& foreground, int pos_x, int pos_y) {
    int roi_start_x = std::max(0, pos_x);
    int roi_start_y = std::max(0, pos_y);
    int fg_crop_x = std::max(0, -pos_x);
    int fg_crop_y = std::max(0, -pos_y);
    int roi_width = std::min(background.cols - roi_start_x, foreground.cols - fg_crop_x);
    int roi_height = std::min(background.rows - roi_start_y, foreground.rows - fg_crop_y);

    if (roi_width <= 0 || roi_height <= 0) return;

    cv::Mat bg_roi = background(cv::Rect(roi_start_x, roi_start_y, roi_width, roi_height));
    cv::Mat fg_roi = foreground(cv::Rect(fg_crop_x, fg_crop_y, roi_width, roi_height));

    // 分离前景的BGR通道和Alpha通道
    std::vector<cv::Mat> fg_channels;
    cv::split(fg_roi, fg_channels);
    cv::Mat fg_bgr = cv::merge(std::vector<cv::Mat>{fg_channels[0], fg_channels[1], fg_channels[2]});
    cv::Mat fg_alpha = fg_channels[3];

    // 将Alpha通道归一化到0-1范围
    fg_alpha.convertTo(fg_alpha, CV_32F, 1.0 / 255.0);
    cv::Mat bg_alpha = cv::Scalar::all(1.0) - fg_alpha;

    // 按通道加权叠加，保留背景原有色彩
    for (int c = 0; c < 3; ++c) {
        bg_roi.channels()[c] = bg_roi.channels()[c].mul(bg_alpha) + fg_bgr.channels()[c].mul(fg_alpha);
    }
}

关键逻辑说明 #

1. 边界处理：通过std::max和std::min计算有效叠加区域，确保ROI不会超出背景范围，前景也只会裁剪到与ROI匹配的尺寸。
2. ROI复用：直接操作背景的ROI区域，无需额外复制整个背景图，节省内存。
3. 兼容性：支持任意叠加位置（包括负数位置，即前景部分在背景外），自动显示重叠区域。

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