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つのコンテキストは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 の所有権を取得しません。