QOpenGLContext Class

Dokumentation der Mitgliedsfunktionen

[explicit] QOpenGLContext::QOpenGLContext(QObject *parent = nullptr)

Erzeugt eine neue OpenGL-Kontextinstanz mit dem übergeordneten Objekt parent.

Bevor es verwendet werden kann, müssen Sie das richtige Format einstellen und create() aufrufen.

Siehe auch create() und makeCurrent().

[virtual noexcept] QOpenGLContext::~QOpenGLContext()

Zerstört das Objekt QOpenGLContext.

Wenn dies der aktuelle Kontext des Threads ist, wird auch doneCurrent() aufgerufen.

[signal] void QOpenGLContext::aboutToBeDestroyed()

Dieses Signal wird ausgegeben, bevor der zugrundeliegende native OpenGL-Kontext zerstört wird, so dass Benutzer OpenGL-Ressourcen aufräumen können, die andernfalls im Fall von gemeinsam genutzten OpenGL-Kontexten hängen bleiben könnten.

Wenn Sie den Kontext aktuell machen wollen, um Aufräumarbeiten durchzuführen, stellen Sie sicher, dass Sie sich nur über eine direkte Verbindung mit dem Signal verbinden.

[static] bool QOpenGLContext::areSharing(QOpenGLContext *first, QOpenGLContext *second)

Gibt true zurück, wenn die Kontexte first und second OpenGL-Ressourcen gemeinsam nutzen.

bool QOpenGLContext::create()

Versucht, den OpenGL-Kontext mit der aktuellen Konfiguration zu erstellen.

Die aktuelle Konfiguration umfasst das Format, den Freigabekontext und den Bildschirm.

Wenn die OpenGL-Implementierung auf Ihrem System die angeforderte Version des OpenGL-Kontextes nicht unterstützt, versucht QOpenGLContext, die am besten passende Version zu erstellen. Die tatsächlich erstellten Kontexteigenschaften können mit QSurfaceFormat abgefragt werden, das von der Funktion format() zurückgegeben wird. Wenn Sie zum Beispiel einen Kontext anfordern, der das OpenGL 4.3 Core-Profil unterstützt, der Treiber und/oder die Hardware aber nur Kontexte der Version 3.2 Core-Profil unterstützt, erhalten Sie einen Kontext mit dem Profil 3.2 Core.

Gibt true zurück, wenn der native Kontext erfolgreich erstellt wurde und bereit ist, mit makeCurrent(), swapBuffers(), usw. verwendet zu werden.

Siehe auch makeCurrent() und format().

[static] QOpenGLContext *QOpenGLContext::currentContext()

Gibt den letzten Kontext zurück, der makeCurrent im aktuellen Thread aufgerufen hat, oder nullptr, wenn kein Kontext aktuell ist.

GLuint QOpenGLContext::defaultFramebufferObject() const

Rufen Sie dies auf, um das Standard-Framebuffer-Objekt für die aktuelle Oberfläche zu erhalten.

Auf einigen Plattformen (z.B. iOS) hängt das Standard-Framebuffer-Objekt von der Oberfläche ab, auf der gerendert wird, und kann sich von 0 unterscheiden. Anstatt glBindFramebuffer(0) aufzurufen, sollten Sie daher glBindFramebuffer(ctx->defaultFramebufferObject()) aufrufen, wenn Ihre Anwendung auf verschiedenen Qt-Plattformen funktionieren soll.

Wenn Sie glBindFramebuffer() in QOpenGLFunctions verwenden, müssen Sie sich darüber keine Gedanken machen, da es automatisch das defaultFramebufferObject() des aktuellen Kontexts bindet, wenn 0 übergeben wird.

Siehe auch QOpenGLFramebufferObject.

void QOpenGLContext::doneCurrent()

Convenience-Funktion zum Aufruf von makeCurrent mit einer 0-Oberfläche.

Dies führt dazu, dass im aktuellen Thread kein Kontext vorhanden ist.

Siehe auch makeCurrent() und currentContext().

QSet<QByteArray> QOpenGLContext::extensions() const

Gibt die Menge der OpenGL-Erweiterungen zurück, die von diesem Kontext unterstützt werden.

Der Kontext oder ein gemeinsamer Kontext muss aktuell sein.

Siehe auch hasExtension().

QOpenGLExtraFunctions *QOpenGLContext::extraFunctions() const

Ruft die Instanz QOpenGLExtraFunctions für diesen Kontext ab.

QOpenGLContext bietet dies als bequeme Möglichkeit, auf QOpenGLExtraFunctions zuzugreifen, ohne es manuell verwalten zu müssen.

Der Kontext oder ein gemeinsamer Kontext muss aktuell sein.

Die zurückgegebene QOpenGLExtraFunctions Instanz ist sofort einsatzbereit und muss nicht mit initializeOpenGLFunctions() aufgerufen werden.

Siehe auch QOpenGLFunctions und QOpenGLExtraFunctions.

QSurfaceFormat QOpenGLContext::format() const

Gibt das Format des zugrunde liegenden Plattformkontexts zurück, wenn create() aufgerufen wurde.

Andernfalls wird das angeforderte Format zurückgegeben.

Das angeforderte und das tatsächliche Format können voneinander abweichen. Die Anforderung einer bestimmten OpenGL-Version bedeutet nicht, dass der resultierende Kontext genau auf die angeforderte Version ausgerichtet ist. Es wird nur garantiert, dass die Kombination aus Version/Profil/Optionen für den erstellten Kontext mit der Anforderung kompatibel ist, solange der Treiber in der Lage ist, einen solchen Kontext bereitzustellen.

Zum Beispiel kann die Anforderung eines OpenGL Version 3.x Kernprofilkontextes zu einem OpenGL 4.x Kernprofilkontext führen. In ähnlicher Weise kann eine Anforderung für OpenGL 2.1 zu einem OpenGL 3.0-Kontext mit aktivierten veralteten Funktionen führen. Schließlich können je nach Treiber nicht unterstützte Versionen entweder zu einem Fehler bei der Kontexterstellung oder zu einem Kontext für die höchste unterstützte Version führen.

Ähnliche Unterschiede sind bei den Puffergrößen möglich, z.B. kann der resultierende Kontext einen größeren Tiefenpuffer haben als angefordert. Dies ist völlig normal.

Siehe auch setFormat().

QOpenGLFunctions *QOpenGLContext::functions() const

Ruft die Instanz QOpenGLFunctions für diesen Kontext ab.

QOpenGLContext bietet dies als bequeme Möglichkeit, auf QOpenGLFunctions zuzugreifen, ohne es manuell verwalten zu müssen.

Der Kontext oder ein gemeinsamer Kontext muss aktuell sein.

Die zurückgegebene QOpenGLFunctions Instanz ist sofort einsatzbereit und muss nicht mit initializeOpenGLFunctions() aufgerufen werden.

QFunctionPointer QOpenGLContext::getProcAddress(const QByteArray &procName) const

Löst den Funktionszeiger auf eine OpenGL-Erweiterungsfunktion auf, die durch procName

Gibt nullptr zurück, wenn keine solche Funktion gefunden werden kann.

QFunctionPointer QOpenGLContext::getProcAddress(const char *procName) const

Dies ist eine überladene Funktion.

[static] QOpenGLContext *QOpenGLContext::globalShareContext()

Gibt den anwendungsweiten gemeinsamen OpenGL-Kontext zurück, falls vorhanden. Andernfalls wird nullptr zurückgegeben.

Dies ist nützlich, wenn Sie OpenGL-Objekte (Puffer, Texturen, etc.) hochladen müssen, bevor Sie ein QOpenGLWidget oder QQuickWidget erstellen oder anzeigen.

Siehe auch Qt::AA_ShareOpenGLContexts, setShareContext(), und makeCurrent().

bool QOpenGLContext::hasExtension(const QByteArray &extension) const

Gibt true zurück, wenn dieser OpenGL-Kontext den angegebenen OpenGL extension unterstützt, andernfalls false.

Der Kontext oder ein gemeinsamer Kontext muss aktuell sein.

Siehe auch extensions().

bool QOpenGLContext::isOpenGLES() const

Gibt true zurück, wenn der Kontext ein OpenGL ES-Kontext ist.

Wenn der Kontext noch nicht erstellt wurde, basiert das Ergebnis auf dem angeforderten Format, das mit setFormat() festgelegt wurde.

Siehe auch create(), format(), und setFormat().

bool QOpenGLContext::isValid() const

Gibt zurück, ob dieser Kontext gültig ist, d.h. ob er erfolgreich erstellt wurde.

Auf einigen Plattformen zeigt der Rückgabewert von false für einen zuvor erfolgreich erstellten Kontext an, dass der OpenGL-Kontext verloren gegangen ist.

Die typische Art, mit Kontextverlustszenarien in Anwendungen umzugehen, besteht darin, über diese Funktion zu prüfen, wann immer makeCurrent() fehlschlägt und false zurückgibt. Wenn diese Funktion dann false zurückgibt, erstellen Sie den zugrunde liegenden nativen OpenGL-Kontext neu, indem Sie create() aufrufen, rufen Sie makeCurrent() erneut auf und initialisieren Sie dann alle OpenGL-Ressourcen neu.

Auf einigen Plattformen lässt sich ein Kontextverlust nicht vermeiden. Auf anderen Plattformen muss man sich jedoch für diese Situationen entscheiden. Dies kann durch die Aktivierung von ResetNotification in QSurfaceFormat erfolgen. Dies führt dazu, dass RESET_NOTIFICATION_STRATEGY_EXT im zugrunde liegenden nativen OpenGL-Kontext auf LOSE_CONTEXT_ON_RESET_EXT gesetzt wird. QOpenGLContext wird dann den Status über glGetGraphicsResetStatusEXT() in jedem makeCurrent() überwachen.

Siehe auch create().

bool QOpenGLContext::makeCurrent(QSurface *surface)

Macht den Kontext im aktuellen Thread aktuell, gegen den angegebenen surface. Gibt bei Erfolg true zurück, andernfalls false. Letzteres kann passieren, wenn die Oberfläche nicht freigelegt ist oder die Grafikhardware nicht verfügbar ist, weil z.B. die Anwendung angehalten wurde.

Wenn surface gleich nullptr ist, entspricht dies dem Aufruf von doneCurrent().

Vermeiden Sie es, diese Funktion von einem anderen Thread aus aufzurufen als dem, in dem sich die Instanz QOpenGLContext befindet. Wenn du QOpenGLContext von einem anderen Thread aus benutzen willst, solltest du zuerst sicherstellen, dass sie nicht im aktuellen Thread läuft, indem du doneCurrent() aufrufst, falls nötig. Rufen Sie dann moveToThread(otherThread) auf, bevor Sie es im anderen Thread verwenden.

Standardmäßig setzt Qt eine Prüfung ein, die die obige Bedingung der Thread-Affinität erzwingt. Es ist immer noch möglich, diese Prüfung zu deaktivieren, indem man das Attribut Qt::AA_DontCheckOpenGLContextThreadAffinity application setzt. Vergewissern Sie sich, dass Sie die Konsequenzen der Verwendung von QObjects von außerhalb des Threads, in dem sie sich befinden, verstanden haben, wie in der QObject thread affinity Dokumentation erklärt.

Siehe auch functions(), doneCurrent(), und Qt::AA_DontCheckOpenGLContextThreadAffinity.

template <typename QNativeInterface> QNativeInterface *QOpenGLContext::nativeInterface() const

Gibt eine native Schnittstelle des angegebenen Typs für den Kontext zurück.

Diese Funktion bietet Zugriff auf die plattformspezifische Funktionalität von QOpenGLContext, wie im QNativeInterface Namespace definiert:

Wenn die angeforderte Schnittstelle nicht verfügbar ist, wird nullptr zurückgegeben.

[static] QOpenGLContext::OpenGLModuleType QOpenGLContext::openGLModuleType()

Gibt den zugrunde liegenden OpenGL-Implementierungstyp zurück.

Auf Plattformen, auf denen die OpenGL-Implementierung nicht dynamisch geladen wird, wird der Rückgabewert während der Kompilierungszeit bestimmt und ändert sich nie.

QScreen *QOpenGLContext::screen() const

Gibt den Bildschirm zurück, für den der Kontext erstellt wurde.

Siehe auch setScreen().

void QOpenGLContext::setFormat(const QSurfaceFormat &format)

Legt die format fest, mit der der OpenGL-Kontext kompatibel sein soll. Sie müssen create() aufrufen, bevor sie wirksam wird.

Wenn das Format nicht explizit über diese Funktion gesetzt wird, wird das von QSurfaceFormat::defaultFormat() zurückgegebene Format verwendet. Das bedeutet, dass bei mehreren Kontexten die einzelnen Aufrufe dieser Funktion durch einen einzigen Aufruf von QSurfaceFormat::setDefaultFormat() ersetzt werden können, bevor der erste Kontext erstellt wird.

Siehe auch format().

void QOpenGLContext::setScreen(QScreen *screen)

Legt die screen fest, für die der OpenGL-Kontext gültig sein soll. Sie müssen create() aufrufen, bevor es wirksam wird.

Siehe auch screen().

void QOpenGLContext::setShareContext(QOpenGLContext *shareContext)

Lässt diesen Kontext Texturen, Shader und andere OpenGL-Ressourcen mit shareContext gemeinsam nutzen. Sie müssen create() aufrufen, bevor die Funktion wirksam wird.

Siehe auch shareContext().

QOpenGLContext *QOpenGLContext::shareContext() const

Gibt den Freigabekontext zurück, mit dem dieser Kontext erstellt wurde.

Wenn die zugrundeliegende Plattform nicht in der Lage war, die angeforderte Freigabe zu unterstützen, wird hier 0 zurückgegeben.

Siehe auch setShareContext().

QOpenGLContextGroup *QOpenGLContext::shareGroup() const

Gibt die Freigabegruppe zurück, zu der dieser Kontext gehört.

[static] bool QOpenGLContext::supportsThreadedOpenGL()

Gibt true zurück, wenn die Plattform OpenGL-Rendering außerhalb des Haupt-(Gui-)Threads unterstützt.

Der Wert wird durch das verwendete Plattform-Plugin gesteuert und kann auch von den Grafiktreibern abhängen.

QSurface *QOpenGLContext::surface() const

Gibt die Oberfläche zurück, mit der der Kontext aktuell gemacht wurde.

Dies ist die Oberfläche, die als Argument an makeCurrent() übergeben wird.

void QOpenGLContext::swapBuffers(QSurface *surface)

Vertauscht die hinteren und vorderen Puffer von surface.

Rufen Sie diese Funktion auf, um ein OpenGL-Rendering zu beenden, und stellen Sie sicher, dass Sie makeCurrent() erneut aufrufen, bevor Sie weitere OpenGL-Befehle erteilen, zum Beispiel als Teil eines neuen Frames.