将QOpenGLWidget加入QGraphicsScene后如何更新OpenGL绘图？

我之前也碰到过一模一样的情况——原本单独显示时动画流畅的QOpenGLWidget，一放进QGraphicsScene就直接停更了。其实这和场景的缓存机制、部件的更新逻辑密切相关，下面给你具体的解决办法：

问题根源 #

当你用scene.addWidget(&window)把QOpenGLWidget添加到场景时，Qt会自动生成一个QGraphicsProxyWidget来包装这个Widget。默认情况下，这个代理部件会开启缓存优化绘制性能，但对于有动画的QOpenGLWidget来说，缓存会让场景复用旧的绘制内容，不会触发新帧的渲染，自然就停更了。另外，QOpenGLWidget自身的update()调用在场景环境下，可能无法正确触发整个场景的重绘流程。

具体解决方案 #

步骤1：禁用代理部件的缓存 #

在main.cpp里，保存addWidget返回的代理指针，然后强制关闭它的缓存功能：

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    QSurfaceFormat fmt;
    fmt.setSamples(4);
    QSurfaceFormat::setDefaultFormat(fmt);
    Window window;
    QGraphicsScene scene;
    // 保存代理部件的指针
    QGraphicsProxyWidget *proxy = scene.addWidget(&window);
    // 禁用缓存，确保动画帧能实时渲染
    proxy->setCacheMode(QGraphicsItem::NoCache);
    scene.addText("Hello");
    QGraphicsView view(&scene);
    view.show();
    return app.exec();
}

步骤2：强化动画的更新触发逻辑 #

检查你的Window类中的定时器逻辑，确保嵌入场景后定时器仍能正确触发重绘。比如原示例里的定时器可以改成这样：

// Window类构造函数内
QTimer *timer = new QTimer(this);
connect(timer, &QTimer::timeout, this, [this](){
    // 更新动画参数（比如旋转角度、元素位置等）
    update(); // 触发自身的paintGL调用
    // 额外保险：强制更新场景中该部件对应的区域
    if (auto proxy = qobject_cast<QGraphicsProxyWidget*>(parent())) {
        proxy->scene()->update(proxy->sceneBoundingRect());
    }
});
timer->start(16); // 约60帧每秒的更新频率

这段额外的代码能确保场景明确感知到部件需要更新，虽然禁用缓存后大部分情况不需要，但加上能更稳妥地解决更新不触发的问题。

步骤3：确认OpenGL上下文设置正确 #

你原代码里的QSurfaceFormat设置已经没问题了，这部分可以保留：

QSurfaceFormat fmt;
fmt.setSamples(4);
QSurfaceFormat::setDefaultFormat(fmt);

为什么这样有效？ #

• 禁用缓存后，QGraphicsScene不会再复用旧的绘制内容，每次重绘都会调用QOpenGLWidget的paintGL函数，动画的每一帧都能被正确渲染。
• 手动触发场景对应区域的更新，能弥补Widget自身update()在场景环境下的触发盲区，确保重绘流程正常运行。

内容的提问来源于stack exchange，提问作者Syaiful Nizam Yahya