Класс Renderer

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

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

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

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

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

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

[protected] Renderer::Renderer()

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

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

[virtual protected] Renderer::~Renderer()

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

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

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

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

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

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

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

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

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

[protected] void Renderer::invalidateFramebufferObject()

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

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

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

После возврата из функции FBO будет автоматически отвязан.

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

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

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

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

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

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

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

[protected] void Renderer::update()

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

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

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