PySide6 QLabel动态缩放QMovie教程

引言：QMovie与QLabel的尺寸缩放挑战

在PySide6应用程序中，QLabel控件常用于显示图像或动画。当显示静态图像（QPixmap）时，我们可以利用QPixmap.scaled()方法并结合Qt.KeepAspectRatio参数轻松实现按比例缩放。然而，当QLabel用于播放动态图像（QMovie，例如GIF文件）时，情况变得复杂。QMovie对象本身并不提供像QPixmap那样直接的scaled()方法。虽然它有setScaledSize(size)方法，但QMovie.scaledSize()在加载GIF文件时常常返回无效的QSize(-1, -1)，这使得我们无法直接获取其原始尺寸进行比例计算。此外，单独调用setScaledSize()可能导致QLabel在缩放时只增大不缩小，无法实现灵活的动态调整。

为了解决这一挑战，我们需要一种更精细的方法来获取QMovie的真实尺寸，并精确控制QLabel在自身尺寸变化时如何按比例渲染QMovie内容。

核心解决方案：自定义ScaledLabel类

解决QLabel显示QMovie时保持宽高比的关键在于创建一个自定义的QLabel子类，该类能够：

1. 准确获取QMovie的原始尺寸：由于QMovie.scaledSize()不可靠，我们需要通过遍历电影的所有帧来计算其真实内容的边界框。
2. 提供正确的最小尺寸提示：确保布局管理器能够根据电影的宽高比分配合适的最小空间。
3. 重写绘画事件：在QLabel的paintEvent中，根据当前的可用空间和电影的原始宽高比，动态地调整QMovie的显示尺寸，并确保绘制出的内容始终保持正确的比例。

下面我们将详细介绍这个名为ScaledLabel的自定义类及其实现细节。

ScaledLabel 类详解

ScaledLabel类继承自PySide6.QtWidgets.QLabel，并重写了几个关键方法以实现所需功能。

1. 类定义与初始化

from PySide6.QtWidgets import QLabel
from PySide6.QtCore import Qt, QSize, QRect
from PySide6.QtGui import QMovie, QPainter, QPixmap

class ScaledLabel(QLabel):
    def __init__(self, *args, **kwargs):
        super().__init__(*args, **kwargs)
        self._movieSize = QSize()  # 存储QMovie的原始尺寸
        self._minSize = QSize()    # 存储QLabel的最小尺寸提示

在构造函数中，我们初始化了两个私有成员变量：_movieSize用于存储通过分析QMovie帧获得的原始尺寸，_minSize用于在布局计算时提供一个保持宽高比的最小尺寸提示。

2. setMovie 方法：获取原始尺寸与设置最小尺寸

这是最关键的方法之一，它负责在设置新的QMovie时计算其原始尺寸并设置相应的最小尺寸提示。

    def setMovie(self, movie):
        if self.movie() == movie:
            return
        super().setMovie(movie)

        if not isinstance(movie, QMovie) or not movie.isValid():
            self._movieSize = QSize()
            self._minSize = QSize()
            self.updateGeometry()
            return

        # 存储当前帧号和播放状态，以便计算后恢复
        current_frame_number = movie.currentFrameNumber()
        movie_state = movie.state()

        # 跳转到第一帧开始计算
        movie.jumpToFrame(0)
        bounding_rect = QRect()

        # 遍历所有帧，计算所有帧的最小边界框的并集
        for i in range(movie.frameCount()):
            movie.jumpToNextFrame()
            bounding_rect |= movie.frameRect() # 使用按位或运算符来合并矩形

        # 根据合并后的边界框计算电影的原始总宽度和高度
        width = bounding_rect.x() + bounding_rect.width()
        height = bounding_rect.y() + bounding_rect.height()

        self._movieSize = QSize(width, height)

        # 根据原始尺寸计算一个合适的最小尺寸提示，以保持宽高比
        if width == 0 or height == 0: # 避免除零错误
            self._minSize = QSize(4, 4) # 默认一个小的正方形
        else:
            minimum_dim = min(width, height)
            maximum_dim = max(width, height)
            aspect_ratio = maximum_dim / minimum_dim

            # 以较小维度为基准（例如4像素），计算最小尺寸
            base_size = min(4, minimum_dim)
            self._minSize = QSize(base_size, round(base_size * aspect_ratio))

            # 如果原始宽度是较小维度，则转置最小尺寸以匹配
            if minimum_dim == width:
                self._minSize.transpose()

        # 恢复电影的原始状态
        movie.jumpToFrame(current_frame_number)
        if movie_state == movie.MovieState.Running:
            movie.setPaused(False)
        self.updateGeometry() # 通知布局系统尺寸提示已更新

setMovie方法解析：

• 原始尺寸获取：QMovie.scaledSize()不可靠，因此我们通过迭代QMovie的每一帧来获取其frameRect()。QRect的|=运算符（联合操作）可以计算所有帧边界框的并集，从而得到整个电影内容的真实原始尺寸。
• 最小尺寸计算：一旦获得_movieSize，我们就根据其宽高比计算一个非常小的、保持比例的_minSize。这确保了即使QLabel被缩小到很小，也能保持正确的宽高比，并且布局管理器能够得到一个有意义的最小尺寸提示。
• 状态恢复：在遍历帧的过程中，QMovie的当前帧和播放状态会被改变。因此，在计算完成后，我们将其恢复到原始状态，以避免对播放造成干扰。
• updateGeometry()：调用此方法通知布局系统QLabel的尺寸提示可能已更改，促使布局重新计算。

3. minimumSizeHint 方法：向布局管理器提供最小尺寸

    def minimumSizeHint(self):
        if self._minSize.isValid():
            return self._minSize
        return super().minimumSizeHint()

此方法被布局管理器调用，以获取控件的建议最小尺寸。我们返回在setMovie中计算出的_minSize，确保QLabel在布局时能够按比例缩小，但不会小于其最小尺寸。

4. paintEvent 方法：动态绘制与缩放

paintEvent是实现动态缩放的核心。每当QLabel需要重绘时，此方法都会被调用。

    def paintEvent(self, event):
        movie = self.movie()
        if not isinstance(movie, QMovie) or not movie.isValid():
            super().paintEvent(event)
            return

        qp = QPainter(self)
        self.drawFrame(qp) # 绘制QLabel的边框等

        content_rect = self.contentsRect() # 获取QLabel内部可用于绘制内容的区域
        margin = self.margin()
        content_rect.adjust(margin, margin, -margin, -margin) # 考虑边距

        style = self.style()
        alignment = style.visualAlignment(self.layoutDirection(), self.alignment())

        # 根据当前可用区域和电影原始尺寸，计算一个期望的缩放尺寸
        maybe_scaled_size = self._movieSize.scaled(content_rect.size(), Qt.KeepAspectRatio)

        # 优化：如果期望尺寸与QMovie当前报告的缩放尺寸不同
        if maybe_scaled_size != movie.scaledSize():
            movie.setScaledSize(maybe_scaled_size) # 告诉QMovie按此尺寸生成帧
            # 同时，显式地缩放当前帧的QPixmap进行绘制，确保立即的视觉准确性
            style.drawItemPixmap(
                qp, content_rect, alignment, 
                movie.currentPixmap().scaled(content_rect.size(), Qt.KeepAspectRatio)
            )
        else:
            # 如果QMovie已经按期望尺寸生成帧，则直接绘制当前帧的QPixmap，更高效
            style.drawItemPixmap(
                qp, content_rect, alignment, 
                movie.currentPixmap()
            )

**`paintEvent