QOpenGLWindow Class

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

Dokumentation der Mitgliedsfunktionen

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

Konstruiert 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)

Konstruiert ein neues QOpenGLWindow mit den angegebenen parent und updateBehavior. Der Kontext des QOpenGLWindow wird mit shareContext geteilt.

Siehe auch QOpenGLWindow::UpdateBehavior und shareContext.

[virtual noexcept] QOpenGLWindow::~QOpenGLWindow()

Zerstört die Instanz QOpenGLWindow und gibt ihre Ressourcen frei.

Der OpenGLWindow-Kontext wird im Destruktor aktuell gemacht, was eine sichere Zerstörung jedes Kindobjekts ermöglicht, das OpenGL-Ressourcen freigeben muss, die zu dem von diesem Fenster bereitgestellten Kontext gehören.

Siehe auch makeCurrent.

QOpenGLContext *QOpenGLWindow::context() const

Rückgabe Die von diesem Fenster verwendete QOpenGLContext oder 0, wenn es noch nicht initialisiert wurde.

GLuint QOpenGLWindow::defaultFramebufferObject() const

Das Handle des Framebuffer-Objekts, das von diesem Fenster verwendet wird.

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

Andernfalls der Wert der ID des Framebuffer-Objekts oder 0, wenn es 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() sicherstellt, dass der Kontext richtig gebunden und freigegeben wird.

Siehe auch makeCurrent().

[signal] void QOpenGLWindow::frameSwapped()

Dieses Signal wird ausgegeben, nachdem die potenziell blockierende buffer swap ausgeführt wurde. Anwendungen, die kontinuierlich und synchron zur vertikalen Aktualisierung neu malen wollen, sollten auf dieses Signal hin ein update() ausgeben. Dies ermöglicht eine viel reibungslosere Erfahrung im Vergleich zur traditionellen 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. Reimplementieren Sie sie in einer Unterklasse.

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

Es besteht keine Notwendigkeit, makeCurrent() aufzurufen, da dies bereits geschehen ist, wenn diese Funktion aufgerufen wird. Beachten Sie jedoch, dass der Framebuffer, falls der partielle Aktualisierungsmodus verwendet wird, zu diesem Zeitpunkt noch nicht verfügbar ist. 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 der Kontext, erfolgreich initialisiert wurden. Beachten Sie, dass der Rückgabewert immer false ist, bis das Fenster offengelegt (angezeigt) wird.

void QOpenGLWindow::makeCurrent()

Bereitet das Rendern von OpenGL-Inhalten für dieses Fenster vor, indem sie den entsprechenden Kontext aktuell macht und das Framebuffer-Objekt, falls vorhanden, an diesen Kontext bindet.

In den meisten Fällen ist es nicht notwendig, diese Funktion aufzurufen, da sie automatisch vor dem Aufruf von paintGL() aufgerufen wird. Sie wird dennoch bereitgestellt, um fortgeschrittene Multi-Thread-Szenarien zu unterstützen, in denen ein anderer Thread als der GUI- oder Haupt-Thread die Oberfläche oder den Framebuffer-Inhalt aktualisieren möchte. Siehe QOpenGLContext für weitere Informationen zu Threading-Problemen.

Diese Funktion kann auch dann aufgerufen werden, wenn das zugrunde liegende Plattformfenster bereits zerstört ist. Das bedeutet, dass es sicher ist, diese Funktion aus dem Destruktor einer QOpenGLWindow Unterklasse aufzurufen. Wenn es kein natives Fenster mehr gibt, wird stattdessen eine Offscreen-Oberfläche verwendet. Dies stellt sicher, dass OpenGL-Ressourcenbereinigungsoperationen 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)

Reimplements: QPaintDeviceWindow::paintEvent(QPaintEvent *event).

Paint event Handler. Ruft paintGL() auf.

Siehe auch paintGL().

[virtual protected] void QOpenGLWindow::paintGL()

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

Es besteht keine Notwendigkeit, makeCurrent() aufzurufen, da dies bereits geschehen ist, wenn diese Funktion aufgerufen wird.

Vor dem Aufruf dieser Funktion werden der Kontext und der Framebuffer, falls vorhanden, gebunden, und das Ansichtsfenster wird durch einen Aufruf von glViewport() eingerichtet. Es wird kein anderer Status gesetzt und es wird kein Löschen oder Zeichnen durch das Framework durchgeführt.

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 eingestellt ist, gibt es keinen Unterschied zwischen dieser Funktion und paintGL(), das Rendering führt in beiden Fällen zum gleichen Ergebnis.

Wie paintUnderGL() zielt das Rendering in dieser Funktion auf den Standard-Framebuffer des Fensters, unabhängig vom Aktualisierungsverhalten. Sie wird aufgerufen, nachdem paintGL() zurückgekehrt ist und das Blit (PartialUpdateBlit) oder Quad-Drawing (PartialUpdateBlend) durchgeführt wurde.

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 eingestellt ist, gibt es keinen Unterschied zwischen dieser Funktion und paintGL(), das Rendering führt in beiden Fällen zum gleichen Ergebnis.

Der Unterschied wird deutlich, wenn PartialUpdateBlend verwendet wird, wo ein zusätzliches Framebuffer-Objekt verwendet wird. Dort zielt paintGL() auf dieses zusätzliche Framebuffer-Objekt, 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)

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

Resize event handler. 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. Reimplementieren Sie sie in einer Unterklasse. Die neue Größe wird in w und h übergeben.

Siehe auch initializeGL() und paintGL().

QOpenGLContext *QOpenGLWindow::shareContext() const

Gibt die QOpenGLContext zurück, die für die QOpenGLContext dieses Fensters freigegeben werden soll.

QOpenGLWindow::UpdateBehavior QOpenGLWindow::updateBehavior() const

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