QOpenGLWindow 类

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

成员函数文档

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

使用指定的 parent 和 updateBehavior 构造新的 QOpenGLWindow。

另请参阅QOpenGLWindow::UpdateBehavior。

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

使用指定的 parent 和 updateBehavior 构造新的 QOpenGLWindow。QOpenGLWindow 的上下文将与 shareContext 共享。

另请参阅QOpenGLWindow::UpdateBehavior 和 shareContext。

[虚 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()

此信号在可能阻塞的 缓冲区交换 完成后发出。希望与垂直刷新同步连续重绘的应用程序应该在接收此信号时发出 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（）。

[覆盖虚保护] void QOpenGLWindow::paintEvent(QPaintEvent *event)

重新实现: QPaintDeviceWindow::paintEvent(QPaintEvent *event).

绘制事件处理程序。调用paintGL（）。

另见 paintGL（）。

[虚保护] void QOpenGLWindow::paintGL()

此虚函数在需要绘制窗口内容时被调用。在子类中重新实现它。

不需要调用makeCurrent（），因为此操作在调用此函数时已经完成。

在调用此函数之前，通过调用glViewport（）设置上下文和帧缓冲区（如果有），并通过glViewport（）设置视口。框架不设置其他状态，也不执行清除或绘图。

另见 initializeGL（），resizeGL（），paintUnderGL（），paintOverGL（）和UpdateBehavior。

[虚保护] void QOpenGLWindow::paintOverGL()

此虚函数在每次调用paintGL（）之后被调用。

当更新模式设置为NoPartialUpdate时，此函数与paintGL（）之间没有区别，在其中任何一个中执行渲染都会产生相同的结果。

与paintUnderGL（）一样，此函数的渲染针对窗口的默认帧缓冲区，不受更新行为的影响。它在paintGL（ ）返回后调用，并在PartialUpdateBlit或四边形绘制PartialUpdateBlend之后进行。

另见 paintGL（），paintUnderGL（）和UpdateBehavior。

[虚保护] void QOpenGLWindow::paintUnderGL()

此虚函数在每次调用paintGL（）之前被调用。

当更新模式设置为NoPartialUpdate时，此函数与paintGL（）之间没有区别，在其中任何一个中执行渲染都会产生相同的结果。

当使用 PartialUpdateBlend 时，差异变得显著，那里使用了额外的帧缓冲区对象。在这里，paintGL() 以此附加的帧缓冲区对象为目标，保留其内容，而 paintUnderGL() 和 paintOverGL() 则以默认帧缓冲区为目标，即直接针对窗口表面，每个显示的帧之后都会丢失其内容。

另请参阅： paintGL()，paintOverGL()，以及 UpdateBehavior。

[覆盖虚保护] void QOpenGLWindow::resizeEvent(QResizeEvent *event)

重新实现： QWindow::resizeEvent(QResizeEvent *ev).

调整大小 事件 处理程序。调用 resizeGL().

另请参阅： resizeGL().

[虚保护] void QOpenGLWindow::resizeGL(int w, int h)

此虚函数在部件大小变化时被调用。在子类中重新实现它。新的尺寸通过 w 和 h 传递。

另请参阅：initializeGL() 和 paintGL().

QOpenGLContext *QOpenGLWindow::shareContext() const

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

QOpenGLWindow::UpdateBehavior QOpenGLWindow::updateBehavior() const

返回此 QOpenGLWindow 的更新行为。