Qt 5.15.15中SVG导入QRC后文字模糊的解决方法咨询

问题背景 #

使用在线SVG编辑器创建了6个含"+X"/"+Y"/"+Z"/"-X"/"-Y"/"-Z"文本的SVG文件，在编辑器和浏览器中显示正常，但导入Qt 5.15.15项目的QRC资源系统后，文字出现平滑/模糊、细节丢失的情况，在查看QRC文件和最终程序中均存在该问题。

附"-Z"的SVG示例代码：

<?xml version="1.0"?>
<svg width="24.000000000000004" height="24.000000000000004" xmlns="http://www.w3.org/2000/svg" xmlns:svg="http://www.w3.org/2000/svg">
 <!-- Created with SVG-edit - https://github.com/SVG-Edit/svgedit-->
 <title>minus_z</title>
 <g class="layer">
  <title>Layer 1</title>
  <text fill="#000000" font-family="Serif" font-size="24" id="svg_2" stroke="#000000" stroke-dasharray="null" stroke-linecap="null" stroke-linejoin="null" stroke-opacity="null" stroke-width="0" style="cursor: move;" text-anchor="middle" transform="matrix(0.840809, 0, 0, 0.894209, 10.2146, 12.059)" x="2.16" xml:space="preserve" y="8.04">-Z</text>
 </g>
</svg>

解决方法 #

1. 将SVG中的文本转换为路径 #

Qt的SVG渲染器对文本的处理依赖系统字体，若系统中没有SVG指定的字体（或字体匹配存在差异），会导致渲染模糊。将文本转成矢量路径后，就不再依赖字体，能保持清晰：

• 回到SVG编辑器，选中文本元素，执行「转换为路径」类操作（不同编辑器选项名称可能略有差异）
• 重新导出SVG，替换原文件后再导入QRC

2. 调整Qt的SVG渲染参数 #

在使用QSvgRenderer渲染SVG时，可指定更高的目标尺寸，避免缩放导致的模糊：

QSvgRenderer renderer(":/icons/minus_z.svg");
QPixmap pixmap(96, 96); // 使用比原SVG更大的尺寸（比如4倍原尺寸）
pixmap.fill(Qt::transparent);
QPainter painter(&pixmap);
renderer.render(&painter);
// 之后按需将pixmap缩放到目标大小

3. 启用Qt高DPI支持 #

在项目的main.cpp中添加高DPI相关配置，确保渲染适配屏幕分辨率：

#include <QApplication>
#include <QGuiApplication>

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

4. 优化SVG本身属性 #

• 修正SVG的宽高为整数（当前是24.000000000000004，改为24），避免浮点尺寸导致的渲染对齐问题
• 移除不必要的变换矩阵，直接调整文本的位置和大小，减少渲染计算误差

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