Qt中使用QPixmap加载PDF时如何避免画质损失？

QPixmap直接加载PDF时，默认会以低分辨率（通常72DPI）将矢量PDF栅格化，这就是画质严重损失的原因；而在线转换器一般会用更高的分辨率生成PNG，所以加载后画质正常。以下是几种可行的解决办法：

• 用Poppler库高分辨率渲染PDF
  Qt原生对PDF的渲染能力有限，推荐用专门的PDF处理库Poppler来渲染页面到QPixmap，可自由设置分辨率。示例代码：

  #include <poppler-qt5.h>
  
  QPixmap renderPdfToPixmap(const QString &pdfPath, int pageNum, qreal dpi) {
      Poppler::Document *doc = Poppler::Document::load(pdfPath);
      if (!doc || doc->isLocked()) {
          delete doc;
          return QPixmap();
      }
      // 开启抗锯齿，提升渲染质量
      doc->setRenderHint(Poppler::Document::Antialiasing);
      doc->setRenderHint(Poppler::Document::TextAntialiasing);
  
      Poppler::Page *page = doc->page(pageNum);
      if (!page) {
          delete doc;
          return QPixmap();
      }
  
      // 根据设置的DPI计算渲染尺寸
      QSizeF pageSize = page->pageSizeF();
      int width = pageSize.width() * dpi / 72;
      int height = pageSize.height() * dpi / 72;
      QPixmap pixmap = page->renderToPixmap(dpi, dpi);
  
      delete page;
      delete doc;
      return pixmap;
  }
  

  调用时传入300或更高的DPI值，就能得到清晰的QPixmap。

• Qt 5.15+用原生API自定义分辨率渲染
  从Qt 5.15开始，官方提供了QPdfDocument和QPdfPageRenderer类，支持自定义分辨率渲染PDF，无需依赖第三方库。示例代码：

  #include <QPdfDocument>
  #include <QPdfPageRenderer>
  
  QPixmap renderPdfWithQt(const QString &pdfPath, int pageNum, qreal dpi) {
      QPdfDocument doc;
      if (!doc.load(pdfPath)) {
          return QPixmap();
      }
      QPdfPageRenderer renderer;
      renderer.setResolution(dpi);
      return renderer.renderPage(&doc, pageNum);
  }
  

• 本地预转PDF为高分辨率PNG
  如果不想修改代码或引入库，可使用本地工具（比如ImageMagick）批量将PDF转成高分辨率PNG，再用QPixmap加载。命令示例：

  convert -density 300 input.pdf output.png
  

  生成的PNG和在线转换器效果一致，加载后不会有画质损失。

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