PyQt6图像编辑器中cv2与QPixmap/QImage颜色显示不一致问题

核心原因 #

OpenCV默认以BGR色彩空间加载图像，而QImage/QPixmap使用的是RGB色彩空间，通道顺序颠倒直接导致颜色显示偏差（比如红色通道被错误识别为蓝色通道，视觉上偏红）。此外，TIFF图像的位深（8位/16位）不匹配QImage格式也会引发颜色截断或映射错误。

解决方案 #

1. 修正色彩空间转换

在将OpenCV图像转为QImage前，强制将BGR转为RGB，同时匹配图像位深选择正确的QImage格式：

import cv2
import numpy as np
from PyQt6.QtGui import QImage, QPixmap
from PyQt6.QtCore import Qt

def cv2_to_qpixmap(cv_img):
    # 处理彩色图像
    if len(cv_img.shape) == 3:
        # BGR转RGB核心步骤
        cv_img = cv2.cvtColor(cv_img, cv2.COLOR_BGR2RGB)
        h, w, ch = cv_img.shape
        bytes_per_line = ch * w
        
        # 匹配8位/16位图像格式
        if cv_img.dtype == np.uint8:
            q_img = QImage(cv_img.data, w, h, bytes_per_line, QImage.Format.Format_RGB888)
        elif cv_img.dtype == np.uint16:
            q_img = QImage(cv_img.data, w, h, bytes_per_line, QImage.Format.Format_RGB16)
    # 处理灰度图像
    else:
        h, w = cv_img.shape
        bytes_per_line = w
        if cv_img.dtype == np.uint8:
            q_img = QImage(cv_img.data, w, h, bytes_per_line, QImage.Format.Format_Grayscale8)
        elif cv_img.dtype == np.uint16:
            q_img = QImage(cv_img.data, w, h, bytes_per_line, QImage.Format.Format_Grayscale16)
    
    return QPixmap.fromImage(q_img)

# 使用示例
cv_img = cv2.imread("your_image.tif", cv2.IMREAD_UNCHANGED)  # 保留原始位深加载
pixmap = cv2_to_qpixmap(cv_img)
# 显示到QLabel
label.setPixmap(pixmap.scaled(label.size(), Qt.AspectRatioMode.KeepAspectRatio))

2. 替代方案：用Pillow加载TIFF（更省心）

Pillow默认以RGB色彩空间加载图像，对TIFF的多格式支持更友好，无需手动转换色彩空间：

from PIL import Image
from PyQt6.QtGui import QImage, QPixmap
from PyQt6.QtCore import Qt

def pil_to_qpixmap(pil_img):
    # 处理带Alpha通道的图像
    if pil_img.mode == "RGBA":
        q_format = QImage.Format.Format_RGBA8888
        bytes_per_line = pil_img.width * 4
    else:
        q_format = QImage.Format.Format_RGB888
        bytes_per_line = pil_img.width * 3
    
    q_img = QImage(pil_img.tobytes(), pil_img.width, pil_img.height, bytes_per_line, q_format)
    return QPixmap.fromImage(q_img)

# 使用示例
pil_img = Image.open("your_image.tif")
pixmap = pil_to_qpixmap(pil_img)
label.setPixmap(pixmap.scaled(label.size(), Qt.AspectRatioMode.KeepAspectRatio))

关键注意事项 #

• 加载TIFF时用cv2.imread("xxx.tif", cv2.IMREAD_UNCHANGED)保留原始位深，避免默认8位转换导致的精度丢失
• 如果图像带有Alpha通道，需对应使用QImage.Format.Format_RGBA8888（8位）或Format_RGBA64（16位）格式
• 缩放QPixmap时使用KeepAspectRatio模式，避免拉伸变形影响颜色视觉判断

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