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。

否则，返回 framebuffer 对象 ID 的值，如果尚未初始化，则返回0 。

void QOpenGLWindow::doneCurrent()

释放上下文。

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

另请参阅 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() 之前会自动调用该函数。不过，在不同于图形用户界面或主线程的线程可能希望更新曲面或帧缓冲区内容时，我们还是提供了该函数以支持高级多线程方案。有关线程相关问题的更多信息，请参见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() 返回、blit (PartialUpdateBlit) 或 quad drawing (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 的更新行为。