PyQt6中如何设置PhotoViewer图片的初始缩放与居中显示

问题描述 #

使用Python 3.9搭配PyQt6开发时，基于提供的PhotoViewer类调用setPhoto方法加载图片，期望实现**固定初始缩放比例（如20%）**并让图片在显示区域（viewrect）内居中。直接使用self.scale方法无法达成居中效果，需解决该问题。

解决方案 #

核心问题在于原代码的fitInView会自动适配窗口缩放，且视图锚点设置为鼠标位置，导致手动缩放后无法自动居中。通过以下步骤实现需求：

1. 重置视图变换，确保初始状态无任何缩放偏移
2. 直接应用目标固定缩放比例
3. 调用centerOn方法将图片中心对齐到视图中心

修改后的完整代码 #

from PyQt6 import QtCore, QtWidgets, QtGui

class PhotoViewer(QtWidgets.QGraphicsView):
    photoClicked = QtCore.pyqtSignal(QtCore.QPointF)

    def __init__(self, parent):
        super(PhotoViewer, self).__init__(parent)
        self._zoom = 0
        self._empty = True
        self._scene = QtWidgets.QGraphicsScene(self)
        self._photo = QtWidgets.QGraphicsPixmapItem()
        self._scene.addItem(self._photo)
        self.setScene(self._scene)
        self.setTransformationAnchor(QtWidgets.QGraphicsView.ViewportAnchor.AnchorUnderMouse)
        self.setResizeAnchor(QtWidgets.QGraphicsView.ViewportAnchor.AnchorUnderMouse)
        self.setVerticalScrollBarPolicy(QtCore.Qt.ScrollBarPolicy.ScrollBarAlwaysOff)
        self.setHorizontalScrollBarPolicy(QtCore.Qt.ScrollBarPolicy.ScrollBarAlwaysOff)
        self.setBackgroundBrush(QtGui.QBrush(QtGui.QColor(30, 30, 30)))
        self.setFrameShape(QtWidgets.QFrame.Shape.NoFrame)

    def hasPhoto(self):
        return not self._empty

    def fitInView(self, scale=True):
        rect = QtCore.QRectF(self._photo.pixmap().rect())
        if not rect.isNull():
            self.setSceneRect(rect)
            if self.hasPhoto():
                unity = self.transform().mapRect(QtCore.QRectF(0, 0, 1, 1))
                self.scale(1 / unity.width(), 1 / unity.height())
                viewrect = self.viewport().rect()
                scenerect = self.transform().mapRect(rect)
                factor = min(viewrect.width() / scenerect.width(),
                             viewrect.height() / scenerect.height())
                
                print(viewrect.width(), scenerect.width(), viewrect.height(), scenerect.height())
                self.scale(factor, factor)
            self._zoom = 0

    def setPhoto(self, pixmap=None, initial_scale=0.2):
        self._zoom = 0
        
        if pixmap and not pixmap.isNull():
            self._empty = False
            self.setDragMode(QtWidgets.QGraphicsView.DragMode.ScrollHandDrag)
            self._photo.setPixmap(pixmap)
            # 重置视图变换，清除之前的缩放/偏移
            self.resetTransform()
            # 应用固定初始缩放比例
            self.scale(initial_scale, initial_scale)
            # 将图片居中显示
            self.centerOn(self._photo)
        else:
            self._empty = True
            self.setDragMode(QtWidgets.QGraphicsView.DragMode.NoDrag)
            self._photo.setPixmap(QtGui.QPixmap())
            self.resetTransform()

    def wheelEvent(self, event):
        if self.hasPhoto():
            if event.angleDelta().y() > 0:
                factor = 1.25
                self._zoom += 1
            else:
                factor = 0.8
                self._zoom -= 1
            if self._zoom > 0:
                self.scale(factor, factor)
            elif self._zoom == 0:
                self.fitInView()
            else:
                self._zoom = 0

    def toggleDragMode(self):
        if self.dragMode() == QtWidgets.QGraphicsView.DragMode.ScrollHandDrag:
            self.setDragMode(QtWidgets.QGraphicsView.DragMode.NoDrag)
        elif not self._photo.pixmap().isNull():
            self.setDragMode(QtWidgets.QGraphicsView.DragMode.ScrollHandDrag)

    def mousePressEvent(self, event):
        if self._photo.isUnderMouse():
            print(event.position())
            self.photoClicked.emit(self.mapToScene(event.position().toPoint()))

        super(PhotoViewer, self).mousePressEvent(event)

关键修改说明 #

• 给setPhoto方法新增initial_scale参数，默认值为0.2（对应20%缩放），可根据需求调整
• 加载有效图片时，先通过resetTransform()清除所有历史变换，确保缩放从图片原始尺寸开始计算
• 使用self.scale(initial_scale, initial_scale)直接应用固定缩放比例
• 调用self.centerOn(self._photo)将图片中心与视图中心对齐，完美实现居中效果
• 清空图片时也调用resetTransform()，保证视图状态重置为初始空状态

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