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。未经个人允许不得转载。如需帮助请email至[email protected]。
参考资料
[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