QRhiGles2InitParams Struct

详细描述

基于 OpenGL 的QRhi 需要一个已创建的QSurface ，该 可与QOpenGLContext 结合使用。在实践中，这通常是一个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 上下文要求（一个上下文只能在一个线程上处于当前状态）。隐式创建的上下文会与QRhi 一起自动销毁。

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

QSurface 必须在fallbackSurface 中指定。为了防止在线程情况下出错，QRhi 不会自动创建 ，因为与QWindow 一样，QSurface 子类的实例通常只能在 gui/main 线程上创建。

为了方便起见，应用程序可以使用newFallbackSurface() 来创建并返回一个与QOpenGLContext 兼容的QOffscreenSurface ，后者将由QRhi 创建。请注意，返回的QOffscreenSurface 的所有权将转移给调用者，QRhi 不会销毁它。

如果希望与现有的QOpenGLContext 共享资源，可将shareContext 设置为现有的QOpenGLContext 。或者，启用Qt::AA_ShareOpenGLContexts 后，也可以共享。

与现有 OpenGL 上下文协同工作

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

另一种方法是创建一个QOpenGLContext ，shares resources ，并通过QRhiGles2NativeHandles 传入该上下文。

QRhi 不拥有通过QRhiGles2NativeHandles 传入的QOpenGLContext 的所有权。