QOpenGLContext 类

成员函数文档

[显式] QOpenGLContext::QOpenGLContext(QObject *parent = nullptr)

创建一个新的带有父对象 parent 的OpenGL上下文实例。

在可以使用之前，您需要设置适当的格式并调用 create()。

另请参阅 create() 和 makeCurrent。

[虚拟 noexcept] QOpenGLContext::~QOpenGLContext()

销毁 QOpenGLContext 对象。

如果是该线程的当前上下文，将调用 doneCurrent。

[信号] void QOpenGLContext::aboutToBeDestroyed()

在销毁底层原生OpenGL上下文前发出此信号，以便用户可以清理可能被视为悬挂的OpenGL资源。

如果您希望将上下文设置为当前上下文以进行清理，请确保仅使用直接连接连接到该信号。

[静态] bool QOpenGLContext::areSharing(QOpenGLContext *first, QOpenGLContext *second)

如果 first 和 second 上下文正在共享OpenGL资源，则返回 true。

bool QOpenGLContext::create()

尝试使用当前配置创建OpenGL上下文。

当前配置包括格式、共享上下文和屏幕。

如果您的系统上的OpenGL实现不支持请求的OpenGL上下文版本，则 QOpenGLContext 将尝试创建最接近的匹配版本。可以使用由 format() 函数返回的 QSurfaceFormat 查询实际创建的上下文属性。例如，如果您请求支持OpenGL 4.3 Core profile的上下文，但驱动程序和/或硬件仅支持版本3.2 Core profile上下文，则您将得到3.2 Core profile上下文。

如果原生上下文已成功创建并准备好与 makeCurrent()、swapBuffers() 等一起使用，则返回 true。

另请参阅 makeCurrent() 和 format。

[静态] QOpenGLContext *QOpenGLContext::currentContext()

返回当前线程中最后调用makeCurrent的上下文，如果没有当前上下文，则返回nullptr。

GLuint QOpenGLContext::defaultFramebufferObject() const

用此方法获取当前表面的默认帧缓冲对象。

在某些平台上（例如iOS），默认帧缓冲对象取决于渲染到的表面，并且可能不等于0。因此，如果你想在不同Qt平台上让应用程序工作，你应该调用ctx->defaultFramebufferObject()而不是glBindFramebuffer(0)。

如果你在QOpenGLFunctions中使用glBindFramebuffer()，你不用担心这个问题，因为当传入0时，它将自动绑定当前上下文的defaultFramebufferObject()。

另请参阅：QOpenGLFramebufferObject。

void QOpenGLContext::doneCurrent()

方便函数，用于以0表面调用makeCurrent。

这导致当前线程中没有上下文。

另请参阅：makeCurrent()和currentContext()。

QSet<QByteArray> QOpenGLContext::extensions() const

返回该上下文支持的OpenGL扩展集。

上下文或共享上下文必须当前处于活动状态。

另请参阅：hasExtension。

QOpenGLExtraFunctions *QOpenGLContext::extraFunctions() const

获取此上下文的QOpenGLExtraFunctions实例。

QOpenGLContext提供这一点作为方便的方式访问QOpenGLExtraFunctions，而无需手动管理。

上下文或共享上下文必须当前处于活动状态。

返回的QOpenGLExtraFunctions实例准备好使用，且无需调用initializeOpenGLFunctions()。

另请参阅：QOpenGLFunctions和QOpenGLExtraFunctions。

QSurfaceFormat QOpenGLContext::format() const

如果create()已被调用，则返回底层平台上下文的格式。

否则，返回请求的格式。

请求的格式和实际格式可能不同。请求一个OpenGL版本并不表示生成的上下文将正好针对请求的版本。只有保证创建的上下文的版本/配置文件/选项组合与请求兼容，只要驱动程序能够提供这样的上下文。

例如，请求OpenGL 3.x核心配置文件上下文可能导致OpenGL 4.x核心配置文件上下文。类似地，请求OpenGL 2.1可能导致启用已弃用函数的OpenGL 3.0上下文。最后，根据驱动程序，不支持版本可能导致创建上下文失败或创建最高支持版本的上下文。

缓冲区大小也可能会出现类似差异，例如，生成的上下文可能有比请求更大的深度缓冲区。这是完全正常的。

另请参阅 setFormat().

QOpenGLFunctions *QOpenGLContext::functions() const

获取此上下文的QOpenGLFunctions实例。

QOpenGLContext提供这是一种方便的方法，以便在不手动管理的情况下访问QOpenGLFunctions。

上下文或共享上下文必须当前处于活动状态。

返回的QOpenGLFunctions实例已准备好使用，无需调用initializeOpenGLFunctions()。

QFunctionPointer QOpenGLContext::getProcAddress(const QByteArray &procName) const

将函数指针解析为OpenGL扩展函数，该扩展函数由procName标识。

如果没有找到这样的函数，则返回nullptr。

QFunctionPointer QOpenGLContext::getProcAddress(const char *procName) const

这是一个重载函数。

[静态] QOpenGLContext *QOpenGLContext::globalShareContext()

如果存在全局共享OpenGL上下文，则返回应用范围内的共享OpenGL上下文。否则，返回nullptr。

当您需要在创建或显示QOpenGLWidget或QQuickWidget之前上传OpenGL对象（缓冲区、纹理等）时，这非常有用。

另请参阅 Qt::AA_ShareOpenGLContexts、setShareContext和makeCurrent。

bool QOpenGLContext::hasExtension(const QByteArray &extension) const

如果此OpenGL上下文支持指定的OpenGL 扩展，则返回true，否则返回false。

上下文或共享上下文必须当前处于活动状态。

另请参阅 extensions。

bool QOpenGLContext::isOpenGLES() const

如果上下文是OpenGL ES上下文，则返回true。

如果上下文尚未创建，结果将基于通过 setFormat() 设置的请求格式。

另请参阅 create()，format() 和 setFormat()。

bool QOpenGLContext::isValid() const

返回此上下文是否有效，即是否成功创建。

在某些平台上，之前已成功创建的上下文返回值为 false 表示OpenGL上下文已丢失。

处理上下文丢失场景的典型方式是在 makeCurrent() 失败并返回 false 时通过此函数进行检查。如果此函数然后返回 false，则通过调用 create() 重新创建底层本机OpenGL上下文，然后再次调用 makeCurrent()，然后重新初始化所有OpenGL资源。

在某些平台上，上下文丢失的情况是无法避免的。在其他平台上，可能需要启用。这可以通过在 QSurfaceFormat 中启用 ResetNotification 来完成。这将导致在底层本机OpenGL上下文中设置 RESET_NOTIFICATION_STRATEGY_EXT 为 LOSE_CONTEXT_ON_RESET_EXT。然后，QOpenGLContext 将在每个 makeCurrent() 时通过 glGetGraphicsResetStatusEXT() 监控状态。

另请参阅 create()。

bool QOpenGLContext::makeCurrent(QSurface *surface)

将指定的 surface 成为此线程中的当前上下文。如果成功，则返回 true；否则返回 false。后者可能会发生，如果该表面未公开，或者由于例如应用程序已挂起等原因，图形硬件不可用。

如果 surface 是 nullptr，则与此调用 doneCurrent()等效。

请勿从 QOpenGLContext 实例所在的线程之外调用此函数。如果您希望从不同线程使用 QOpenGLContext，应首先确保它不是在当前线程中当前，如果需要，可以通过调用 doneCurrent() 来完成。然后在其他线程中使用之前，调用 moveToThread(otherThread)。

默认情况下，Qt 会在线程亲和力上执行检查以强制执行上述条件。仍然可以通过设置应用程序属性 Qt::AA_DontCheckOpenGLContextThreadAffinity 来禁用此检查。请确保理解在QObject 线程亲和力 文档中解释的从线程外部使用 QObjects 的后果。

另请参阅 functions()，doneCurrent() 和 Qt::AA_DontCheckOpenGLContextThreadAffinity。

template <typename QNativeInterface> QNativeInterface *QOpenGLContext::nativeInterface() const

为上下文返回给定类型的本机接口。

此函数提供对定义在 QNativeInterface 命名空间中 QOpenGLContext 的平台特定功能的访问。

If the requested interface is not available, a nullptr is returned.

[static] QOpenGLContext::OpenGLModuleType QOpenGLContext::openGLModuleType()

Returns the underlying OpenGL implementation type.

On platforms where the OpenGL implementation is not dynamically loaded, the return value is determined during compile time and never changes.

QScreen *QOpenGLContext::screen() const

Returns the screen the context was created for.

See also setScreen().

void QOpenGLContext::setFormat(const QSurfaceFormat &format)

设置OpenGL上下文应兼容的format。您需要在它生效前调用create()。

当格式未通过此函数显式设置时，将使用QSurfaceFormat::defaultFormat()返回的格式。这意味着在具有多个上下文的情况下，可以通过在创建第一个上下文之前对QSurfaceFormat::setDefaultFormat()进行一次调用来替换对函数的单个调用。

See also format().

void QOpenGLContext::setScreen(QScreen *screen)

设置OpenGL上下文应有效的screen。您需要在它生效前调用create()。

See also screen().

void QOpenGLContext::setShareContext(QOpenGLContext *shareContext)

使此上下文与shareContext共享纹理、着色器和其他OpenGL资源。您需要在它生效前调用create()。

See also shareContext().

QOpenGLContext *QOpenGLContext::shareContext() const

Returns the share context this context was created with.

If the underlying platform was not able to support the requested sharing, this will return 0.

See also setShareContext().

QOpenGLContextGroup *QOpenGLContext::shareGroup() const

Returns the share group this context belongs to.

[static] bool QOpenGLContext::supportsThreadedOpenGL()

Returns true if the platform supports OpenGL rendering outside the main (gui) thread.

该值由当前使用的平台插件控制，也可能取决于图形驱动程序。

QSurface *QOpenGLContext::surface() const

返回已使上下文成为当前上下文的表面。

这是传递给 makeCurrent() 函数的参数表面对象。

void QOpenGLContext::swapBuffers(QSurface *surface)

交换surface的最后和前置缓存。

调用此函数以完成OpenGL渲染帧，并在发射任何进一步的OpenGL命令之前（例如，在新帧范围内）重新调用makeCurrent()，确保正确刷新屏幕。