Qt图像查看器缩放平移后无法恢复居中的修复方案求助

问题现象 #

• 放大后直接缩小，图像可正常回到初始居中位置；
• 放大后平移图像再缩小，图像无法恢复原始居中状态，黑色背景暴露。
• 问题核心：缩小逻辑中if (factor < 1.0)的偏移量计算错误。

异常演示 #

最小复现代码 #

#include <QApplication>
#include <QWidget>
#include <QPainter>
#include <QMouseEvent>
#include <QWheelEvent>

class ImageViewer : public QWidget
{
    Q_OBJECT
public:
    ImageViewer(QWidget *parent = nullptr) : QWidget(parent)
    {
        m_image.load("test.jpg"); // 替换为你的测试图片路径
        m_scale = 1.0;
        m_offset = QPointF(0, 0);
    }

protected:
    void paintEvent(QPaintEvent *event) override
    {
        QPainter painter(this);
        painter.fillRect(rect(), Qt::black);
        painter.translate(m_offset);
        painter.scale(m_scale, m_scale);
        painter.drawImage(QPoint(0, 0), m_image);
    }

    void wheelEvent(QWheelEvent *event) override
    {
        double factor = event->angleDelta().y() > 0 ? 1.2 : 0.8;
        QPointF mousePos = event->position();

        m_offset -= mousePos * (factor - 1);
        m_scale *= factor;

        // 存在问题的缩小逻辑
        if (factor < 1.0)
        {
            if (m_scale < 1.0)
            {
                m_scale = 1.0;
                // 未正确恢复居中偏移量
            }
        }

        update();
    }

    void mousePressEvent(QMouseEvent *event) override
    {
        if (event->button() == Qt::LeftButton)
        {
            m_lastMousePos = event->position();
        }
    }

    void mouseMoveEvent(QMouseEvent *event) override
    {
        if (event->buttons() & Qt::LeftButton)
        {
            QPointF delta = event->position() - m_lastMousePos;
            m_offset += delta;
            m_lastMousePos = event->position();
            update();
        }
    }

private:
    QImage m_image;
    double m_scale;
    QPointF m_offset;
    QPointF m_lastMousePos;
};

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);
    ImageViewer viewer;
    viewer.resize(800, 600);
    viewer.show();
    return a.exec();
}

#include "main.moc"

问题原因 #

当缩放比例重置为1.0时，代码仅修正了缩放值，但保留了平移后的偏移量，未根据窗口与图像尺寸重新计算居中所需的偏移，导致图像位置偏离窗口中心。

修复方案 #

修改if (factor < 1.0)代码块，在重置缩放比例时强制计算并设置居中偏移量：

if (factor < 1.0)
{
    if (m_scale < 1.0)
    {
        m_scale = 1.0;
        // 计算窗口与图像的中心偏移，确保图像居中
        QPointF imageCenter(m_image.width() / 2.0, m_image.height() / 2.0);
        QPointF windowCenter(width() / 2.0, height() / 2.0);
        m_offset = windowCenter - imageCenter * m_scale;
    }
}

修复逻辑说明 #

• 图像缩放后的中心位置 = 原始图像中心 × 缩放比例
• 窗口中心与图像中心的差值，即为让图像居中所需的平移偏移量
• 重置缩放时直接覆盖偏移量，确保图像回到窗口正中心

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