QRhiGles2InitParams 结构体

详细描述

基于 OpenGL 的 QRhi 需要一个已创建的、可以与 QOpenGLContext 结合使用的 QSurface。在实践中，这通常是一个 QOffscreenSurface。此外，虽然可选，但建议同时传入第一个 QRhiSwapChain 将要针对的 QWindow。

QOffscreenSurface *fallbackSurface = QRhiGles2InitParams::newFallbackSurface();
QRhiGles2InitParams params;
params.fallbackSurface = fallbackSurface;
params.window = window;
rhi = QRhi::create(QRhi::OpenGLES2, &params);

默认情况下，QRhi 会自行创建一个 QOpenGLContext。这种方法在大多数情况下都很好，包括线程化场景，其中每个渲染线程都有一个专门的 QRhi。由于每个 QRhi 都有一个 QOpenGLContext，因此满足 OpenGL 上下文要求（一个上下文只能在一个线程中当前）。

上下文的 QSurfaceFormat 在 format 中指定。构造函数将其设置为 QSurfaceFormat::defaultFormat()，因此在使用构造函数运行之前已使用适当的设置调用 QSurfaceFormat::setDefaultFormat() 的应用程序无需更改 format 的值。

必须指定一个 QSurface 在 fallbackSurface 中。为了避免在多线程情况下的错误，QRhi 从不会自动创建它，因为，像 QWindow 一样，QSurface 的子类实例通常只能在 gui/main 线程上创建。

作为一个便利，应用程序可以使用 newFallbackSurface()，该函数创建并返回一个与 QOpenGLContext 兼容的 QOffscreenSurface，该 QOpenGLContext 将由 QRhi 之后创建。请注意，返回的 QOffscreenSurface 的所有权转移给调用者，并且 QRhi 不会销毁它。

如果希望与他人现有的 QOpenGLContext 共享资源，则可以将 shareContext 设置为现有的 QOpenGLContext。或者，当启用时，也会考虑 Qt::AA_ShareOpenGLContexts。

与现有 OpenGL 上下文一起工作

当与其他图形引擎相互操作时，可能会需要获取一个使用相同 OpenGL 上下文的 QRhi 实例。这可以通过将一个指向 QRhiGles2NativeHandles 的指针传递给 QRhi::create() 来实现。然后必须将 QRhiGles2NativeHandles::context 设置为一个非空值。

另一种方法是创建一个与另一个引擎的上下文QOpenGLContext QOpenGLContext QOpenGLContext QOpenGLContext 兼容的 QOpenGLContext，并通过 QRhiGles2NativeHandles 传递该上下文。

QRhi 不会从通过 QRhiGles2NativeHandles 传递的 QOpenGLContext 中获取所有权。