多实例QGLWidget用于视频播放异常：黑屏问题求助

这个问题我之前在做多窗口OpenGL视频渲染时也踩过坑，结合你的代码来看，核心问题主要出在构造函数参数顺序错误和OpenGL上下文的管理逻辑上，下面一步步给你拆解解决：

1. 先修正最致命的构造函数参数问题 #

你当前的构造函数参数顺序和QGLWidget父类的定义完全不一致！QGLWidget的标准构造函数签名是：

QGLWidget(QWidget *parent = nullptr, const QGLWidget *shareWidget = nullptr, Qt::WindowFlags f = Qt::WindowFlags())

而你的代码把shareWidget放在了第一个参数位置，默认值为0。这就导致当你创建多实例不传参数时，实际是把parent参数当成了shareWidget传入，所有实例的parent都变成了nullptr，而且上下文共享逻辑完全混乱——这是多实例黑屏的核心原因之一。

修正后的构造函数应该和父类保持一致：

class GLWidget : public QGLWidget {
    Q_OBJECT
public:
    // 修正参数顺序，parent在前，shareWidget在后
    GLWidget(QWidget* parent = 0, const QGLWidget* shareWidget = 0) 
        : QGLWidget(parent, shareWidget) {
        // 此处保留你的QPixmap初始化代码
    }

    // 优化setCurrentImage方法，触发规范重绘
    void setCurrentImage(const QPixmap& pixmap) {
        m_currentPixmap = pixmap;
        updateGL(); // 触发paintGL重绘，确保在正确的上下文环境中绘制
    }

protected:
    void paintGL() override {
        // 关键：确保当前Widget的OpenGL上下文被激活
        makeCurrent();
        
        // 先清除缓冲区，避免上一帧残留
        glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
        
        // 使用QPainter绘制QPixmap，所有绘制操作必须在paintGL中完成
        QPainter painter(this);
        painter.setRenderHint(QPainter::SmoothPixmapTransform);
        painter.drawPixmap(this->rect(), m_currentPixmap);
    }

private:
    QPixmap m_currentPixmap;
};

2. 正确创建多实例的姿势 #

如果需要多个GLWidget共享OpenGL资源（比如纹理），可以把第一个创建的实例作为shareWidget传给后续实例；如果不需要共享，直接不传该参数即可：

// 主窗口中创建多实例并布局
void MainWindow::setupGLWidgets() {
    QGridLayout* gridLayout = new QGridLayout(ui->centralWidget);
    
    // 第一个实例，作为共享上下文的源（如果不需要共享，后续实例也不传shareWidget）
    GLWidget* widget1 = new GLWidget(this);
    // 第二个实例，传入第一个作为shareWidget共享上下文
    GLWidget* widget2 = new GLWidget(this, widget1);
    GLWidget* widget3 = new GLWidget(this, widget1);
    
    gridLayout->addWidget(widget1, 0, 0);
    gridLayout->addWidget(widget2, 0, 1);
    gridLayout->addWidget(widget3, 1, 0);
    
    // 测试播放：给每个实例设置不同的帧
    // widget1->setCurrentImage(frame1);
    // widget2->setCurrentImage(frame2);
    // widget3->setCurrentImage(frame3);
}

3. 额外注意事项 #

• 绝对不要在setCurrentImage中直接进行OpenGL绘制操作，必须通过updateGL()触发paintGL，因为只有paintGL执行时，当前Widget的上下文才是稳定激活的。
• 如果你的QPixmap是动态更新的视频帧，确保每个实例的m_currentPixmap是独立的，不要多个实例共用同一个QPixmap对象，避免线程/上下文冲突。
• 若使用纹理渲染而非QPainter，要确保共享上下文时纹理ID在所有实例中是有效的，或者每个实例创建自己的纹理。

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