QOpenGLWindow Class

QSurfaceFormat format;
format.setDepthBufferSize(24);
format.setStencilBufferSize(8);
setFormat(format);

Dokumentation der Member-Funktionen

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

Erstellt ein neues `QOpenGLWindow` mit den angegebenen ` parent ` und ` updateBehavior`.

Siehe auch QOpenGLWindow::UpdateBehavior.

[explicit] QOpenGLWindow::QOpenGLWindow(QOpenGLContext *shareContext, QOpenGLWindow::UpdateBehavior updateBehavior = NoPartialUpdate, QWindow *parent = nullptr)

Erstellt ein neues `QOpenGLWindow` mit den angegebenen Werten für ` parent ` und ` updateBehavior`. Der Kontext des `QOpenGLWindow` wird gemeinsam mit ` shareContext` genutzt.

Siehe auch QOpenGLWindow::UpdateBehavior und shareContext.

[virtual noexcept] QOpenGLWindow::~QOpenGLWindow()

Zerstört die „ QOpenGLWindow “-Instanz und gibt deren Ressourcen frei.

Der Kontext des `OpenGLWindow` wird im Destruktor als aktuell gesetzt, wodurch eine sichere Zerstörung aller untergeordneten Objekte ermöglicht wird, die möglicherweise OpenGL-Ressourcen freigeben müssen, die zu dem von diesem Fenster bereitgestellten Kontext gehören.

Siehe auch makeCurrent.

QOpenGLContext *QOpenGLWindow::context() const

Gibt den von diesem Fenster verwendeten ` QOpenGLContext ` zurück oder ` 0 `, falls dieser noch nicht initialisiert wurde.

GLuint QOpenGLWindow::defaultFramebufferObject() const

Das von diesem Fenster verwendete Framebuffer-Objekt-Handle.

Wenn das Aktualisierungsverhalten auf „ NoPartialUpdate “ gesetzt ist, gibt es kein separates Framebuffer-Objekt. In diesem Fall ist der zurückgegebene Wert die ID des Standard-Framebuffers.

Andernfalls ist der Wert die ID des Framebuffer-Objekts oder „ 0 “, falls dieses noch nicht initialisiert wurde.

void QOpenGLWindow::doneCurrent()

Gibt den Kontext frei.

In den meisten Fällen ist es nicht notwendig, diese Funktion aufzurufen, da das Widget beim Aufruf von ` paintGL()` dafür sorgt, dass der Kontext ordnungsgemäß gebunden und freigegeben wird.

Siehe auch ` makeCurrent()`.

[signal] void QOpenGLWindow::frameSwapped()

Dieses Signal wird ausgegeben, nachdem die möglicherweise blockierende Funktion „ buffer swap “ ausgeführt wurde. Anwendungen, die eine kontinuierliche Neuzeichnung synchron zur vertikalen Bildwiederholfrequenz wünschen, sollten bei Erhalt dieses Signals die Funktion „ update()“ aufrufen. Dies ermöglicht ein deutlich flüssigeres Erlebnis im Vergleich zur herkömmlichen Verwendung von Timern.

QImage QOpenGLWindow::grabFramebuffer()

Gibt eine Kopie des Framebuffers zurück.

[virtual protected] void QOpenGLWindow::initializeGL()

Diese virtuelle Funktion wird einmal vor dem ersten Aufruf von ` paintGL()` oder ` resizeGL()` aufgerufen. Implementieren Sie sie in einer Unterklasse neu.

Diese Funktion sollte alle erforderlichen OpenGL-Ressourcen und den entsprechenden Status einrichten.

Es ist nicht erforderlich, ` makeCurrent()` aufzurufen, da dies bereits beim Aufruf dieser Funktion geschehen ist. Beachten Sie jedoch, dass der Framebuffer – falls der Teilaktualisierungsmodus verwendet wird – zu diesem Zeitpunkt noch nicht verfügbar ist; vermeiden Sie daher, von hier aus Zeichenaufrufe auszuführen. Verschieben Sie solche Aufrufe stattdessen auf ` paintGL()`.

Siehe auch paintGL() und resizeGL().

bool QOpenGLWindow::isValid() const

Gibt „ true “ zurück, wenn die OpenGL-Ressourcen des Fensters, wie beispielsweise der Kontext, erfolgreich initialisiert wurden. Beachten Sie, dass der Rückgabewert immer „ false “ lautet, bis das Fenster sichtbar wird (angezeigt wird).

void QOpenGLWindow::makeCurrent()

Bereitet die Darstellung von OpenGL-Inhalten für dieses Fenster vor, indem der entsprechende Kontext als aktueller Kontext festgelegt und das Framebuffer-Objekt – sofern vorhanden – in diesem Kontext gebunden wird.

In den meisten Fällen ist es nicht erforderlich, diese Funktion aufzurufen, da sie automatisch vor dem Aufruf von ` paintGL()` aufgerufen wird. Sie wird dennoch bereitgestellt, um fortgeschrittene Multithreading-Szenarien zu unterstützen, in denen ein anderer Thread als der GUI- oder Haupt-Thread die Oberfläche oder den Inhalt des Framebuffers aktualisieren möchte. Weitere Informationen zu Themen rund um Threading finden Sie unter QOpenGLContext.

Diese Funktion kann auch dann aufgerufen werden, wenn das zugrunde liegende Plattformfenster bereits zerstört wurde. Das bedeutet, dass es sicher ist, diese Funktion aus dem Destruktor einer Unterklasse von ` QOpenGLWindow ` aufzurufen. Wenn kein natives Fenster mehr vorhanden ist, wird stattdessen eine Offscreen-Oberfläche verwendet. Dies stellt sicher, dass die Bereinigungsvorgänge für OpenGL-Ressourcen im Destruktor immer funktionieren, solange diese Funktion zuerst aufgerufen wird.

Siehe auch „ QOpenGLContext“ , „ context()“, „ paintGL()“ und „ doneCurrent()“.

[override virtual protected] void QOpenGLWindow::paintEvent(QPaintEvent *event)

Umsetzt: ` QPaintDeviceWindow::paintEvent` (`QPaintEvent *event`).

Zeichnet den Handler „ event “. Ruft „ paintGL()“ auf.

Siehe auch paintGL().

[virtual protected] void QOpenGLWindow::paintGL()

Diese virtuelle Funktion wird immer dann aufgerufen, wenn der Fensterinhalt neu gezeichnet werden muss. Implementieren Sie sie in einer Unterklasse neu.

Es ist nicht erforderlich, ` makeCurrent()` aufzurufen, da dies bereits beim Aufruf dieser Funktion geschehen ist.

Vor dem Aufruf dieser Funktion werden der Kontext und der Framebuffer (falls vorhanden) gebunden, und der Viewport wird durch einen Aufruf von `glViewport()` eingerichtet. Es wird kein weiterer Status gesetzt, und das Framework führt weder ein Löschen noch ein Zeichnen durch.

Siehe auch initializeGL(), resizeGL(), paintUnderGL(), paintOverGL() und UpdateBehavior.

[virtual protected] void QOpenGLWindow::paintOverGL()

Diese virtuelle Funktion wird nach jedem Aufruf von ` paintGL()` aufgerufen.

Wenn der Aktualisierungsmodus auf ` NoPartialUpdate` gesetzt ist, gibt es keinen Unterschied zwischen dieser Funktion und ` paintGL()`; das Rendern in beiden Fällen führt zum gleichen Ergebnis.

Wie bei ` paintUnderGL()` erfolgt das Rendern in dieser Funktion unabhängig vom Aktualisierungsverhalten auf den Standard-Framebuffer des Fensters. Sie wird aufgerufen, nachdem ` paintGL()` zurückgegeben wurde und das Blit (PartialUpdateBlit) oder das Zeichnen von Quads (PartialUpdateBlend) abgeschlossen ist.

Siehe auch paintGL(), paintUnderGL() und UpdateBehavior.

[virtual protected] void QOpenGLWindow::paintUnderGL()

Die virtuelle Funktion wird vor jedem Aufruf von ` paintGL()` aufgerufen.

Wenn der Aktualisierungsmodus auf „ NoPartialUpdate “ gesetzt ist, gibt es keinen Unterschied zwischen dieser Funktion und „ paintGL()“; das Rendern in beiden Fällen führt zum gleichen Ergebnis.

Der Unterschied wird deutlich, wenn „ PartialUpdateBlend “ verwendet wird, da dabei ein zusätzliches Framebuffer-Objekt zum Einsatz kommt. In diesem Fall zielt „ paintGL()“ auf dieses zusätzliche Framebuffer-Objekt ab, wodurch dessen Inhalt erhalten bleibt, während „paintUnderGL()“ und „ paintOverGL()“ auf den Standard-Framebuffer abzielen, d. h. direkt auf die Fensteroberfläche, deren Inhalt nach jedem angezeigten Frame verloren geht.

Siehe auch paintGL(), paintOverGL() und UpdateBehavior.

[override virtual protected] void QOpenGLWindow::resizeEvent(QResizeEvent *event)

Implementiert: QWindow::resizeEvent(QResizeEvent *ev).

Handler für die Größenänderung von „ event “. Ruft „ resizeGL()“ auf.

Siehe auch „ resizeGL()“.

[virtual protected] void QOpenGLWindow::resizeGL(int w, int h)

Diese virtuelle Funktion wird immer dann aufgerufen, wenn die Größe des Widgets geändert wurde. Implementieren Sie sie in einer Unterklasse neu. Die neue Größe wird über die Parameter „ w “ und „ h “ übergeben.

Siehe auch ` initializeGL()` und ` paintGL()`.

QOpenGLContext *QOpenGLWindow::shareContext() const

Gibt die „ QOpenGLContext “ zurück, deren Freigabe für die „ QOpenGLContext “ dieses Fensters angefordert wurde.

QOpenGLWindow::UpdateBehavior QOpenGLWindow::updateBehavior() const

Gibt das Aktualisierungsverhalten für diese „ QOpenGLWindow “ zurück.