Класс QQuickFramebufferObject
Класс QQuickFramebufferObject — это вспомогательный класс для интеграции рендеринга OpenGL с помощью объекта буфера кадра (FBO) в Qt Quick. Подробнее...
| Заголовок: | #include <QQuickFramebufferObject> |
| qmake: | QT += quick |
| С: | Qt 5.2 |
| Наследуется от: | QQuickItem |
Этот класс был представлен в Qt 5.2.
Общедоступные типы
| класс | Renderer |
Свойства
- mirrorVertically : bool
- textureFollowsItemSize : bool
Общедоступные функции
| QQuickFramebufferObject(QQuickItem *parent = nullptr) | |
| virtual QQuickFramebufferObject::Renderer * | createRenderer() const = 0 |
| bool | mirrorVertically() const |
| void | setMirrorVertically(bool enable) |
| void | setTextureFollowsItemSize(bool follows) |
| bool | textureFollowsItemSize() const |
Переопределённые общедоступные функции
| virtual bool | isTextureProvider() const override |
| virtual void | releaseResources() override |
| virtual QSGTextureProvider * | textureProvider() const override |
Сигналы
| void | mirrorVerticallyChanged(bool) |
| void | textureFollowsItemSizeChanged(bool) |
Подробное описание
На большинстве платформ рендеринг происходит в отдельном потоке. По этой причине класс 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 и Граф сцены и рендеринг.
Документация по свойствам
mirrorVertically : bool
Это свойство управляет тем, нужно ли зеркально отображать содержимое FBO по вертикали при отрисовке. Это позволяет легко интегрировать сторонний код рендеринга, который не соответствует стандартным ожиданиям.
Значение по умолчанию — false.
Это свойство было добавлено в Qt 5.6.
Функции доступа:
| bool | mirrorVertically() const |
| void | setMirrorVertically(bool enable) |
Сигнал уведомления:
| void | mirrorVerticallyChanged(bool) |
textureFollowsItemSize : bool
Это свойство управляет тем, следует ли размер текстуры FBO размерам элемента QQuickFramebufferObject. Когда это свойство равно false, FBO будет создан только при первом отображении. Если оно установлено в true, FBO будет пересоздан каждый раз при изменении размеров элемента.
Значение по умолчанию — true.
Функции доступа:
| bool | textureFollowsItemSize() const |
| void | setTextureFollowsItemSize(bool follows) |
Сигнал уведомления:
| void | textureFollowsItemSizeChanged(bool) |
Документация по функциям-членам
QQuickFramebufferObject::QQuickFramebufferObject(QQuickItem *parent = nullptr)
Создаёт новый QQuickFramebufferObject с родителем parent.
[pure virtual] QQuickFramebufferObject::Renderer *QQuickFramebufferObject::createRenderer() const
Переопределите эту функцию для создания рендерера, используемого для рендеринга в FBO.
Эта функция будет вызвана в потоке рендеринга, пока поток GUI заблокирован.
[override virtual] bool QQuickFramebufferObject::isTextureProvider() const
Переопределяет: QQuickItem::isTextureProvider() const.
[override virtual] void QQuickFramebufferObject::releaseResources()
Переопределяет: QQuickItem::releaseResources().
[override virtual] QSGTextureProvider *QQuickFramebufferObject::textureProvider() const
Переопределяет: QQuickItem::textureProvider() const.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qquickframebufferobject.html
