调用cv2.seamlessClone触发(-215)断言失败错误求助

可能的错误原因 #

• 输入图像为空：image、image_with_fail或image_with_fail_mask未正确加载，导致后续处理时传入空图像。
• 通道数不匹配：seamlessClone要求源图、目标图为3通道图像，单通道灰度图直接传入会触发内部处理错误。
• 数据类型或掩码格式问题：掩码必须是8位单通道（uint8）的二值图像，且输入图像的像素值范围需与函数预期一致（uint8为0-255，float32通常为0-1）。
• 中心坐标越界：固定的(143,143)坐标超出目标图像的尺寸范围，导致内部处理失败。

分步解决方案 #

1. 验证输入图像有效性 #

在处理前添加断言，确认所有输入图像非空且尺寸合理：

import cv2
import numpy as np

# 确保图像已正确加载
assert not image.empty, "目标图像为空"
assert not image_with_fail.empty, "带故障的源图像为空"
assert not image_with_fail_mask.empty, "掩码图像为空"

# 打印尺寸信息，方便排查
print(f"目标图像尺寸: {image.shape}")
print(f"源图像尺寸: {image_with_fail.shape}")
print(f"掩码尺寸: {image_with_fail_mask.shape}")

2. 统一图像尺寸与通道数 #

将单通道灰度图转换为3通道，同时确保目标图与源图尺寸一致：

# 调整目标图尺寸与源图匹配
image = cv2.resize(image, (image_with_fail.shape[1], image_with_fail.shape[0]))

# 单通道转3通道（seamlessClone强制要求3通道输入）
image = cv2.cvtColor(image, cv2.COLOR_GRAY2BGR)
image_with_fail = cv2.cvtColor(image_with_fail, cv2.COLOR_GRAY2BGR)

3. 规范掩码格式 #

确保掩码为8位单通道二值图像：

# 转换为uint8类型
image_with_fail_mask = np.array(image_with_fail_mask, dtype=np.uint8)

# 若掩码是3通道，转为单通道
if len(image_with_fail_mask.shape) == 3:
    image_with_fail_mask = cv2.cvtColor(image_with_fail_mask, cv2.COLOR_BGR2GRAY)

# 二值化处理，确保掩码只有0和255两个值
_, image_with_fail_mask = cv2.threshold(image_with_fail_mask, 127, 255, cv2.THRESH_BINARY)

4. 调整融合中心坐标 #

避免固定坐标越界，改用图像中心作为融合点：

# 计算图像中心坐标
center = (image.shape[1] // 2, image.shape[0] // 2)

5. 调用seamlessClone（使用uint8类型更稳定） #

# 转换为uint8类型（避免float32范围不匹配问题）
result = cv2.seamlessClone(
    src=image_with_fail.astype(np.uint8),
    dst=image.astype(np.uint8),
    mask=image_with_fail_mask,
    p=center,
    flags=cv2.NORMAL_CLONE
)

关键说明 #

• 若坚持使用float32类型，需确保所有图像的像素值范围统一为0-1（可通过除以255实现），否则可能触发内部处理错误。
• 掩码的非0区域必须精准覆盖需要融合的故障区域，否则融合效果会不符合预期。

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