Windows 11缩放超100%时QPixmap显示模糊的技术求助

问题根源 #

你遇到的模糊问题本质是预先缩放位图的错误操作：把原图缩到16x16后，Windows 11的125%缩放会让Qt把这张小图再次拉伸放大，位图拉伸必然导致画质损失；而文字清晰是因为Qt会针对当前DPI缩放因子渲染矢量文本，不会失真。

正确处理方案 #

核心思路是保留原始尺寸的QPixmap，按需动态缩放，让Qt根据当前设备的DPI缩放因子生成对应分辨率的图像，具体步骤如下：

1. 确保开启Qt高DPI适配（Qt 6默认已开启，但可明确配置）
   在main函数中添加以下配置，确保Qt正确识别系统缩放因子：

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    // 启用高DPI缩放
    app.setAttribute(Qt::AA_EnableHighDpiScaling);
    // 启用高DPI pixmap支持
    app.setAttribute(Qt::AA_UseHighDpiPixmaps);
    // ... 后续代码
    return app.exec();
}

2. 加载原图时保留原始尺寸，设置正确的设备像素比
   从qrc加载图片时，不要预先缩放，而是直接设置pixmap的devicePixelRatio与当前屏幕一致：

QPixmap originalPixmap(":/path/to/your/icon.png");
// 绑定当前屏幕的DPI缩放比
originalPixmap.setDevicePixelRatio(qApp->primaryScreen()->devicePixelRatio());

3. 在DecorationRole或绘制时动态缩放

• 若在模型的data()方法中返回DecorationRole：

QVariant MyModel::data(const QModelIndex &index, int role) const {
    if (role == Qt::DecorationRole) {
        QPixmap originalPixmap(":/path/to/your/icon.png");
        originalPixmap.setDevicePixelRatio(qApp->primaryScreen()->devicePixelRatio());
        
        // 计算目标尺寸：基础尺寸16 * 设备像素比
        int scaledSize = 16 * originalPixmap.devicePixelRatio();
        // 使用平滑缩放保证画质
        return originalPixmap.scaled(scaledSize, scaledSize, Qt::KeepAspectRatio, Qt::SmoothTransformation);
    }
    // ... 其他role处理
    return QVariant();
}

• 若用自定义Delegate绘制：

void MyDelegate::paint(QPainter *painter, const QStyleOptionViewItem &option, const QModelIndex &index) const {
    QStyledItemDelegate::paint(painter, option, index);
    
    QPixmap originalPixmap(":/path/to/your/icon.png");
    // 绑定当前绘制设备的DPI缩放比
    originalPixmap.setDevicePixelRatio(painter->device()->devicePixelRatio());
    
    QSize targetSize(16, 16);
    targetSize *= originalPixmap.devicePixelRatio();
    QPixmap scaledPixmap = originalPixmap.scaled(targetSize, Qt::KeepAspectRatio, Qt::SmoothTransformation);
    
    painter->drawPixmap(option.rect, scaledPixmap);
}

关键注意点 #

• 不要预先缩放位图到固定像素尺寸，始终基于原图动态计算缩放后的尺寸
• 必须使用Qt::SmoothTransformation缩放模式，避免生硬拉伸导致的锯齿
• Qt 6的高DPI适配比Qt 5更完善，无需自行编译即可正确识别Windows 11的系统缩放因子

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