如何在PyQt6中提升加载GIF的显示质量？

问题原因 #

QMovie默认使用快速缩放算法（如最近邻插值），对于线条精细的GIF，缩小后容易出现锯齿、模糊，导致显示质量大幅下降。

解决方案1：手动处理每一帧，使用高质量插值 #

通过监听QMovie的帧变化信号，对每一帧图像单独进行平滑缩放，替代QMovie自带的低质量缩放：

from PyQt6.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QLabel
from PyQt6.QtGui import QMovie, QImage, Qt
from PyQt6.QtCore import QSize

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        layout = QVBoxLayout()
        self.loading_label = QLabel()
        self.loading_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
        
        self.gif = QMovie("Position.gif")
        self.gif.setFormat(b"gif")
        # 绑定帧变化信号，自定义缩放逻辑
        self.gif.frameChanged.connect(self.update_scaled_frame)
        self.gif.start()

        layout.addWidget(self.loading_label)

        widget = QWidget()
        widget.setLayout(layout)
        self.setCentralWidget(widget)

    def update_scaled_frame(self, _):
        frame = self.gif.currentImage()
        if not frame.isNull():
            # 使用平滑缩放算法，保持宽高比
            scaled_frame = frame.scaled(
                QSize(40, 40), 
                Qt.AspectRatioMode.KeepAspectRatio, 
                Qt.TransformationMode.SmoothTransformation
            )
            self.loading_label.setPixmap(scaled_frame)

app = QApplication([])
# 启用高DPI支持，适配高清屏幕
app.setAttribute(Qt.ApplicationAttribute.AA_UseHighDpiPixmaps)

window = MainWindow()
window.show()
app.exec()

解决方案2：优化QMovie与QLabel的渲染设置 #

如果不想自定义帧处理，可通过调整缓存模式和QLabel属性提升质量：

from PyQt6.QtWidgets import QApplication, QMainWindow, QWidget, QVBoxLayout, QLabel
from PyQt6.QtGui import QMovie, Qt
from PyQt6.QtCore import QSize

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        layout = QVBoxLayout()
        loading = QLabel()
        # 启用QLabel内容缩放，并居中对齐
        loading.setScaledContents(True)
        loading.setAlignment(Qt.AlignmentFlag.AlignCenter)
        
        gif = QMovie("Position.gif")
        gif.setFormat(b"gif")
        # 缓存所有帧，避免重复缩放损耗
        gif.setCacheMode(QMovie.CacheMode.CacheAll)
        gif.setScaledSize(QSize(40, 40))
        loading.setMovie(gif)
        gif.start()

        layout.addWidget(loading)

        widget = QWidget()
        widget.setLayout(layout)
        self.setCentralWidget(widget)

app = QApplication([])
app.setAttribute(Qt.ApplicationAttribute.AA_UseHighDpiPixmaps)

window = MainWindow()
window.show()
app.exec()

额外优化 Tips #

• 确保GIF为透明背景（若需要），避免缩放时背景色边缘出现锯齿
• 可尝试将GIF转成WebP动画格式，压缩率更高且画质损失小，PyQt6原生支持WebP加载
• 高DPI屏幕下，同时启用AA_EnableHighDpiScaling属性，进一步适配屏幕分辨率

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