Класс Renderer

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

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

Защищенные функции

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

Класс QQuickFramebufferObject::Renderer используется для реализации логики отрисовки объекта QQuickFramebufferObject.

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

[protected] Renderer::Renderer()

Создает новый рендерер.

Эта функция вызывается во время синхронизации графа сцены, когда поток GUI заблокирован.

[virtual protected] Renderer::~Renderer()

Рендерер автоматически удаляется при очистке ресурсов графа сцены для элемента QQuickFramebufferObject.

Эта функция вызывается в потоке отрисовки.

[virtual protected] QOpenGLFramebufferObject *Renderer::createFramebufferObject(const QSize &size)

Эта функция вызывается, когда требуется новый ФБО. Это происходит на начальном кадре. Если QQuickFramebufferObject::textureFollowsItemSize установлено в true, она вызывается каждый раз, когда изменяются размеры элемента.

Возвращаемый ФБО может иметь любые привязки. Если QOpenGLFramebufferObjectFormat указывает, что ФБО должен быть многообразцовым, внутренняя реализация рендерера выделит второй ФБО и скопирует многообразцовый ФБО в ФБО, используемый для отображения текстуры.

Примечание: Некоторые аппаратные средства имеют проблемы с небольшими размерами ФБО. size учитывает это, поэтому будьте осторожны при переопределении размера фиксированным значением. Минимальный размер 64x64 всегда должен работать.

Примечание: size учитывает коэффициент масштаба пикселей устройства, что означает, что он уже умножен на правильный коэффициент масштабирования. При перемещении окна, содержащего элемент QQuickFramebufferObject, на экран с другими настройками ФБО автоматически пересоздаётся, и эта функция вызывается с правильным размером.

[protected] QOpenGLFramebufferObject *Renderer::framebufferObject() const

Возвращает объект буфера кадра, в который в данный момент выполняется отрисовка.

[protected] void Renderer::invalidateFramebufferObject()

Вызовите эту функцию во время synchronize(), чтобы аннулировать текущий ФБО. Это приведет к созданию нового ФБО с помощью createFramebufferObject().

[pure virtual protected] void Renderer::render()

Эта функция вызывается, когда ФБО должен быть отрисован. В этот момент буфер кадра привязывается, и glViewport настроен в соответствии с размером ФБО.

ФБО будет автоматически отвязан после возвращения из функции.

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

Примечание: Рекомендуется вызывать QQuickOpenGLUtils::resetOpenGLState() перед возвратом. Это сбрасывает состояние OpenGL, используемое рендерером Qt Quick, и, таким образом, предотвращает конфликты со состояниями, изменёнными кодом отрисовки в этой функции.

[virtual protected] void Renderer::synchronize(QQuickFramebufferObject *item)

Эта функция вызывается в результате QQuickFramebufferObject::update().

Используйте эту функцию для обновления рендерера с изменениями, произошедшими в элементе. item — это элемент, который создал этот рендерер. Функция вызывается один раз перед созданием ФБО.

Например, если элемент имеет свойство цвета, которое контролируется QML, следует вызвать QQuickFramebufferObject::update() и использовать synchronize(), чтобы скопировать новое значение цвета в рендерер, чтобы он мог быть использован для отрисовки следующего кадра.

Эта функция — единственное место, где рендереру и элементу безопасно читать и записывать члены друг друга.

[protected] void Renderer::update()

Вызовите эту функцию, когда ФБО должен быть отрисован снова.

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

Примечание: Эта функция должна использоваться внутри рендерера. Для обновления элемента в потоке GUI используйте QQuickFramebufferObject::update().