QOpenGLWidget未触发paintGL就执行swapBuffers的问题求助

问题描述 #

从QGLWidget移植到QOpenGLWidget时遇到以下行为差异：

• QOpenGLWidget中，鼠标Enter/Leave、菜单悬停/打开等窗口事件会触发swapBuffers()，但未调用paintGL()，导致显示错误的缓冲区内容。
• 复现场景：基于带菜单的QMainWindow实现两个控件，分别使用QOpenGLWidget（w）和QGLWidget（w2）：
  • 正常逻辑下，paintGL()绘制红色背景；
  • 定时器触发500ms后，prepare_sel()会准备一个用于鼠标选择的青色缓冲区（本不应被显示）。
• 实际表现：
  • QGLWidget（w2）：始终显示红色，仅在菜单打开/关闭时调用paintGL()完成完整刷新；
  • QOpenGLWidget（w）：初始为红色，菜单悬停/打开后变为青色——通过buffers_swapped回调可确认swapBuffers()已执行，但paintGL()未触发，错误显示了用于选择的青色缓冲区。

原因分析 #

这是QOpenGLWidget的正常设计行为，源于两者渲染机制的本质差异：

• QGLWidget依赖传统窗口系统绘图逻辑，仅在收到明确重绘请求（如update()/repaint()）时，才会依次调用paintGL()和swapBuffers()；
• QOpenGLWidget采用现代离屏渲染+合成机制，窗口系统的部分事件（如窗口状态变化、菜单交互导致的区域覆盖/恢复）会触发底层缓冲区交换，以保证界面一致性，但此时不会触发用户层面的paintGL()调用。

解决方案 #

1. 强制缓冲区交换前调用paintGL() #

重写QOpenGLWidget的swapBuffers()方法，确保每次交换前都执行paintGL()：

class MyOpenGLWidget(QOpenGLWidget):
    def swapBuffers(self):
        self.makeCurrent()
        self.paintGL()
        super().swapBuffers()

若paintGL()依赖窗口状态（如大小变化），可先调用self.update()再执行交换，但需注意可能带来的额外重绘开销。

2. 拦截触发额外交换的事件 #

针对鼠标Enter/Leave、菜单悬停这类非必要触发交换的事件，重写事件处理函数阻止默认行为：

class MyOpenGLWidget(QOpenGLWidget):
    def enterEvent(self, event):
        # 不调用父类实现，避免触发缓冲区交换
        pass

    def leaveEvent(self, event):
        pass

这种方式需逐个处理事件，适合场景明确的情况。

3. 绑定重绘与缓冲区合成信号 #

利用QOpenGLWidget的aboutToCompose()信号，在缓冲区合成前强制触发重绘：

class MyOpenGLWidget(QOpenGLWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.aboutToCompose.connect(self.update)

aboutToCompose()会在底层准备合成缓冲区前触发，调用update()可确保paintGL()被执行。

鼠标选择缓冲区的实现优化建议 #

当前直接操作默认显示缓冲区的方式存在固有风险，推荐使用**自定义离屏帧缓冲区（FBO）**分离显示与选择逻辑：

1. 在initializeGL()中创建用于选择的FBO；
2. prepare_sel()将选择内容绘制到FBO，而非默认缓冲区；
3. paintGL()始终绘制显示内容到默认缓冲区；
4. 鼠标选择时，读取FBO的像素数据进行判断。

示例代码如下：

class MyOpenGLWidget(QOpenGLWidget):
    def initializeGL(self):
        self.sel_fbo = QOpenGLFramebufferObject(self.size())

    def resizeGL(self, w, h):
        self.sel_fbo = QOpenGLFramebufferObject(QSize(w, h))

    def prepare_sel(self):
        self.sel_fbo.bind()
        # 绘制青色选择内容
        glClearColor(0.0, 1.0, 1.0, 1.0)
        glClear(GL_COLOR_BUFFER_BIT)
        # 其他选择绘制逻辑...
        self.sel_fbo.release()

    def paintGL(self):
        # 绘制显示内容（红色背景）
        glClearColor(1.0, 0.0, 0.0, 1.0)
        glClear(GL_COLOR_BUFFER_BIT)
        # 其他显示绘制逻辑...

这种方式彻底隔离了显示与选择缓冲区，从根源上避免了误显示问题。

内容的提问来源于stack exchange，提问作者Denis Rivière