Класс QQuickFramebufferObject

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

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

Открытые типы

Свойства

• mirrorVertically : bool
• textureFollowsItemSize : bool

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

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

Переопределённые открытые функции

• 95 открытых функций унаследованы от QQuickItem
• 32 открытых функции унаследованы от QObject
• 2 открытых функции унаследованы от QQmlParserStatus

Сигналы

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

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

• 1 открытый слот унаследован от QQuickItem
• 1 открытый слот унаследован от QObject
• 11 статических открытых членов унаследованы от QObject
• 33 защищённых функций унаследованы от QQuickItem
• 9 защищённых функций унаследованы от 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 = Q_NULLPTR)

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

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

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

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

[virtual] bool QQuickFramebufferObject::isTextureProvider() const

Переопределено из QQuickItem::isTextureProvider().

[virtual] void QQuickFramebufferObject::releaseResources()

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

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

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