QOpenGLWindow Class

QSurfaceFormat format;
format.setDepthBufferSize(24);
format.setStencilBufferSize(8);
setFormat(format);

成员函数文档

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

使用给定的parent 和updateBehavior 创建一个新的QOpenGLWindow。

另请参阅 QOpenGLWindow::UpdateBehavior 。

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLContext *shareContext, QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

使用给定的parent 和updateBehavior 创建一个新的QOpenGLWindow。该QOpenGLWindow的上下文将与shareContext 共享。

另请参阅 QOpenGLWindow::UpdateBehavior 和shareContext 。

[virtual noexcept] QOpenGLWindow::~QOpenGLWindow()

销毁QOpenGLWindow 实例，并释放其资源。

在析构函数中，将 OpenGLWindow 的上下文设为当前上下文，从而能够安全地销毁任何可能需要释放属于该窗口提供的上下文的 OpenGL 资源的子对象。

另请参阅 makeCurrent 。

QOpenGLContext *QOpenGLWindow::context() const

返回该窗口使用的QOpenGLContext 对象；若尚未初始化，则返回0 。

GLuint QOpenGLWindow::defaultFramebufferObject() const

该窗口使用的帧缓冲区对象句柄。

当更新行为设置为NoPartialUpdate 时，不存在单独的帧缓冲区对象。在这种情况下，返回值是默认帧缓冲区的ID。

否则，返回帧缓冲区对象的 ID 值；若尚未初始化，则返回0 。

void QOpenGLWindow::doneCurrent()

释放上下文。

在大多数情况下无需调用此函数，因为当调用 `paintGL()` 时，控件会确保上下文被正确绑定和释放。

另请参阅 makeCurrent()。

[signal] void QOpenGLWindow::frameSwapped()

该信号是在可能导致阻塞的buffer swap 执行完毕后发出的。希望与垂直刷新同步进行持续重绘的应用程序，应在接收到此信号时调用update()。与传统使用定时器的方式相比，这能带来更流畅的使用体验。

QImage QOpenGLWindow::grabFramebuffer()

返回帧缓冲区的副本。

[virtual protected] void QOpenGLWindow::initializeGL()

在首次调用paintGL()或resizeGL()之前，会调用一次此虚拟函数。请在子类中重写该函数。

该函数应初始化所有必要的 OpenGL 资源和状态。

无需调用 `makeCurrent()`，因为在调用本函数时该操作已执行完毕。但请注意，若使用部分更新模式，此时帧缓冲区尚不可用，因此请避免在此处发出绘制调用。应将此类调用推迟至 `paintGL()` 中执行。

另请参阅 paintGL() 和resizeGL()。

bool QOpenGLWindow::isValid() const

如果窗口的 OpenGL 资源（如上下文）已成功初始化，则返回true 。请注意，在窗口被显示出来之前，返回值始终为false 。

void QOpenGLWindow::makeCurrent()

通过将相应的上下文设为当前上下文，并在该上下文中绑定帧缓冲区对象（如有），为本窗口的 OpenGL 内容渲染做好准备。

在大多数情况下无需调用此函数，因为在调用 `paintGL()` 之前它会自动被调用。不过，该函数仍被提供，以支持高级的多线程场景——在这些场景中，除 GUI 或主线程之外的其他线程可能需要更新表面或帧缓冲区的内容。有关线程相关问题的更多信息，请参阅QOpenGLContext 。

当底层平台窗口已被销毁时，此函数同样适用。这意味着从QOpenGLWindow 子类的析构函数中调用此函数是安全的。如果不存在本机窗口，则会改用离屏表面。这确保了只要先调用此函数，析构函数中的 OpenGL 资源清理操作总能正常进行。

另请参阅 QOpenGLContext 、context()、paintGL() 以及doneCurrent()。

[override virtual protected] void QOpenGLWindow::paintEvent(QPaintEvent *event)

重写：QPaintDeviceWindow::paintEvent(QPaintEvent *event)。

绘制event 处理程序。调用paintGL()。

另请参阅 paintGL()。

[virtual protected] void QOpenGLWindow::paintGL()

每当需要绘制窗口内容时，都会调用此虚拟函数。请在子类中重写该函数。

无需调用makeCurrent()，因为在调用此函数时，该操作已经完成。

在调用此函数之前，上下文和帧缓冲区（如果存在）已被绑定，并且通过调用 glViewport() 设置了视口。框架不会设置其他状态，也不会执行清屏或绘制操作。

另请参阅 initializeGL()、resizeGL()、paintUnderGL()、paintOverGL() 以及UpdateBehavior 。

[virtual protected] void QOpenGLWindow::paintOverGL()

每次调用paintGL()后，都会调用此虚拟函数。

当更新模式设置为NoPartialUpdate 时，该函数与paintGL()之间没有区别，在两者中进行渲染都会得到相同的结果。

与paintUnderGL() 一样，无论更新行为如何，此函数中的渲染都针对窗口的默认帧缓冲区。它在paintGL() 返回且完成位图复制（PartialUpdateBlit ）或四边形绘制（PartialUpdateBlend ）之后被调用。

另请参阅 paintGL()、paintUnderGL() 以及UpdateBehavior 。

[virtual protected] void QOpenGLWindow::paintUnderGL()

每次调用paintGL()之前，都会先调用该虚拟函数。

当更新模式设置为NoPartialUpdate 时，该函数与paintGL()之间没有区别，在两者中进行渲染都会得到相同的结果。

当使用PartialUpdateBlend 时，差异就变得显著，因为此时会使用一个额外的帧缓冲区对象。在这种情况下，paintGL() 针对的是这个额外的帧缓冲区对象，该对象会保留其内容；而 paintUnderGL() 和paintOverGL() 则针对默认帧缓冲区，即直接针对窗口表面，其内容在每个帧显示后都会丢失。

另请参阅 paintGL()、paintOverGL() 和UpdateBehavior 。

[override virtual protected] void QOpenGLWindow::resizeEvent(QResizeEvent *event)

重写：QWindow::resizeEvent(QResizeEvent *ev)。

event 的大小调整处理程序。调用resizeGL()。

另请参阅 resizeGL()。

[virtual protected] void QOpenGLWindow::resizeGL(int w, int h)

每当小部件被调整大小时，都会调用此虚拟函数。请在子类中重新实现该函数。新尺寸将通过w 和h 传递进来。

另请参阅 initializeGL() 和paintGL()。

QOpenGLContext *QOpenGLWindow::shareContext() const

返回请求与该窗口的QOpenGLContext 共享的QOpenGLContext 。

QOpenGLWindow::UpdateBehavior QOpenGLWindow::updateBehavior() const

返回此QOpenGLWindow 的更新行为。