QOpenGLWindow Class

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

Documentation des fonctions membres

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

Crée une nouvelle instance de `QOpenGLWindow` avec les paramètres ` parent ` et ` updateBehavior` fournis.

Voir également QOpenGLWindow::UpdateBehavior.

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

Crée une nouvelle instance de `QOpenGLWindow` avec les paramètres ` parent ` et ` updateBehavior` fournis. Le contexte de la `QOpenGLWindow` sera partagé avec ` shareContext`.

Voir également QOpenGLWindow::UpdateBehavior et shareContext.

[virtual noexcept] QOpenGLWindow::~QOpenGLWindow()

Détruit l'instance d'QOpenGLWindow, libérant ainsi ses ressources.

Le contexte de l'OpenGLWindow est rendu actif dans le destructeur, ce qui permet de détruire en toute sécurité tout objet enfant qui pourrait avoir besoin de libérer les ressources OpenGL appartenant au contexte fourni par cette fenêtre.

Voir également makeCurrent.

QOpenGLContext *QOpenGLWindow::context() const

Renvoie l'QOpenGLContext utilisé par cette fenêtre ou 0 s'il n'est pas encore initialisé.

GLuint QOpenGLWindow::defaultFramebufferObject() const

Le descripteur de l'objet framebuffer utilisé par cette fenêtre.

Lorsque le comportement de mise à jour est défini sur « NoPartialUpdate », il n’existe pas d’objet framebuffer distinct. Dans ce cas, la valeur renvoyée correspond à l’ID du framebuffer par défaut.

Sinon, la valeur correspond à l'identifiant de l'objet framebuffer ou à « 0 » s'il n'est pas encore initialisé.

void QOpenGLWindow::doneCurrent()

Libère le contexte.

Dans la plupart des cas, il n'est pas nécessaire d'appeler cette fonction, car le widget s'assure que le contexte est correctement lié et libéré lors de l'appel de ` paintGL()`.

Voir également makeCurrent().

[signal] void QOpenGLWindow::frameSwapped()

Ce signal est émis une fois que l'buffer swap, susceptible de provoquer un blocage, a été effectuée. Les applications qui souhaitent actualiser leur affichage en continu, de manière synchronisée avec le rafraîchissement vertical, doivent appeler la fonction ` update()` à la réception de ce signal. Cela permet d'obtenir une expérience beaucoup plus fluide par rapport à l'utilisation traditionnelle des temporisateurs.

QImage QOpenGLWindow::grabFramebuffer()

Renvoie une copie du tampon d'image.

[virtual protected] void QOpenGLWindow::initializeGL()

Cette fonction virtuelle est appelée une seule fois avant le premier appel à ` paintGL()` ou ` resizeGL()`. Réimplémentez-la dans une sous-classe.

Cette fonction doit initialiser toutes les ressources et tous les états OpenGL requis.

Il n’est pas nécessaire d’appeler ` makeCurrent()` car cela a déjà été fait lors de l’appel de cette fonction. Notez toutefois que le tampon de trame, en cas d’utilisation du mode de mise à jour partielle, n’est pas encore disponible à ce stade ; évitez donc d’émettre des appels de dessin à partir d’ici. Reportez plutôt ces appels à ` paintGL()`.

Voir également paintGL() et resizeGL().

bool QOpenGLWindow::isValid() const

Renvoie « true » si les ressources OpenGL de la fenêtre, telles que le contexte, ont été initialisées avec succès. Notez que la valeur renvoyée est toujours « false » tant que la fenêtre n’est pas exposée (affichée).

void QOpenGLWindow::makeCurrent()

Prépare le rendu du contenu OpenGL pour cette fenêtre en activant le contexte correspondant et en associant l'objet framebuffer, s'il existe, à ce contexte.

Dans la plupart des cas, il n’est pas nécessaire d’appeler cette fonction, car elle est appelée automatiquement avant l’appel de ` paintGL()`. Elle est néanmoins fournie pour prendre en charge des scénarios avancés multithreads dans lesquels un thread autre que le thread de l’interface graphique ou le thread principal peut souhaiter mettre à jour le contenu de la surface ou du framebuffer. Voir QOpenGLContext pour plus d’informations sur les questions liées aux threads.

Cette fonction peut également être appelée lorsque la fenêtre native sous-jacente a déjà été détruite. Cela signifie qu’il est possible d’appeler cette fonction en toute sécurité depuis le destructeur d’une sous-classe de ` QOpenGLWindow `. S’il n’y a plus de fenêtre native, une surface hors écran est utilisée à la place. Cela garantit que les opérations de nettoyage des ressources OpenGL dans le destructeur fonctionneront toujours, à condition que cette fonction soit appelée en premier.

Voir également QOpenGLContext, context(), paintGL() et doneCurrent().

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

Réimplémente : QPaintDeviceWindow::paintEvent(QPaintEvent *event).

Peint le gestionnaire d'event. Appelle paintGL().

Voir également paintGL().

[virtual protected] void QOpenGLWindow::paintGL()

Cette fonction virtuelle est appelée chaque fois que le contenu de la fenêtre doit être redessiné. Réimplémentez-la dans une sous-classe.

Il n’est pas nécessaire d’appeler ` makeCurrent()` car cela a déjà été fait lors de l’appel de cette fonction.

Avant d’invoquer cette fonction, le contexte et le framebuffer, s’il y en a un, sont liés, et la fenêtre d’affichage est configurée par un appel à glViewport(). Aucun autre état n’est défini et aucun effacement ni dessin n’est effectué par le framework.

Voir également initializeGL(), resizeGL(), paintUnderGL(), paintOverGL() et UpdateBehavior.

[virtual protected] void QOpenGLWindow::paintOverGL()

Cette fonction virtuelle est appelée après chaque appel de la fonction ` paintGL()`.

Lorsque le mode de mise à jour est défini sur ` NoPartialUpdate`, il n’y a aucune différence entre cette fonction et ` paintGL()` : le rendu effectué dans l’une ou l’autre donne le même résultat.

Tout comme paintUnderGL(), le rendu effectué dans cette fonction cible le framebuffer par défaut de la fenêtre, quel que soit le comportement de mise à jour. Elle est appelée après le retour de paintGL() et une fois que le blit (PartialUpdateBlit) ou le tracé de quad (PartialUpdateBlend) a été effectué.

Voir également paintGL(), paintUnderGL() et UpdateBehavior.

[virtual protected] void QOpenGLWindow::paintUnderGL()

La fonction virtuelle est appelée avant chaque appel à ` paintGL()`.

Lorsque le mode de mise à jour est défini sur ` NoPartialUpdate`, il n’y a aucune différence entre cette fonction et ` paintGL()` ; le rendu effectué dans l’une ou l’autre conduit au même résultat.

La différence devient significative lors de l’utilisation de ` PartialUpdateBlend`, où un objet framebuffer supplémentaire est utilisé. Dans ce cas, ` paintGL()` cible cet objet framebuffer supplémentaire, qui conserve son contenu, tandis que `paintUnderGL()` et ` paintOverGL()` ciblent le framebuffer par défaut, c’est-à-dire directement la surface de la fenêtre, dont le contenu est perdu après chaque image affichée.

Voir également paintGL(), paintOverGL() et UpdateBehavior.

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

Réimplémente : QWindow::resizeEvent(QResizeEvent *ev).

Redéfinit le gestionnaire d'event. Appelle la fonction resizeGL().

Voir également resizeGL().

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

Cette fonction virtuelle est appelée chaque fois que le widget est redimensionné. Réimplémentez-la dans une sous-classe. La nouvelle taille est transmise via les paramètres ` w ` et ` h`.

Voir également initializeGL() et paintGL().

QOpenGLContext *QOpenGLWindow::shareContext() const

Renvoie l'QOpenGLContext s dont le partage a été demandé avec le ` QOpenGLContext` de cette fenêtre.

QOpenGLWindow::UpdateBehavior QOpenGLWindow::updateBehavior() const

Renvoie le comportement de mise à jour de cet QOpenGLWindow.