Qt渲染大于32767px的QWidget时超出部分未渲染如何解决

Qt 中 QWidget 的渲染链路底层使用16位整数存储坐标与尺寸参数，单维度尺寸/坐标的有效阈值为32767像素。当尝试一次性渲染高度超过该阈值的QWidget到QPixmap时，超出阈值范围的内容会被直接裁剪，无法正常绘制，这就是32767px之后内容缺失的直接原因。

• 分块渲染拼接：不要一次性渲染整个超尺寸控件，将总高度拆分为多个单块高度小于32767的渲染单元，逐块渲染后拼接为完整图像。该方案兼容所有依赖QWidget paintEvent、子控件绘制的场景，不需要修改原有绘制逻辑。
  参考实现代码：

  #include <QApplication>
  #include <QPainter>
  #include <QPixmap>
  #include <QWidget>
  #include <QtMath>
  
  // 原有widget类无需修改
  class widget: public QWidget{
  protected:
      void paintEvent(QPaintEvent *event) override{
          QPainter painter(this);
          painter.setPen(QPen(Qt::black, 12, Qt::DashDotLine, Qt::RoundCap));
          painter.drawLine(QPoint(0,0),rect().bottomRight());
      }
  };
  
  int main(int argc, char *argv[])
  {
      QApplication a(argc, argv);
      const int totalW = 3000;
      const int totalH = 50000;
      const int blockH = 25000; // 单块高度小于32767即可
      widget wid;
      wid.resize(totalW, totalH);
  
      QPixmap finalPix(totalW, totalH);
      finalPix.fill(Qt::white);
      QPainter p(&finalPix);
  
      for(int y = 0; y < totalH; y += blockH){
          int curH = qMin(blockH, totalH - y);
          QPixmap blockPix(totalW, curH);
          blockPix.fill(Qt::white);
          // 逐块渲染控件对应区域
          wid.render(&blockPix, QPoint(0,0), QRegion(0, y, totalW, curH));
          p.drawPixmap(0, y, blockPix);
      }
  
      finalPix.save("PATH_TO_IMAGE");
      return 0;
  }
  

• 绕开QWidget直接绘制到QPixmap：如果场景不需要依赖QWidget的事件、子控件、样式等特性，可以直接在目标QPixmap上启动QPainter，复用原有paintEvent中的绘制逻辑即可。QPixmap配合QPainter的绘制操作没有32767的单维度尺寸限制，只要运行内存足够就能正常输出超大尺寸图像。
  参考实现代码：

  int main(int argc, char *argv[])
  {
      QApplication a(argc, argv);
      QPixmap pixmap(3000,50000);
      pixmap.fill(Qt::white);
      QPainter painter(&pixmap);
      painter.setPen(QPen(Qt::black, 12, Qt::DashDotLine, Qt::RoundCap));
      painter.drawLine(QPoint(0,0),pixmap.rect().bottomRight());
      pixmap.save("PATH_TO_IMAGE");
      return 0;
  }
  

注意：不要将QWidget本身的几何尺寸设置到超过32767像素，该操作属于Qt的未定义行为，分块渲染时仅需保证单次传入render()的渲染区域尺寸在阈值范围内即可，不需要将控件显示到前台界面。

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