如何正确使用QWidget.createWindowContainer将PyQt3D视图集成到QMainWindow？

我来帮你搞定这个问题——你碰到的QOpenGLContext::swapBuffers() called with non-exposed window错误，本质是Qt3DWindow的渲染窗口没正确和QWidget容器绑定，加上代码里还有几处小疏漏，才导致3D内容出不来。

问题根源 #

1. 你在Application类里注释掉了view3d = View3D()，导致setCentralWidget传入了未定义的变量，这会直接引发运行错误（不过你说窗口能打开，应该是测试时临时注释的）
2. View3D类中，你创建布局添加容器的方式，没有让Qt3DWindow的渲染上下文正确感知到容器的显示状态，导致渲染逻辑无法正常触发

修正方案 #

我们需要调整View3D的实现，确保Qt3DWindow的容器被正确关联到父控件，同时修复Application类的实例化问题。下面是完整的修正代码：

from PyQt5.QtWidgets import QMainWindow, QAction, QApplication, QWidget, QPushButton, qApp, QLabel, QHBoxLayout, QVBoxLayout, QSplitter
from PyQt5.QtGui import QIcon, QPixmap, QPainter, QImage, QMatrix4x4, QQuaternion, QVector3D, QColor, QGuiApplication
from PyQt5.QtCore import QSize, Qt
import sys
from PyQt5.Qt3DCore import QEntity, QTransform, QAspectEngine
from PyQt5.Qt3DRender import QCamera, QCameraLens, QRenderAspect
from PyQt5.Qt3DInput import QInputAspect
from PyQt5.Qt3DExtras import QForwardRenderer, QPhongMaterial, QCylinderMesh, QSphereMesh, QTorusMesh, Qt3DWindow, QOrbitCameraController

class View3D(QWidget):
    def __init__(self):
        super(View3D, self).__init__()
        # 创建Qt3D窗口实例
        self.view = Qt3DWindow()
        # 将Qt3D窗口包装为QWidget容器，并指定父控件为当前View3D
        self.container = QWidget.createWindowContainer(self.view, self)
        # 设置布局让容器占满整个View3D控件，消除边缘空白
        layout = QVBoxLayout(self)
        layout.setContentsMargins(0, 0, 0, 0)
        layout.addWidget(self.container)
        
        # 初始化3D场景并绑定到Qt3D窗口
        scene = createScene()
        initialiseCamera(self.view, scene)
        self.view.setRootEntity(scene)

def initialiseCamera(view, scene):
    # 相机参数保持不变
    camera = view.camera()
    camera.lens().setPerspectiveProjection(45.0, 16.0 / 9.0, 0.1, 1000.0)
    camera.setPosition(QVector3D(0.0, 0.0, 40.0))
    camera.setViewCenter(QVector3D(0.0, 0.0, 0.0))
    # 相机控制器设置
    camController = QOrbitCameraController(scene)
    camController.setLinearSpeed(50.0)
    camController.setLookSpeed(180.0)
    camController.setCamera(camera)

def createScene():
    # 3D场景创建逻辑保持不变
    rootEntity = QEntity()
    material = QPhongMaterial(rootEntity)
    # 圆环实体
    torusEntity = QEntity(rootEntity)
    torusMesh = QTorusMesh()
    torusMesh.setRadius(5)
    torusMesh.setMinorRadius(1)
    torusMesh.setRings(100)
    torusMesh.setSlices(20)
    torusTransform = QTransform()
    torusTransform.setScale3D(QVector3D(1.5, 1.0, 0.5))
    torusTransform.setRotation(
        QQuaternion.fromAxisAndAngle(QVector3D(1.0, 0.0, 0.0), 45.0))
    torusEntity.addComponent(torusMesh)
    torusEntity.addComponent(torusTransform)
    torusEntity.addComponent(material)
    # 球体实体
    sphereEntity = QEntity(rootEntity)
    sphereMesh = QSphereMesh()
    sphereMesh.setRadius(3)
    sphereEntity.addComponent(sphereMesh)
    sphereEntity.addComponent(material)
    return rootEntity

class Application(QMainWindow):
    def __init__(self):
        super().__init__()
        # 实例化3D视图控件并设置为主窗口中心控件
        view3d = View3D()
        self.setCentralWidget(view3d)
        # 设置主窗口初始大小，确保3D视图有足够渲染空间
        self.resize(800, 600)
        self.show()

# 集成Qt3D到QMainWindow的运行入口
if __name__ == '__main__':
    app = QApplication(sys.argv)
    ex = Application()
    sys.exit(app.exec_())

关键修正点 #

• 在调用QWidget.createWindowContainer时传入了父控件self，确保容器与View3D正确关联，让Qt3D能感知到容器的显示状态
• 布局设置了setContentsMargins(0,0,0,0)，避免容器周围出现空白，同时让容器占满整个View3D控件
• 修复了Application类中view3d的实例化问题，确保3D视图被正确设置为主窗口的中心控件
• 添加了主窗口初始大小设置，避免窗口过小导致渲染异常

这样修改后，Qt3D的渲染上下文就能正常工作，3D内容会正确显示，也不会再出现swapBuffers的错误提示了。

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