Класс QOpenGLTimeMonitor

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

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

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

• 31 открытые функции унаследованные от QObject

Дополнительные унаследованные члены

• 1 свойство унаследованное от QObject
• 1 открытый слот унаследованный от QObject
• 2 сигналы унаследованные от QObject
• 11 статические открытые члены унаследованные от QObject
• 9 защищенные функции унаследованные от QObject

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

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

Класс QOpenGLTimeMonitor — это удобная оболочка вокруг коллекции объектов запросов таймера OpenGL, используемых для измерения интервалов времени на GPU с необходимой для вашего приложения рендеринга точностью.

Объекты запросов таймера OpenGL запрашиваются последовательно для записи отметки времени GPU в интересующих вас точках вашего кода рендеринга. После того, как результаты всех запросов таймера станут доступны, результаты могут быть извлечены, и QOpenGLTimerMonitor рассчитает для вас записанные интервалы времени.

Типичное использование этого класса — профилирование алгоритмов рендеринга вашего приложения или их настройка в реальном времени для динамической балансировки производительности/качества.

Перед использованием QOpenGLTimeMonitor в вашей функции рендеринга вы должны установить необходимое количество точек выборки, которые вы хотите записать, вызвав setSamples(). Обратите внимание, что измерение N точек выборки даст N-1 интервалов времени. После установки количества точек выборки вызовите функцию create() с допустимым текущим контекстом OpenGL для создания необходимых объектов запроса таймера. Эти шаги обычно выполняются один раз в функции инициализации.

Используйте функцию recordSample() для разграничения блоков кода, содержащих команды OpenGL, которые вы хотите измерить. Вы можете проверить доступность полученных образцов времени и интервалов времени с помощью isResultAvailable(). Вычисленные интервалы времени и исходные образцы отметки времени можно получить с помощью блокирующих функций waitForIntervals() и waitForSamples() соответственно.

После получения результатов и перед началом нового цикла сбора образцов (например, в следующем кадре) убедитесь, что вызывается функция reset(), которая очистит кэшированные результаты и сбросит индекс таймера обратно к первому объекту таймера.

См. также QOpenGLTimerQuery.

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

QOpenGLTimeMonitor::QOpenGLTimeMonitor(QObject *parent = Q_NULLPTR)

Создает экземпляр QOpenGLTimeMonitor с заданным parent. Вы должны вызвать create() с допустимым контекстом OpenGL перед использованием.

См. также setSampleCount() и create().

QOpenGLTimeMonitor::~QOpenGLTimeMonitor()

Удаляет QOpenGLTimeMonitor и все основанные на OpenGL ресурсы.

bool QOpenGLTimeMonitor::create()

Инициализирует sampleCount() объектов запросов таймера OpenGL, которые будут использоваться для отслеживания времени выполнения команд OpenGL между последовательными вызовами recordSample().

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

См. также destroy(), setSampleCount(), и recordSample().

void QOpenGLTimeMonitor::destroy()

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

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

bool QOpenGLTimeMonitor::isCreated() const

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

bool QOpenGLTimeMonitor::isResultAvailable() const

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

См. также waitForSamples() и waitForIntervals().

QVector<GLuint> QOpenGLTimeMonitor::objectIds() const

Возвращает QVector, содержащий идентификаторы объектов запросов таймера OpenGL.

int QOpenGLTimeMonitor::recordSample()

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

См. также setSampleCount(), isResultAvailable(), waitForSamples(), и waitForIntervals().

void QOpenGLTimeMonitor::reset()

Сбрасывает монитор времени, готов к использованию в другом кадре рендеринга. Вызовите это после того, как вы получите предыдущие результаты и перед вызовом recordSample() в первый раз в следующем кадре.

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

int QOpenGLTimeMonitor::sampleCount() const

Возвращает количество точек выборки, которые были запрошены с помощью setSampleCount(). Если create был успешно вызван после setSampleCount(), то возвращаемое значение будет фактическим количеством точек выборки, которые могут быть использованы.

Значение по умолчанию для sample count — 2, что приводит к измерению одного интервала.

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

void QOpenGLTimeMonitor::setSampleCount(int sampleCount)

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

Новое sampleCount должно быть не менее 2.

См. также sampleCount(), create(), и recordSample().

QVector<GLuint64> QOpenGLTimeMonitor::waitForIntervals() const

Возвращает QVector, содержащий интервалы времени, ограниченные вызовами recordSample(). Результирующий вектор будет содержать на один элемент меньше, так как он представляет интервалы между отсчетами, а не сами отсчеты времени.

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

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

QVector<GLuint64> QOpenGLTimeMonitor::waitForSamples() const

Возвращает QVector, содержащий отметки времени GPU, полученные с помощью recordSample().

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

Примечание: Эта функция работает только на системах с OpenGL >=3.3 или расширением ARB_timer_query. Для получения дополнительной информации см. QOpenGLTimerQuery.

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