QRhiGles2InitParams Struct

Description détaillée

Un site QRhi basé sur OpenGL a besoin d'un site QSurface déjà créé qui peut être utilisé en combinaison avec QOpenGLContext. Dans la pratique, il s'agit le plus souvent de QOffscreenSurface. De plus, bien qu'optionnel, il est recommandé que le QWindow que le premier QRhiSwapChain ciblera soit également transmis.

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

Par défaut, QRhi crée un QOpenGLContext tout seul. Cette approche fonctionne bien dans la plupart des cas, y compris dans les scénarios threadés, où il y a un QRhi dédié pour chaque thread de rendu. Comme il y aura un QOpenGLContext pour chaque QRhi, les exigences du contexte OpenGL (un contexte ne peut être courant que sur un seul thread) sont satisfaites. Le contexte implicitement créé est détruit automatiquement avec le QRhi.

Le QSurfaceFormat du contexte est spécifié dans format. Le constructeur lui attribue la valeur 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 les erreurs dans les situations threadées, il n'est jamais créé automatiquement par QRhi car, comme QWindow, les instances des sous-classes QSurface peuvent souvent être créées uniquement sur le thread gui/principal.

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

Si le partage des ressources avec un site QOpenGLContext existant est souhaité, shareContext peut être associé à un site QOpenGLContext existant. Alternativement, Qt::AA_ShareOpenGLContexts est également respecté, lorsqu'il est activé.

Travailler avec des contextes OpenGL existants

Lors de l'interopérabilité avec un autre moteur graphique, il peut être nécessaire d'obtenir une instance de QRhi qui utilise le même contexte OpenGL. Ceci peut être réalisé en passant un pointeur sur QRhiGles2NativeHandles à QRhi::create(). L'adresse QRhiGles2NativeHandles::context doit alors être définie à une valeur non nulle.

Une autre approche consiste à créer un QOpenGLContext qui shares resources avec le contexte de l'autre moteur et à transmettre ce contexte via QRhiGles2NativeHandles.

L'adresse QRhi n'est pas propriétaire de l'adresse QOpenGLContext transmise via QRhiGles2NativeHandles.