Класс QOpenGLTimerQuery

Класс QOpenGLTimerQuery оборачивает объект запроса таймера OpenGL. Подробнее...

Этот класс был представлен в Qt 5.1.

• Список всех членов, включая наследуемые члены

Открытые функции

Подробное описание

Объекты запроса таймера OpenGL — это управляемые OpenGL ресурсы для измерения времени выполнения последовательностей команд OpenGL на GPU.

OpenGL предоставляет различные уровни поддержки запросов таймера в зависимости от версии OpenGL и наличия расширений ARB_timer_query или EXT_timer_query. Поддержка может быть сведена к следующему:

• OpenGL >=3.3 полностью поддерживает все функции запросов таймера.
• OpenGL 3.2 с расширением ARB_timer_query полностью поддерживает все функции запросов таймера.
• OpenGL <=3.2 с расширением EXT_timer_query поддерживает ограниченную функциональность, так как отсчёт времени GPU нельзя запросить. Места, где это влияет на функции, предоставляемые классами Qt, будут выделены в документации функций.
• OpenGL ES 2 (и OpenGL ES 3) не поддерживают запросы таймера OpenGL.

OpenGL представляет время с точностью до 1 наносекунды (1e-9 секунд). Вследствие этого, 32-битные целые числа будут давать только общее возможное время примерно 4 секунды, что несложно превысить при плохо работающих или длительных операциях. Поэтому OpenGL использует 64-битные целочисленные типы для представления времени. Переменная GLuint64 имеет достаточно разрядности, чтобы содержать продолжительность в сотни лет, чего вполне достаточно для потребностей рендеринга в реальном времени.

Как и другие классы Qt OpenGL, QOpenGLTimerQuery имеет функцию create() для создания базового объекта OpenGL. Это позволяет разработчику убедиться, что в момент использования существует допустимый текущий контекст OpenGL.

После создания запросы таймера могут быть выполнены несколькими способами. Самый простой способ — ограничить блок команд вызовами begin() и end(). Это инструктирует OpenGL измерить время, прошедшее от завершения всех команд, выпущенных до begin(), до завершения всех команд, выпущенных до end().

В конце кадра мы можем получить результаты, вызвав waitForResult(). Как следует из названия этой функции, она блокирует выполнение CPU до тех пор, пока OpenGL не сообщит о том, что результат запроса таймера доступен. Чтобы избежать блокировки, вы можете проверить, доступен ли результат запроса, вызвав isResultAvailable(). Обратите внимание, что современные GPU глубоко конвейерны, и результаты запросов могут не стать доступными в течение 1-5 кадров после их отправки.

Обратите внимание, что OpenGL не разрешает вложенность или перекрестное выполнение нескольких запросов таймера с использованием begin() и end(). Использование нескольких запросов таймера и recordTimestamp() позволяет избежать этой проблемы. При использовании recordTimestamp() результат можно получить в какой-либо момент позже, используя isResultAvailable() и waitForResult(). Qt предоставляет удобный класс QOpenGLTimeMonitor, который помогает при использовании нескольких объектов запросов.

См. также QOpenGLTimeMonitor.

Документация по функциям-членам

QOpenGLTimerQuery::QOpenGLTimerQuery(QObject *parent = nullptr)

Создаёт экземпляр QOpenGLTimerQuery с заданным parent. Перед использованием необходимо вызвать create() с допустимым контекстом OpenGL.

[virtual] QOpenGLTimerQuery::~QOpenGLTimerQuery()

Уничтожает QOpenGLTimerQuery и базовый ресурс OpenGL.

void QOpenGLTimerQuery::begin()

Отмечает начальную точку в очереди команд OpenGL для последовательности команд, которые должны быть отмерены этим объектом запроса.

Это полезно для простых случаев использования. Обычно лучше использовать recordTimestamp().

См. также end(), isResultAvailable(), waitForResult() и recordTimestamp().

bool QOpenGLTimerQuery::create()

Создаёт базовый объект запроса таймера OpenGL. Должен быть доступен допустимый контекст OpenGL, поддерживающий объекты запросов, для успешного выполнения этой функции.

Возвращает true если объект запроса таймера OpenGL был успешно создан.

void QOpenGLTimerQuery::destroy()

Уничтожает базовый объект запроса таймера OpenGL. Контекст, который был текущим при вызове create(), должен быть текущим при вызове этой функции.

void QOpenGLTimerQuery::end()

Отмечает конечную точку в очереди команд OpenGL для последовательности команд, которые должны быть отмерены этим объектом запроса.

Это полезно для простых случаев использования. Обычно лучше использовать recordTimestamp().

См. также begin(), isResultAvailable(), waitForResult() и recordTimestamp().

bool QOpenGLTimerQuery::isCreated() const

Возвращает true если базовый объект запроса OpenGL был создан. Если это возвращает true и связанный контекст OpenGL является текущим, то вы можете выполнять запросы с этим объектом.

bool QOpenGLTimerQuery::isResultAvailable() const

Возвращает true если результат запроса таймера OpenGL доступен.

Эта функция неблокирующая и, в идеале, должна использоваться для проверки доступности результата запроса перед вызовом waitForResult().

См. также waitForResult().

GLuint QOpenGLTimerQuery::objectId() const

Возвращает идентификатор базового объекта запроса OpenGL.

void QOpenGLTimerQuery::recordTimestamp()

Помещает маркер в очередь команд OpenGL, чтобы GPU записал отметку времени, когда этот маркер будет достигнут GPU. Эта функция неблокирующая, и результат станет доступным в некоторый момент позже.

Доступность результата можно проверить с помощью isResultAvailable(). Результат можно получить с помощью waitForResult(), которая заблокируется, если результат ещё не доступен.

См. также waitForResult(), isResultAvailable(), begin() и end().

GLuint64 QOpenGLTimerQuery::waitForResult() const

Возвращает результат запроса таймера OpenGL.

Эта функция будет заблокирована до тех пор, пока результат не станет доступным в OpenGL. Рекомендуется вызывать isResultAvailable(), чтобы убедиться, что результат доступен, чтобы избежать ненужной блокировки и задержек.

См. также isResultAvailable().

GLuint64 QOpenGLTimerQuery::waitForTimestamp() const

Возвращает текущую метку времени GPU, когда все ранее выданные команды OpenGL были получены, но не обязательно выполнены GPU.

Эта функция блокируется до тех пор, пока результат не будет возвращен.

См. также recordTimestamp().