如何在QGraphicsView中启用平移缩放且切换图像不重置缩放？

修改思路 #

问题根源是每次接收新图像时调用fitInView，强制将视图重置为适配图像的初始状态，导致之前的缩放、平移设置丢失。解决方案核心是：

• 实现自定义的缩放、平移交互逻辑
• 更新图像前保存当前视图的变换状态
• 更新图像后恢复原视图状态，仅首次加载图像时使用fitInView适配

修改后的完整代码 #

from PyQt5.QtWidgets import QGraphicsView, QGraphicsScene, QWidget, QGraphicsPixmapItem
from PyQt5.QtGui import QImage, QPainter, QPixmap, QTransform
from PyQt5.QtCore import QRectF, pyqtSlot, Qt, QPointF

class Display(QGraphicsView):
    def __init__(self, parent: QWidget = None):
        super().__init__(parent)
        self._empty = True
        self.image_qt = QImage()
        self._scene = QGraphicsScene()
        self.pic = QGraphicsPixmapItem()
        self._scene.addItem(self.pic)
        self.setScene(self._scene)
        self.setAlignment(Qt.AlignCenter)
        
        # 缩放平移控制变量
        self._zoom = 1.0
        self._last_pan_pos = QPointF()
        self._is_panning = False
        
        # 优化图像显示效果
        self.setRenderHint(QPainter.Antialiasing)
        self.setRenderHint(QPainter.SmoothPixmapTransform)
        
        # 禁用默认拖拽，使用自定义平移逻辑
        self.setDragMode(QGraphicsView.NoDrag)

    def hasPicture(self):
        return not self._empty

    def wheelEvent(self, event):
        # 滚轮缩放：以鼠标位置为中心，缩放系数1.15
        zoom_factor = 1.15 if event.angleDelta().y() > 0 else 1/1.15
        self._zoom *= zoom_factor
        # 限制缩放范围（可根据需求调整）
        self._zoom = max(0.1, min(self._zoom, 10.0))
        
        # 计算以鼠标为中心的缩放变换
        scene_mouse_pos = self.mapToScene(event.pos())
        transform = QTransform()
        transform.translate(scene_mouse_pos.x(), scene_mouse_pos.y())
        transform.scale(zoom_factor, zoom_factor)
        transform.translate(-scene_mouse_pos.x(), -scene_mouse_pos.y())
        self.setTransform(self.transform() * transform)

    def mousePressEvent(self, event):
        # 右键按住启动平移
        if event.button() == Qt.RightButton:
            self._last_pan_pos = self.mapToScene(event.pos())
            self._is_panning = True
            self.setCursor(Qt.ClosedHandCursor)
        super().mousePressEvent(event)

    def mouseMoveEvent(self, event):
        if self._is_panning:
            current_pos = self.mapToScene(event.pos())
            delta = current_pos - self._last_pan_pos
            self.translate(delta.x(), delta.y())
            self._last_pan_pos = current_pos
        super().mouseMoveEvent(event)

    def mouseReleaseEvent(self, event):
        if event.button() == Qt.RightButton:
            self._is_panning = False
            self.setCursor(Qt.ArrowCursor)
        super().mouseReleaseEvent(event)

    @pyqtSlot(QImage)
    def on_image_received(self, image: QImage, scale: float, x_offset: int, y_offset: int):
        self.image_qt = image
        image_width = self.image_qt.width()
        image_height = self.image_qt.height()

        if image_width == 0 or image_height == 0:
            return

        # 更新图像前保存当前视图变换
        current_transform = self.transform()
        
        self._empty = False
        self.pic.setPixmap(QPixmap.fromImage(self.image_qt))
        
        if self._empty:
            # 首次加载图像时自动适配视图
            self.fitInView(QRectF(0, 0, image_width, image_height), Qt.KeepAspectRatio)
            self._zoom = self.transform().m11()
        else:
            # 恢复之前的缩放平移状态
            self.setTransform(current_transform)
        
        self.update()

关键修改说明 #

• 自定义交互逻辑：实现右键拖拽平移、滚轮中心缩放，符合常规图像查看操作习惯
• 状态保存恢复：更新图像前记录当前视图的变换矩阵，更新后恢复，避免状态丢失
• 首次加载适配：仅在第一次显示图像时调用fitInView，后续更新不再重置视图
• 显示优化：启用抗锯齿和平滑像素变换，提升动态图像的显示质感

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