QRhiGles2InitParams Struct

詳細説明

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コンテキストの要件（コンテキストは1つのスレッド上でのみカレントとなる）は満たされます。暗黙的に作成されたコンテキストは、QRhi とともに自動的に破棄される。

コンテキストのQSurfaceFormat はformat で指定されます。コンストラクタはこれをQSurfaceFormat::defaultFormat() に設定するので、コンストラクタが実行される前に適切な設定でQSurfaceFormat::setDefaultFormat() を呼び出すアプリケーションは、format の値を変更する必要はありません。

QSurface fallbackSurfaceスレッド化された状況でのミスを防ぐため、QRhi によって自動的に作成されることはありません。これは、QWindow のように、QSurface のサブクラスのインスタンスは、gui/メイン・スレッドでのみ作成されることが多いからです。

便宜上、アプリケーションはnewFallbackSurface() を使うことができる。これは、QRhi の後に作成されるQOpenGLContext と互換性のあるQOffscreenSurface を作成して返す。返されたQOffscreenSurface の所有権は呼び出し元に移され、QRhi はそれを破壊しないことに注意。

既存のQOpenGLContext とリソースを共有したい場合、shareContext を既存のQOpenGLContext に設定することができる。また、Qt::AA_ShareOpenGLContexts が有効になっている場合は、 を使用することもできます。

既存のOpenGLコンテキストとの連携

別のグラフィックス・エンジンと相互運用する場合、同じOpenGLコンテキストを使用するQRhi インスタンスを取得する必要があるかもしれません。これは、QRhiGles2NativeHandles へのポインタをQRhi::create() に渡すことで実現できる。このとき、QRhiGles2NativeHandles::context には NULL 以外の値を設定しなければならない。

別の方法としては、他のエンジンのコンテキストを持つshares resources をQOpenGLContext として作成し、そのコンテキストをQRhiGles2NativeHandles 経由で渡す方法があります。

QRhi は、QRhiGles2NativeHandles を介して渡されたQOpenGLContext の所有権を持たない。