QPainter::drawLine绘制超大宽度图像时存在绘制不完整问题求助

问题描述 #

开发应用时，创建超大宽度图像遇到绘制不完整的问题，尝试drawLine、drawLines、fillRect等多种绘制方法后问题依旧。最小复现代码如下：

#include <QGuiApplication>
#include <QPainter>
#include <QPixmap>

static QPixmap imageTest(int width, int height, QColor const &color) {
  static constexpr auto VERTICAL_PADDING = 2;
  QPixmap pixmap(width, height);
  pixmap.fill(Qt::transparent);

  QPainter painter(&pixmap);
  painter.setRenderHint(QPainter::Antialiasing);

  QPen pen(color);
  double const widthF = 1.0;
  pen.setWidthF(widthF);
  painter.setPen(pen);
  for (int i = 0; i < width; ++i) {
    QPointF p1(i, 94.9445); // mini example assume fixed height
    QPointF p2(i, 167.055); // mini example consider fixed height
    painter.drawLine(p1, p2);
  }
  painter.end();
  return pixmap;
}

int main(int argc, char *argv[]) {
  QGuiApplication app(argc, argv);
  auto image = imageTest(211'459, 262, Qt::GlobalColor::green);
  image.save("testFile.png", "PNG");
  app.quit();
  return 0;
}

原因分析 #

• 平台绘图系统的尺寸限制：QPixmap依赖系统底层绘图API（如Windows GDI、X11 Pixmap），这类API普遍对单个绘图表面的尺寸有硬限制，比如部分系统会把单维度（宽度/高度）上限设为65535，超过这个值后，超出部分的绘制操作会被直接截断。
• 内存与资源分配限制：超大尺寸的QPixmap会占用大量内存，即使总内存没超系统上限，绘图后端也可能因单块内存分配失败、指令队列溢出等问题，导致后续绘制无法执行。
• 浮点数精度损耗：使用带小数的QPointF坐标，在宽度达到20万级别的场景下，浮点数的精度误差会被放大，导致部分坐标计算偏移，绘制指令失效。

解决建议 #

• 分块绘制拼接：将大图像拆分成多个符合平台尺寸限制的小块，分别绘制完成后再拼接成完整图像，比如按每60000宽度为一个分块。
• 替换为QImage：QImage是Qt独立实现的图像格式，不依赖平台绘图系统，对超大尺寸的支持更友好，内存管理更灵活，绘制完成后可直接保存或转为QPixmap使用。
• 改用整数坐标：如果不需要亚像素精度，换成QPoint整数坐标，避免浮点数精度损耗带来的绘制问题。
• 批量绘制优化：把所有线条坐标收集到QVector<QLineF>中，调用一次drawLines完成绘制，减少绘图指令的调用次数，降低资源消耗。

内容的提问来源于stack exchange，提问作者H.M