QRhiGles2InitParams Struct

Detaillierte Beschreibung

Ein OpenGL-basiertes QRhi benötigt ein bereits erstelltes QSurface, das in Kombination mit QOpenGLContext verwendet werden kann. In der Praxis ist dies in den meisten Fällen eine QOffscreenSurface. Zusätzlich, obwohl optional, wird empfohlen, dass die QWindow, auf die das erste QRhiSwapChain abzielt, ebenfalls mit übergeben wird.

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

Standardmäßig erstellt QRhi selbständig eine QOpenGLContext. Dieser Ansatz funktioniert in den meisten Fällen gut, auch in Szenarien mit mehreren Threads, in denen es für jeden Rendering-Thread ein eigenes QRhi gibt. Da es für jeden QRhi einen QOpenGLContext gibt, sind die OpenGL-Kontextanforderungen (ein Kontext kann nur auf einem Thread aktuell sein) erfüllt. Der implizit erstellte Kontext wird automatisch zusammen mit dem QRhi zerstört.

Der QSurfaceFormat für den Kontext wird in format angegeben. Der Konstruktor setzt diesen auf QSurfaceFormat::defaultFormat(), so dass Anwendungen, die QSurfaceFormat::setDefaultFormat() mit den entsprechenden Einstellungen aufrufen, bevor der Konstruktor läuft, den Wert von format nicht ändern müssen.

Ein QSurface muss in fallbackSurface angegeben werden. Um Fehler in threaded Situationen zu vermeiden, wird dieses niemals automatisch von QRhi erstellt, da, wie QWindow, Instanzen von QSurface Unterklassen oft nur auf dem gui/main thread erstellt werden können.

Als Bequemlichkeit können Anwendungen newFallbackSurface() verwenden, das ein QOffscreenSurface erzeugt und zurückgibt, das mit dem QOpenGLContext kompatibel ist, das anschließend von QRhi erzeugt wird. Beachten Sie, dass das Eigentum an der zurückgegebenen QOffscreenSurface an den Aufrufer übertragen wird und die QRhi sie nicht zerstört.

Falls die gemeinsame Nutzung von Ressourcen mit einem bestehenden QOpenGLContext gewünscht ist, kann shareContext auf ein bestehendes QOpenGLContext gesetzt werden. Alternativ dazu wird auch Qt::AA_ShareOpenGLContexts beachtet, wenn es aktiviert ist.

Arbeiten mit bestehenden OpenGL-Kontexten

Bei der Zusammenarbeit mit einer anderen Grafik-Engine kann es notwendig sein, eine QRhi -Instanz zu erhalten, die denselben OpenGL-Kontext verwendet. Dies kann erreicht werden, indem ein Zeiger auf eine QRhiGles2NativeHandles an QRhi::create() übergeben wird. Die QRhiGles2NativeHandles::context muss dann auf einen Nicht-Null-Wert gesetzt werden.

Ein alternativer Ansatz ist es, eine QOpenGLContext zu erstellen, die shares resources mit dem Kontext der anderen Engine und die Übergabe dieses Kontextes über QRhiGles2NativeHandles.

Die QRhi übernimmt nicht das Eigentum an der QOpenGLContext, die über QRhiGles2NativeHandles übergeben wird.