QRhiGles2InitParams Struct

Description détaillée

Un « QRhi » basé sur OpenGL nécessite un « QSurface » déjà créé, pouvant être utilisé en combinaison avec « QOpenGLContext ». En pratique, il s’agit le plus souvent d’un « QOffscreenSurface ». De plus, bien que cela soit facultatif, il est recommandé de passer également l’« QWindow » que le premier « QRhiSwapChain » ciblera.

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

Par défaut, ` QRhi ` crée lui-même un ` QOpenGLContext `. Cette approche fonctionne bien dans la plupart des cas, y compris dans les scénarios multithread, où il existe un ` QRhi ` dédié pour chaque thread de rendu. Comme il y aura un ` QOpenGLContext ` pour chaque ` QRhi`, les exigences relatives au contexte OpenGL (un contexte ne peut être actif que sur un seul thread) sont respectées. Le contexte créé implicitement est détruit automatiquement en même temps que l’` QRhi`.

L'QSurfaceFormat e du contexte est spécifiée dans format. Le constructeur définit cette valeur sur QSurfaceFormat::defaultFormat(), de sorte que les applications qui appellent QSurfaceFormat::setDefaultFormat() avec les paramètres appropriés avant l'exécution du constructeur n'auront pas besoin de modifier la valeur de format.

Un QSurface doit être spécifié dans fallbackSurface. Afin d’éviter toute erreur dans les contextes multithread, celui-ci n’est jamais créé automatiquement par QRhi car, à l’instar de QWindow, les instances des sous-classes de QSurface ne peuvent souvent être créées que sur le thread principal de l’interface graphique.

Pour plus de commodité, les applications peuvent utiliser newFallbackSurface() qui crée et renvoie un QOffscreenSurface compatible avec l’ QOpenGLContext qui sera créé par la suite par QRhi. Notez que la propriété de l’ QOffscreenSurface renvoyé est transférée à l’appelant et que QRhi ne le détruira pas.

Si l’on souhaite partager des ressources avec un contexte OpenGL existant ( QOpenGLContext ), shareContext peut être défini sur un contexte existant ( QOpenGLContext). Par ailleurs, Qt::AA_ShareOpenGLContexts est également pris en compte lorsqu’il est activé.

Utilisation de contextes OpenGL existants

Lors de l’interopérabilité avec un autre moteur graphique, il peut s’avérer nécessaire d’obtenir une instance d’ QRhi utilisant le même contexte OpenGL. Pour ce faire, il suffit de passer un pointeur vers un QRhiGles2NativeHandles à la fonction QRhi::create(). Le paramètre QRhiGles2NativeHandles::context doit alors être défini sur une valeur non nulle.

Une autre approche consiste à créer un ` QOpenGLContext ` qui effectue un ` shares resources ` avec le contexte de l’autre moteur, puis à transmettre ce contexte via ` QRhiGles2NativeHandles`.

L’ QRhi ne prend pas possession de l’ QOpenGLContext transmis via QRhiGles2NativeHandles.