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

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

可使用isResultAvailable() 检查结果是否可用。可以使用waitForResult() 获取结果，如果结果尚未可用，该函数将阻塞。

另请参见 waitForResult()、isResultAvailable()、begin() 和end()。

GLuint64 QOpenGLTimerQuery::waitForResult() const

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

此函数将阻塞，直到 OpenGL 提供结果。建议调用isResultAvailable() 以确保结果可用，从而避免不必要的阻塞和停滞。

另请参阅 isResultAvailable()。

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

返回 GPU 当前的时间戳，此时所有之前发出的 OpenGL 命令都已接收到，但不一定被 GPU 执行。

此函数会阻塞，直到返回结果。

另请参阅 recordTimestamp().