PyQt4中QLabel首次渲染图片失真，二次显示正常的解决问询

我之前也踩过这个坑！这种首次渲染失真、二次打开就正常的情况，核心原因几乎都是首次调用图片缩放时，QLabel的实际显示尺寸还没完全确定——窗口刚初始化阶段，布局系统还没完成尺寸计算，self.wCam0.ui.lblImage.size()返回的只是QLabel的默认最小尺寸，不是它最终要展示的大小。这时候基于错误尺寸缩放出来的Pixmap，等窗口布局完成后被强行拉伸，就会出现失真；而第二次打开窗口时，系统已经缓存了窗口的布局尺寸，缩放就会基于正确的大小执行，所以显示正常。

下面给你几个靠谱的解决方案，按推荐程度排序：

1. 监听QLabel的resize事件，动态重缩放图片（最稳妥） #

这个方案不仅能解决首次失真的问题，还能适配窗口大小变化的场景，让图片始终保持清晰。你可以子类化QLabel，重写它的resizeEvent：

from PyQt4 import QtGui, QtCore

class AutoScaledLabel(QtGui.QLabel):
    def __init__(self, parent=None):
        super(AutoScaledLabel, self).__init__(parent)
        self._original_pixmap = None

    def setOriginalPixmap(self, pixmap):
        # 保存原图，每次尺寸变化都基于原图重缩放
        self._original_pixmap = pixmap
        self._update_scaled_pixmap()

    def resizeEvent(self, event):
        super(AutoScaledLabel, self).resizeEvent(event)
        self._update_scaled_pixmap()

    def _update_scaled_pixmap(self):
        if self._original_pixmap is not None:
            # 用平滑缩放算法，保证画质
            scaled_pixmap = self._original_pixmap.scaled(
                self.size(), 
                QtCore.Qt.KeepAspectRatio, 
                QtCore.Qt.SmoothTransformation
            )
            self.setPixmap(scaled_pixmap)

使用的时候，把原来的QLabel替换成这个自定义类：

# 假设你的界面是用Qt Designer做的，替换原有lblImage
self.wCam0.ui.lblImage = AutoScaledLabel(self.wCam0.ui)
# 设置原图，剩下的缩放交给自定义Label处理
original_pixmap = QtGui.QPixmap(_fromUtf8(image))
self.wCam0.ui.lblImage.setOriginalPixmap(original_pixmap)

2. 延迟加载图片，等布局完成后再渲染 #

如果不想自定义控件，可以用QTimer.singleShot延迟几十毫秒加载图片，给布局系统足够的时间计算QLabel的实际尺寸：

from PyQt4 import QtCore

# 不要在__init__里直接加载，改用延迟调用
QtCore.QTimer.singleShot(100, self._load_and_display_image)

def _load_and_display_image(self):
    pixmap = QtGui.QPixmap(_fromUtf8(image))
    scaled_pixmap = pixmap.scaled(
        self.wCam0.ui.lblImage.size(), 
        QtCore.Qt.KeepAspectRatio, 
        QtCore.Qt.SmoothTransformation
    )
    self.wCam0.ui.lblImage.setPixmap(scaled_pixmap)

这里的100ms是经验值，大部分场景下足够布局完成，如果还是有问题可以适当调整时长。

3. 强制触发布局计算后再缩放 #

在加载图片前，手动触发布局系统计算尺寸，确保size()返回的是正确值：

# 激活父控件的布局，强制计算尺寸
self.wCam0.ui.lblImage.parentWidget().layout().activate()
# 或者让QLabel自适应内容（如果适用）
# self.wCam0.ui.lblImage.adjustSize()

# 现在再缩放图片
pixmap = QtGui.QPixmap(_fromUtf8(image))
scaled_pixmap = pixmap.scaled(
    self.wCam0.ui.lblImage.size(), 
    QtCore.Qt.KeepAspectRatio, 
    QtCore.Qt.SmoothTransformation
)
self.wCam0.ui.lblImage.setPixmap(scaled_pixmap)

关键提醒： #

不管用哪个方案，都一定要加上QtCore.Qt.SmoothTransformation参数！PyQt默认的缩放算法是FastTransformation，速度快但画质差，首次缩放时很容易出现模糊、失真的情况，平滑缩放算法虽然稍慢一点，但能极大提升图片清晰度。

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