Класс Renderer
класс QQuickFramebufferObject::RendererЭтот класс был представлен в Qt 5.2.
Защищенные функции
| Renderer() | |
| virtual | ~Renderer() |
| virtual QOpenGLFramebufferObject * | createFramebufferObject(const QSize &size) |
| QOpenGLFramebufferObject * | framebufferObject() const |
| void | invalidateFramebufferObject() |
| virtual void | render() = 0 |
| virtual void | synchronize(QQuickFramebufferObject *item) |
| void | update() |
Подробное описание
Класс QQuickFramebufferObject::Renderer используется для реализации логики отрисовки QQuickFramebufferObject.
Документация по функциям-членам
[protected] Renderer::Renderer()
Создает новый объект рендерера.
Эта функция вызывается во время синхронизации графа сцены, когда поток GUI заблокирован.
[virtual protected] Renderer::~Renderer()
Объект Renderer автоматически удаляется при очистке ресурсов графа сцены для элемента QQuickFramebufferObject.
Эта функция вызывается в потоке отрисовки.
[virtual protected] QOpenGLFramebufferObject *Renderer::createFramebufferObject(const QSize &size)
Эта функция вызывается при необходимости нового FBO. Это происходит на начальном кадре. Если QQuickFramebufferObject::textureFollowsItemSize установлено в true, она вызывается каждый раз при изменении размеров элемента.
Возвращаемый FBO может иметь любые привязки. Если QOpenGLFramebufferObjectFormat указывает, что FBO должен быть многообразным, внутренняя реализация Renderer выделит второй FBO и скопирует многообразный FBO в FBO, используемый для отображения текстуры.
Примечание: Некоторые аппаратные средства имеют проблемы с небольшими размерами FBO. size учитывает это, поэтому будьте осторожны при переопределении размера фиксированным значением. Минимальный размер 64x64 всегда должен работать.
Примечание: size учитывает коэффициент масштабирования пикселей устройства, то есть он уже умножен на правильный коэффициент масштабирования. При перемещении окна, содержащего элемент QQuickFramebufferObject, на экран с другими параметрами, FBO автоматически пересоздается, и эта функция вызывается с правильным размером.
[protected] QOpenGLFramebufferObject *Renderer::framebufferObject() const
Возвращает объект фреймбуфера, в который в данный момент происходит отрисовка.
[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().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qquickframebufferobject-renderer.html
