QOpenGLTimerQuery Class

成员函数文档

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

使用给定的parent 创建一个QOpenGLTimerQuery实例。使用前，必须先在有效的OpenGL上下文中调用create()。

[virtual noexcept] QOpenGLTimerQuery::~QOpenGLTimerQuery()

销毁QOpenGLTimerQuery 及其底层的OpenGL资源。

void QOpenGLTimerQuery::begin()

在 OpenGL 命令队列中标记一个起始点，用于由该查询对象进行计时的一系列命令。

这适用于简单的用例。通常，最好使用recordTimestamp()。

另请参阅 end()、isResultAvailable()、waitForResult() 和recordTimestamp()。

bool QOpenGLTimerQuery::create()

创建底层的 OpenGL 定时器查询对象。要使此函数成功，当前必须存在一个支持查询对象的有效 OpenGL 上下文。

如果 OpenGL 定时器查询对象创建成功，则返回true 。

void QOpenGLTimerQuery::destroy()

销毁底层的 OpenGL 定时器查询对象。调用此函数时，当前上下文必须与调用create() 时相同的上下文。

void QOpenGLTimerQuery::end()

在 OpenGL 命令队列中标记该查询对象将用于计时的一系列命令的终点。

这适用于简单的用例。通常，最好使用recordTimestamp()。

另请参阅 begin()、isResultAvailable()、waitForResult() 以及recordTimestamp()。

bool QOpenGLTimerQuery::isCreated() const

如果底层的 OpenGL 查询对象已创建，则返回 `true `。如果返回 `true ` 且关联的 OpenGL 上下文是当前的，则可以使用该对象发出查询。

bool QOpenGLTimerQuery::isResultAvailable() const

如果 OpenGL 定时器查询结果已可用，则返回 `true `。

该函数是非阻塞的，理想情况下应在调用waitForResult() 之前使用它来检查查询结果是否可用。

另请参阅 waitForResult()。

GLuint QOpenGLTimerQuery::objectId() const

返回底层 OpenGL 查询对象的 ID。

void QOpenGLTimerQuery::recordTimestamp()

在 OpenGL 命令队列中放置一个标记，以便 GPU 在到达该标记时记录时间戳。该函数是非阻塞的，结果将在稍后时间可用。

可通过 `isResultAvailable()` 检查结果是否可用。可通过 `waitForResult()` 获取结果，若结果尚未可用，该调用将阻塞。

另请参阅 waitForResult()、isResultAvailable()、begin() 以及end()。

GLuint64 QOpenGLTimerQuery::waitForResult() const

返回 OpenGL 定时器查询的结果。

该函数将阻塞，直到 OpenGL 提供结果为止。建议调用 `isResultAvailable()` 以确保结果已就绪，从而避免不必要的阻塞和延迟。

另请参阅 isResultAvailable()。

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

返回 GPU 的当前时间戳，此时所有先前发出的 OpenGL 命令均已接收，但 GPU 未必已执行这些命令。

该函数将阻塞，直到返回结果为止。

另请参阅 recordTimestamp()。