void WhiteBoard::setBackgroundImage(const QPixmap &pixmap) { if (pixmap.isNull()) return; qreal ratio = devicePixelRatio(); QSize targetSize = size() * ratio; // 保持原图比例，但不超出画板范围 m_backgroundImage = pixmap.scaled( ...-Go服务器开发

在 WhiteBoard 类中设置背景图片模糊的问题，通常与 DPI缩放处理、图像缩放策略 或 绘制方式 有关。以下是详细解决方案：

1. 检查高DPI支持（关键步骤）

确保正确启用了Qt的高DPI缩放（在 main.cpp 中初始化）：

// main.cpp
#include <QApplication>

int main(int argc, char *argv[]) {
    // !!! 必须放在QApplication构造之前 !!!
    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    QCoreApplication::setAttribute(Qt::AA_UseHighDpiPixmaps); // 启用高分辨率位图
    
    QApplication a(argc, argv);
    WhiteBoard w;
    w.show();
    return a.exec();
}

2. 修正图像缩放逻辑

当前代码的潜在问题：

devicePixelRatio() 可能被多次放大导致计算错误
scaled() 的目标尺寸需要更精确控制

修改后的函数：

void WhiteBoard::setBackgroundImage(const QPixmap &pixmap) {
    if (pixmap.isNull()) return;

    // 获取实际需要的物理像素尺寸（考虑HiDPI）
    qreal dpr = devicePixelRatioF(); // 使用devicePixelRatioF()避免精度损失
    QSize targetSize = size() * dpr;

    // 保持原图比例且不超出目标区域
    m_backgroundImage = pixmap.scaled(
        targetSize,
        Qt::KeepAspectRatioByExpanding, // 保证填满区域（可选KeepAspectRatio）
        Qt::SmoothTransformation       // 高质量插值
    );

    // 关键：设置正确的设备像素比
    m_backgroundImage.setDevicePixelRatio(dpr);
    
    m_hasBackground = true;
    update();
}

3. 优化绘制方法

在 paintEvent 中确保正确绘制：

void WhiteBoard::paintEvent(QPaintEvent *event) {
    QPainter painter(this);
    
    if (m_hasBackground) {
        // !!! 使用drawPixmap而不是drawImage !!!
        painter.drawPixmap(rect(), m_backgroundImage, m_backgroundImage.rect());
        
        /* 
         *  或者指定目标区域和源区域：
         * painter.drawPixmap(targetRect, m_backgroundImage, sourceRect);
         */
     }
     
     // ...其他绘制逻辑...
}

4. DPI调试技巧

添加调试输出检查实际参数：

qDebug() << "DPR:" << devicePixelRatioF() 
         << "Target Size:" << targetSize 
         << "Original Image Size:" << pixmap.size()
         << "Scaled Image Size:" << m_backgroundImage.size();

常见问题排查表

现象	可能原因	解决方案
Windows下模糊	HiDPI未启用	确认`AA_EnableHighDpiScaling`已设置
MacOS下边缘锯齿	Pixmap像素比错误	`setDevicePixelRatio(dpr)`必须匹配屏幕
Linux缩放异常	X11/Wayland兼容性问题	QT_QPA_PLATFORM=xcb环境变量