QGraphicsView缩放时背景网格渲染异常的原因及解决方法求助

问题描述 #

通过将背景画刷设置为包含单格网格（上边+左边线条）的QPixmap，为QGraphicsView绘制背景网格，正常状态下显示正常，但结合滚轮缩放功能缩小视图时，网格会出现部分缺失或不完整的情况，该问题在Linux和Windows系统上均会出现。

原因分析 #

使用固定像素的QPixmap作为重复背景画刷时，视图缩放会触发纹理采样的对齐问题：

• 当缩放因子非整数倍时，Qt对QPixmap纹理进行缩放采样，会丢失部分线条像素；
• 缩小视图时，多个原始网格单元格被合并到单个显示像素中，线条的像素权重被稀释，导致部分位置无法渲染出线条；
• 背景画刷的重复绘制逻辑基于像素坐标，而非视图的逻辑坐标，缩放后无法适配动态变化的视图坐标系。

解决方案 #

放弃使用QPixmap背景画刷，改为重写QGraphicsView的drawBackground方法，直接在视图的逻辑坐标系中动态绘制网格。这样可以根据当前缩放因子实时计算网格线条的位置，确保缩放时网格始终完整显示。

修改后的代码示例 #

import math

from PySide6.QtWidgets import QApplication, QGraphicsView, QGraphicsScene
from PySide6.QtGui import QPainter
from PySide6.QtCore import Qt, QRectF
    
class CanvasView(QGraphicsView):

    class CanvasScene(QGraphicsScene):
        def __init__(self, canvas_view, initial_width, initial_height):
            super().__init__(canvas_view)

    def __init__(self, initial_width, initial_height, grid_step):
        super().__init__()
        self.setGeometry(0, 0, initial_width, initial_height)
        self.canvas_scene = self.CanvasScene(self, initial_width, initial_height)
        self.setScene(self.canvas_scene)
        self.grid_step = grid_step  # 保存网格步长

    def wheelEvent(self, event):
        self.scaleView(math.pow(2.0, event.angleDelta().y() / 240.0))

    def scaleView(self, scaleFactor):
        factor = self.transform().scale(scaleFactor, scaleFactor).mapRect(QRectF(0, 0, 1, 1)).width()
        if factor < 0.07 or factor > 100:
            return
        self.scale(scaleFactor, scaleFactor)

    def drawBackground(self, painter: QPainter, rect: QRectF):
        super().drawBackground(painter, rect)
        painter.save()
        painter.setPen(Qt.lightGray)

        # 计算网格的起始和结束坐标，确保覆盖整个可见区域
        left = int(rect.left()) - (int(rect.left()) % self.grid_step)
        right = int(rect.right()) + self.grid_step
        top = int(rect.top()) - (int(rect.top()) % self.grid_step)
        bottom = int(rect.bottom()) + self.grid_step

        # 绘制垂直线
        x = left
        while x <= right:
            painter.drawLine(x, top, x, bottom)
            x += self.grid_step

        # 绘制水平线
        y = top
        while y <= bottom:
            painter.drawLine(left, y, right, y)
            y += self.grid_step

        painter.restore()

app = QApplication()
view = CanvasView(1000, 500, 20)
view.show()

app.exec()

代码说明 #

1. 移除原有的QPixmap和背景画刷设置，改为保存网格步长grid_step；
2. 重写drawBackground方法，在每次绘制背景时：
   • 获取当前视图的可见矩形rect；
   • 计算覆盖该矩形的网格起始/结束坐标，确保网格线条完整覆盖可见区域；
   • 使用QPainter直接绘制所有水平和垂直线条，线条位置基于视图的逻辑坐标系，不受缩放因子影响；
3. 绘制前保存、绘制后恢复画家状态，避免影响其他绘制逻辑。

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