QRhiGles2InitParams Struct

详细说明

基于 OpenGL 的QRhi 需要一个已创建的QSurface ，该对象可与QOpenGLContext 配合使用。实际上，最常见的情况是使用QOffscreenSurface 。此外，虽然不是必需的，但建议同时传入QWindow ，即第一个QRhiSwapChain 将要定位的目标。

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 的值。

必须在fallbackSurface 中指定一个QSurface 。为了防止在多线程环境中出现错误，QRhi 绝不会自动创建该对象，因为与QWindow 一样，QSurface 子类的实例通常只能在 GUI/主线程上创建。

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

如果希望与现有的QOpenGLContext 共享资源，可以将shareContext 设置为现有的QOpenGLContext 。此外，当启用时，Qt::AA_ShareOpenGLContexts 也会被接受。

与现有 OpenGL 上下文协作

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

另一种方法是创建一个QOpenGLContext ，使其通过shares resources 与另一个引擎的上下文建立关联，并通过QRhiGles2NativeHandles 传递该上下文。

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