Класс QQuickFramebufferObject

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

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

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

Свойства

• mirrorVertically : bool
• textureFollowsItemSize : bool

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

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

Сигналы

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

Предупреждение: Этот класс функционален только при рендеринге Qt Quick через OpenGL. Он не совместим с другими графическими API, такими как Vulkan или Metal. Он должен рассматриваться как устаревший класс, который присутствует только для обеспечения работы приложений Qt 5 без разрывов совместимости исходного кода, пока они привязаны к OpenGL.

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

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

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

И рендерер, и 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.

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

[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.