Класс QQuickFramebufferObject

Класс QQuickFramebufferObject — это вспомогательный класс для интеграции рендеринга OpenGL с помощью объекта фреймбуфера (FBO) в Qt Quick. Подробнее...

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

Типы public

Свойства

• mirrorVertically : bool
• textureFollowsItemSize : bool

• 24 свойства унаследованы от QQuickItem
• 1 свойство унаследовано от QObject

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

Переопределенные публичные функции

• 101 открытая функция унаследована от QQuickItem
• 34 открытых функции унаследованы от QObject
• 2 открытых функции унаследованы от QQmlParserStatus

Сигналы

• 2 сигнала унаследованы от QQuickItem
• 2 сигнала унаследованы от QObject

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

• 1 открытый слот унаследован от QQuickItem
• 1 открытый слот унаследован от QObject
• 1 открытая переменная унаследована от QObject
• 10 статических открытых членов унаследованы от QObject
• 33 защищенных функций унаследованы от QQuickItem
• 9 защищенных функций унаследованы от QObject
• 2 защищенных переменных унаследованы от QObject

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

Класс QQuickFramebufferObject — это вспомогательный класс для интеграции рендеринга OpenGL с помощью объекта фреймбуфера (FBO) в Qt Quick.

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

Для предотвращения гонок и проблем с чтением/записью из двух нитей важно, чтобы рендерер и элемент никогда не читали или не записывали общие переменные. Общение между элементом и рендерером должно в основном осуществляться через функцию QQuickFramebufferObject::Renderer::synchronize(). Эта функция будет вызвана в нити рендеринга, в то время как нить GUI заблокирована.

Также возможно использование очередей соединений или событий для связи между элементом и рендерером.

И рендерер, и FBO управляются памятью внутри.

Для рендеринга в FBO пользователь должен создать подкласс класса Renderer и переопределить функцию Renderer::render(). Подкласс Renderer возвращается из createRenderer().

Размер FBO по умолчанию адаптируется к размеру элемента. Если предпочтительнее фиксированный размер, установите textureFollowsItemSize в false и верните текстуру по вашему выбору из QQuickFramebufferObject::Renderer::createFramebufferObject().

Начиная с Qt 5.4, класс QQuickFramebufferObject является поставщиком текстур и может использоваться непосредственно в ShaderEffects и других классах, которые используют поставщиков текстур.

См. также Граф сцены — Рендеринг FBO и Граф сцены и рендеринг.

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

QQuickFramebufferObject::QQuickFramebufferObject(QQuickItem *parent = nullptr)

Создаёт новый объект QQuickFramebufferObject с родителем parent.

[pure virtual] QQuickFramebufferObject::Renderer *QQuickFramebufferObject::createRenderer() const

Переопределите эту функцию для создания рендерера, используемого для рендеринга в FBO.

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

[override virtual] bool QQuickFramebufferObject::isTextureProvider() const

Переопределяет функцию QQuickItem::isTextureProvider().

[override virtual] void QQuickFramebufferObject::releaseResources()

Переопределено из QQuickItem::releaseResources.

[override virtual] QSGTextureProvider *QQuickFramebufferObject::textureProvider() const

Переопределено из QQuickItem::textureProvider.