关于PyQt5中QtGui.QImage图片显示问题解析

前言

PyQt是Python语言环境的GUI编程解决方案之一，另外还有PyGTK、wxPython等也较为常用。PyQt作为Qt语言的Python扩展，可以用来方便快速的开发界面应用。

PyQt5中的QtGui.QImage图片显示

import os.path as osp
import cv2
from qtpy import QtCore
from qtpy import QtWidgets
from qtpy import QtGui

# TracelessLe注：代码示例，不可直接执行

class MainWindow(QtWidgets.QMainWindow):
def __init__(self):
self.image = QtWidgets.QLabel()

def show_img(self, img_path):
       self.image.clear()
       img_np = cv2.imread(img_path)
       width = img_np.shape[1]
       height = img_np.shape[0]
       img_rgb_data = cv2.cvtColor(img_np, cv2.COLOR_BGR2RGB)
       # label_data = QtGui.QImage(img_rgb_data.data, width, height, QtGui.QImage.Format_RGB888)  # 这种方式可能会有部分图片显示有问题
       label_data = QtGui.QImage(img_rgb_data.data, width, height, width*3, QtGui.QImage.Format_RGB888)  # 针对RGB图显示的正确方式
       self.image.setPixmap(QtGui.QPixmap.fromImage(label_data))

图片显示问题分析

如上述代码中讲到的那样，针对RGB三通道图片显示的正确方法是使用：

label_data = QtGui.QImage(img_rgb_data.data, width, height, width*3, QtGui.QImage.Format_RGB888)

进入QtGui.QImage类，可以看到其支持的图片数据格式有很多：

从QT官网也能找到支持的图像格式：

而图片初始化方法也有很多：

从使用方式来看，主要分为三大类：
（1）传入图像尺寸或长宽，以及图像格式（QImage.Format）
（2）传入图像数据，图像尺寸或长宽，以及图像格式
（3）传入图像路径，图像格式

通常对于已经使用OpenCV读取和处理过的图片，我们会使用方式（2）来初始化。

对于常用的RGB三通道图像，初始化时的图像格式一般设为QtGui.QImage.Format_RGB888。

而在使用时，正确的使用方式是：

def __init__(self, data: bytes, width: int, height: int, bytesPerLine: int, format: 'QImage.Format')

如果使用

def __init__(self, data: bytes, width: int, height: int, format: 'QImage.Format')

方法初始化，可能会遇到显示上的一些问题。例如图片斜偏显示、图片黑白条间隔显示、图片加载直接崩溃等异常。

对比两种方法，发现问题在于bytesPerLine: int参数上。该参数指定了bytes型输入数据data在数据排布上的间隔（bytesPerLine）。如果未指定，对于某些输入数据，QtGui.QImage无法正常推断出数据排列格式，则会出现上述中的显示异常问题。

版权说明

本文为原创文章，独家发布在blog.csdn.net/TracelessLe。未经个人允许不得转载。

参考资料

[1] QImage Class | Qt GUI 5.15.8
[2] What is PyQt?
[3] PYQT QTGUI.QIMAGE显示图片异常，发生斜偏异常，且黑白显色_lockhou的博客-CSDN博客
[4] QImage.Format
[5] QImage
[6] QImage与cv::Mat转换； - 时光旅者 - 博客园
[7] 基于PyQt Canvas Matplotlib图形绘制_battlestar的博客-CSDN博客_figurecanvas

来源：https://blog.csdn.net/TracelessLe/article/details/123339133