Qt图形系统架构与性能优化实践

1. Qt图形系统架构概述

Qt图形系统采用经典的MVC（Model-View-Controller）设计模式演变而来的Scene-Item-View架构。这个架构由三个核心组件构成：QGraphicsScene（场景）、QGraphicsItem（图元）和QGraphicsView（视图）。三者的关系可以类比为舞台剧的表演体系——场景是舞台，图元是演员，而视图则是观众观看表演的窗口。

在实际开发中，典型的图形应用创建流程如下：

cpp复制QGraphicsScene *scene = new QGraphicsScene();  // 创建舞台
MyItem *item = new MyItem();  // 创建演员
scene->addItem(item);  // 将演员添加到舞台

QGraphicsView *view = new QGraphicsView(scene);  // 创建观众视角
view->show();  // 开始表演

这种架构设计带来了几个关键优势：

• 职责分离：场景管理图元集合和碰撞检测，图元处理自身绘制和交互，视图负责可视化呈现
• 性能优化：视图只重绘可见区域的图元，支持OpenGL加速渲染
• 坐标系统：内置三级坐标转换（场景坐标、图元局部坐标、视图视口坐标）
• 事件传递：完善的事件传播机制从视图到场景再到图元

提示：在Qt 5.12及以后版本中，建议使用QGraphicsScene::render()替代直接操作QPainter，可以获得更好的渲染性能。

2. QGraphicsScene深度解析

2.1 场景的核心功能

QGraphicsScene作为容器管理着所有图元对象，其核心功能包括：

• 图元管理：通过addItem()/removeItem()管理图元生命周期
• 空间索引：使用BSP树（Binary Space Partitioning）加速图元查找
• 碰撞检测：提供collidingItems()等系列方法
• 背景处理：支持设置背景画刷或背景图片
• 事件传播：作为图元事件的中转站

场景的坐标系默认以中心为原点(0,0)，向右为X正方向，向下为Y正方向。可以通过setSceneRect()设置工作区域：

cpp复制scene->setSceneRect(-400, -300, 800, 600);  // 设置800x600的场景区域

2.2 场景渲染优化技巧

对于包含大量图元的场景，性能优化至关重要：

1. BSP树配置：

cpp复制scene->setItemIndexMethod(QGraphicsScene::BspTreeIndex);  // 默认配置
scene->setBspTreeDepth(10);  // 调整BSP树深度

BSP树深度建议取值在6-20之间，过深会增加构建时间，过浅会降低查询效率。

2. 批量操作模式：

cpp复制scene->setStickyFocus(true);  // 防止焦点丢失
scene->blockSignals(true);    // 阻塞信号
// 执行大批量图元操作
scene->blockSignals(false);   // 恢复信号

3. 渲染提示设置：

cpp复制view->setRenderHint(QPainter::Antialiasing);  // 抗锯齿
view->setRenderHint(QPainter::SmoothPixmapTransform);  // 平滑缩放
view->setOptimizationFlags(QGraphicsView::DontSavePainterState);

3. QGraphicsItem图元系统

3.1 图元类型与自定义

Qt提供多种内置图元类型：

• 基础形状：QGraphicsEllipseItem、QGraphicsRectItem等
• 文本图元：QGraphicsTextItem
• 路径图元：QGraphicsPathItem
• 控件图元：QGraphicsProxyWidget

自定义图元需要继承QGraphicsItem并实现三个纯虚函数：

cpp复制class CustomItem : public QGraphicsItem {
public:
    QRectF boundingRect() const override { /*...*/ }
    void paint(QPainter *painter, const QStyleOptionGraphicsItem *option, 
               QWidget *widget) override { /*...*/ }
    QPainterPath shape() const override { /*...*/ }
};

3.2 图元性能关键点

1. boundingRect精确性：

cpp复制QRectF MyItem::boundingRect() const {
    return QRectF(-10, -10, 20, 20);  // 必须包含所有绘制内容
}

返回过大的矩形会导致不必要的重绘，过小则会出现绘制残影。

2. shape()碰撞形状：

cpp复制QPainterPath MyItem::shape() const {
    QPainterPath path;
    path.addEllipse(boundingRect());  // 默认与boundingRect一致
    return path;
}

对于复杂形状，建议使用QPainterPath的简化操作：

cpp复制path = path.simplified();  // 简化路径提高碰撞检测效率

3. 绘制优化技巧：

cpp复制void MyItem::paint(QPainter *painter, ...) {
    painter->setRenderHint(QPainter::Antialiasing);  // 按需开启
    if(option->levelOfDetail < 0.5) {  // 根据缩放级别优化绘制
        drawSimplifiedVersion(painter);
    } else {
        drawFullVersion(painter);
    }
}

4. QGraphicsView高级特性

4.1 视图变换与交互

视图提供强大的坐标变换能力：

cpp复制view->setTransform(QTransform().rotate(45).scale(2, 1));  // 旋转45度并水平拉伸

常用交互模式配置：

cpp复制view->setDragMode(QGraphicsView::ScrollHandDrag);  // 手掌拖动
view->setDragMode(QGraphicsView::RubberBandDrag);  // 框选模式
view->setInteractive(true);  // 启用默认交互

4.2 多视图协同工作

多个视图可以共享同一个场景：

cpp复制QGraphicsView *view1 = new QGraphicsView(scene);
QGraphicsView *view2 = new QGraphicsView(scene);
// 同步视图滚动
connect(view1->horizontalScrollBar(), &QScrollBar::valueChanged,
        view2->horizontalScrollBar(), &QScrollBar::setValue);

4.3 视图性能调优

1. 缓存模式选择：

cpp复制view->setCacheMode(QGraphicsView::CacheBackground);  // 缓存背景
view->setCacheMode(QGraphicsView::CacheNone);        // 无缓存（默认）

2. 视口更新策略：

cpp复制view->setViewportUpdateMode(QGraphicsView::FullViewportUpdate);  // 全视口更新
view->setViewportUpdateMode(QGraphicsView::MinimalViewportUpdate); // 最小更新

3. OpenGL加速：

cpp复制QOpenGLWidget *glWidget = new QOpenGLWidget();
view->setViewport(glWidget);  // 使用OpenGL视口

5. 实战：流程图编辑器开发

5.1 自定义连接线图元

实现可拖拽的连接线需要处理多个状态：

cpp复制class ConnectionItem : public QGraphicsPathItem {
    enum { Normal, Hovered, Selected } m_state;
    
    void updatePath() {
        QPainterPath path;
        path.moveTo(startPos);
        path.cubicTo(controlPoint1, controlPoint2, endPos);
        setPath(path);
    }
};

5.2 图元对齐与吸附

实现网格吸附功能：

cpp复制void DiagramScene::mouseMoveEvent(QGraphicsSceneMouseEvent *event) {
    QPointF pos = event->scenePos();
    pos.setX(qRound(pos.x()/gridSize)*gridSize);  // 水平吸附
    pos.setY(qRound(pos.y()/gridSize)*gridSize);  // 垂直吸附
    movingItem->setPos(pos);
}

5.3 撤销/重做实现

利用Qt的Undo框架：

cpp复制class MoveCommand : public QUndoCommand {
public:
    MoveCommand(QGraphicsItem *item, const QPointF &oldPos) {...}
    void undo() override { item->setPos(m_oldPos); }
    void redo() override { item->setPos(m_newPos); }
};

// 使用
QUndoStack *undoStack = new QUndoStack;
undoStack->push(new MoveCommand(item, oldPos));

6. 性能监控与调试

6.1 渲染耗时分析

使用QElapsedTimer测量关键操作：

cpp复制QElapsedTimer timer;
timer.start();
scene->render(&painter);  // 待测操作
qDebug() << "Render time:" << timer.elapsed() << "ms";

6.2 图元数量统计

定期输出场景状态：

cpp复制qDebug() << "Items count:" << scene->items().size()
         << "Visible items:" << scene->items(view->mapToScene(view->viewport()->rect()).boundingRect()).size();

6.3 内存泄漏检测

在调试模式下检查图元引用：

cpp复制#define DEBUG_ITEMS
#ifdef DEBUG_ITEMS
static int itemCount = 0;
itemCount++;  // 在构造函数中
qDebug() << "Items alive:" << itemCount;  // 在析构函数中--
#endif

我在实际项目中发现，当图元数量超过5000时，需要特别注意以下优化点：

1. 优先使用简单图元替代复杂图元
2. 对静态图元设置ItemDoesntPropagateOpacityToChildren标志
3. 对不可见图元调用setVisible(false)而不仅是setOpacity(0)
4. 使用QGraphicsItemGroup管理同类图元
5. 考虑分页加载机制，动态加载可见区域图元