QRhiGles2InitParams Struct

Ausführliche Beschreibung

Ein OpenGL-basiertes „ QRhi “ benötigt ein bereits erstelltes „ QSurface “, das in Kombination mit „ QOpenGLContext “ verwendet werden kann. In der Praxis handelt es sich dabei meist um ein „ QOffscreenSurface “. Zusätzlich wird empfohlen – auch wenn dies optional ist –, die „ QWindow “ anzugeben, auf die das erste „ QRhiSwapChain “ abzielen soll.

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

Standardmäßig erstellt ` QRhi ` selbstständig einen ` QOpenGLContext `. Dieser Ansatz funktioniert in den meisten Fällen gut, einschließlich Thread-Szenarien, in denen es für jeden Rendering-Thread einen eigenen ` QRhi ` gibt. Da es für jeden ` QRhi` einen ` QOpenGLContext ` gibt, sind die Anforderungen an den OpenGL-Kontext (ein Kontext kann nur in 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 Wert auf ` QSurfaceFormat::defaultFormat()`, sodass Anwendungen, die ` QSurfaceFormat::setDefaultFormat()` mit den entsprechenden Einstellungen aufrufen, bevor der Konstruktor ausgeführt wird, den Wert von ` format` nicht ändern müssen.

In ` fallbackSurface` muss ein ` QSurface ` angegeben werden. Um Fehler in Thread-Umgebungen zu vermeiden, wird dieser vom ` QRhi ` niemals automatisch erstellt, da Instanzen von Unterklassen von ` QSurface ` – genau wie bei ` QWindow` – oft nur im GUI-/Haupt-Thread erstellt werden dürfen.

Der Einfachheit halber können Anwendungen newFallbackSurface() verwenden, das ein QOffscreenSurface erstellt und zurückgibt, das mit dem QOpenGLContext kompatibel ist, das anschließend von QRhi erstellt wird. Beachten Sie, dass die Eigentumsrechte an dem zurückgegebenen QOffscreenSurface auf den Aufrufer übertragen werden und QRhi dieses nicht zerstört.

Falls eine gemeinsame Nutzung von Ressourcen mit einem bestehenden „ QOpenGLContext “ gewünscht wird, kann „ shareContext “ auf ein bestehendes „ QOpenGLContext “ gesetzt werden. Alternativ wird „ Qt::AA_ShareOpenGLContexts “ ebenfalls berücksichtigt, sofern diese Option aktiviert ist.

Arbeiten mit bestehenden OpenGL-Kontexten

Bei der Zusammenarbeit mit einer anderen Grafik-Engine kann es erforderlich sein, eine „ QRhi “-Instanz zu erhalten, die denselben OpenGL-Kontext verwendet. Dies lässt sich erreichen, indem ein Zeiger auf einen „ QRhiGles2NativeHandles “ an „ QRhi::create()“ übergeben wird. Der „ QRhiGles2NativeHandles::context “ muss dann auf einen Wert ungleich Null gesetzt werden.

Ein alternativer Ansatz besteht darin, ein ` QOpenGLContext ` zu erstellen, das mit dem Kontext der anderen Engine ` shares resources ` verbindet, und diesen Kontext über ` QRhiGles2NativeHandles` zu übergeben.

Die ` QRhi ` übernimmt nicht die Eigentumsrechte an dem über ` QRhiGles2NativeHandles` übergebenen ` QOpenGLContext `.