QOpenGLTimerQuery Class

Documentation sur les fonctions membres

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

Crée une instance de `QOpenGLTimerQuery` avec l'parent` spécifiée. Vous devez appeler la fonction ` create()` avec un contexte OpenGL valide avant de l'utiliser.

[virtual noexcept] QOpenGLTimerQuery::~QOpenGLTimerQuery()

Supprime l'QOpenGLTimerQuery e et la ressource OpenGL sous-jacente.

void QOpenGLTimerQuery::begin()

Marque le point de départ dans la file d'attente des commandes OpenGL d'une séquence de commandes dont la synchronisation doit être gérée par cet objet de requête.

Cette fonction est utile pour des cas d'utilisation simples. En général, il est préférable d'utiliser ` recordTimestamp()`.

Voir également end(), isResultAvailable(), waitForResult() et recordTimestamp().

bool QOpenGLTimerQuery::create()

Crée l'objet de requête de temporisateur OpenGL sous-jacent. Pour que cette fonction aboutisse, un contexte OpenGL valide prenant en charge les objets de requête doit être actif.

Renvoie « true » si l'objet de requête de minuterie OpenGL a été créé avec succès.

void QOpenGLTimerQuery::destroy()

Détruit l'objet de requête de temporisateur OpenGL sous-jacent. Le contexte qui était actif lors de l'appel de la fonction create() doit être actif lors de l'appel de cette fonction.

void QOpenGLTimerQuery::end()

Marque le point final dans la file d'attente des commandes OpenGL pour une séquence de commandes dont la durée doit être mesurée par cet objet de requête.

Cette fonction est utile pour des cas d'utilisation simples. En général, il est préférable d'utiliser ` recordTimestamp()`.

Voir également begin(), isResultAvailable(), waitForResult() et recordTimestamp().

bool QOpenGLTimerQuery::isCreated() const

Renvoie ` true ` si l'objet de requête OpenGL sous-jacent a été créé. Si cette fonction renvoie ` true ` et que le contexte OpenGL associé est actif, vous pouvez alors envoyer des requêtes à l'aide de cet objet.

bool QOpenGLTimerQuery::isResultAvailable() const

Renvoie ` true ` si le résultat de la requête de temporisation OpenGL est disponible.

Cette fonction est non bloquante et devrait idéalement être utilisée pour vérifier la disponibilité du résultat de la requête avant d'appeler waitForResult().

Voir également waitForResult().

GLuint QOpenGLTimerQuery::objectId() const

Renvoie l'identifiant de l'objet de requête OpenGL sous-jacent.

void QOpenGLTimerQuery::recordTimestamp()

Place un marqueur dans la file d'attente des commandes OpenGL afin que le GPU enregistre l'horodatage lorsque ce marqueur est atteint par le GPU. Cette fonction est non bloquante et le résultat sera disponible ultérieurement.

La disponibilité du résultat peut être vérifiée à l'aide de ` isResultAvailable()`. Le résultat peut être récupéré à l'aide de ` waitForResult()`, qui bloquera l'exécution si le résultat n'est pas encore disponible.

Voir également waitForResult(), isResultAvailable(), begin() et end().

GLuint64 QOpenGLTimerQuery::waitForResult() const

Renvoie le résultat de l'interrogation du minuteur OpenGL.

Cette fonction se met en attente jusqu’à ce que le résultat soit mis à disposition par OpenGL. Il est recommandé d’appeler la fonction ` isResultAvailable()` pour s’assurer que le résultat est disponible, afin d’éviter tout blocage ou ralentissement inutile.

Voir également isResultAvailable().

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

Renvoie l'horodatage actuel du GPU lorsque toutes les commandes OpenGL émises précédemment ont été reçues par le GPU, mais n'ont pas nécessairement été exécutées par celui-ci.

Cette fonction reste bloquée jusqu’à ce que le résultat soit renvoyé.

Voir également recordTimestamp().