QOpenGLTimeMonitor 类

成员函数文档

[显式] QOpenGLTimeMonitor::QOpenGLTimeMonitor(QObject *parent = nullptr)

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

另请参阅setSampleCount()和create。

[虚函数，noexcept] QOpenGLTimeMonitor::~QOpenGLTimeMonitor()

销毁QOpenGLTimeMonitor及其底层OpenGL资源。

bool QOpenGLTimeMonitor::create()

实例化sampleCount()个OpenGL计时器查询对象，这些对象将用于跟踪两次调用recordSample()之间执行OpenGL命令所需的时间。

如果OpenGL计时器查询对象可以创建，则返回true。

另请参阅destroy()、setSampleCount()和recordSample。

void QOpenGLTimeMonitor::destroy()

销毁此实例中使用的任何OpenGL计时器查询对象。

另请参阅create。

bool QOpenGLTimeMonitor::isCreated() const

如果底层OpenGL查询对象已创建，则返回true。如果返回true并且相关的OpenGL上下文是活动的，则可以使用此对象记录时间采样。

bool QOpenGLTimeMonitor::isResultAvailable() const

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

另请参阅waitForSamples和waitForIntervals。

QList<GLuint> QOpenGLTimeMonitor::objectIds() const

返回包含OpenGL计时器查询对象对象ID的QList。

int QOpenGLTimeMonitor::recordSample()

在OpenGL命令队列中的此点发出OpenGL计时器查询。在您的应用程序的渲染函数中按顺序调用此函数，将构建出GPU执行OpenGL命令所需时间的详细信息。

另请参阅setSampleCount、isResultAvailable、waitForSamples和waitForIntervals。

void QOpenGLTimeMonitor::reset()

重置时间监控器，以便可以在渲染的另一帧中再次使用。在从下一个帧的第一次调用recordSample()之前，获取上次结果并调用一次此方法。

另请参阅recordSample。

int QOpenGLTimeMonitor::sampleCount() const

返回使用 setSampleCount() 要求的样本点的数量。如果成功调用 setSampleCount() 后创建，则返回的值将是实际可用的样本点数量。

样本点数的默认值为2，表示测量单个区间。

另请参阅 setSampleCount().

void QOpenGLTimeMonitor::setSampleCount(int sampleCount)

将样本点数设置为 sampleCount。使用此函数设置样本数后，必须调用 create() 以实例化底层 OpenGL 计时查询对象。

新的 sampleCount 必须至少为2。

另请参阅 sampleCount()，create() 和 recordSample().

QList<GLuint64> QOpenGLTimeMonitor::waitForIntervals() const

返回一个包含由调用 recordSample() 定义的时区分隔符的 QList。结果向量将包含一个更少的元素，因为它表示间隔而不是实际的时间戳样本。

此函数将在 OpenGL 表明结果可用之前阻塞。建议在调用此函数之前使用 isResultAvailable() 检查结果的可用性。

另请参阅 waitForSamples() 和 isResultAvailable().

QList<GLuint64> QOpenGLTimeMonitor::waitForSamples() const

返回一个包含使用 recordSample() 采集的 GPU 时间戳的 QList。

此函数将在 OpenGL 表明结果可用之前阻塞。建议在调用此函数之前使用 isResultAvailable() 检查结果的可用性。

另请参阅 waitForIntervals() 和 isResultAvailable().