QQuickFramebufferObject Class
La clase `QQuickFramebufferObject` es una clase de utilidad que permite integrar el renderizado OpenGL mediante un objeto de búfer de fotogramas (FBO) c Qt Quick. Más información...
| Encabezado: | #include <QQuickFramebufferObject> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Heredado de: | QQuickItem |
Tipos públicos
| class | Renderer |
Propiedades
- mirrorVertically : bool
- textureFollowsItemSize : bool
Funciones públicas
| QQuickFramebufferObject(QQuickItem *parent = nullptr) | |
| virtual QQuickFramebufferObject::Renderer * | createRenderer() const = 0 |
| bool | mirrorVertically() const |
| void | setMirrorVertically(bool enable) |
| void | setTextureFollowsItemSize(bool follows) |
| bool | textureFollowsItemSize() const |
Funciones públicas reimplementadas
| virtual bool | isTextureProvider() const override |
| virtual void | releaseResources() override |
| virtual QSGTextureProvider * | textureProvider() const override |
Señales
| void | mirrorVerticallyChanged(bool) |
| void | textureFollowsItemSizeChanged(bool) |
Descripción detallada
Advertencia: Esta clase solo funciona cuando Qt Quick realiza el renderizado a través de OpenGL. No es compatible con otras API gráficas, como Vulkan o Metal. Debe considerarse una clase heredada que solo está presente para permitir que las aplicaciones de Qt 5 funcionen sin problemas de compatibilidad de código fuente, siempre y cuando se vinculen a OpenGL.
En la mayoría de las plataformas, el renderizado se realizará en un hilo dedicado. Por este motivo, la clase `QQuickFramebufferObject` impone una separación estricta entre la implementación de los elementos y el renderizado del FBO. Toda la lógica del elemento, como las propiedades y las funciones auxiliares relacionadas con la interfaz de usuario que necesita QML, debe ubicarse en una subclase de la clase `QQuickFramebufferObject`. Todo lo relacionado con el renderizado debe ubicarse en la clase ` QQuickFramebufferObject::Renderer `.
Para evitar condiciones de carrera y problemas de lectura/escritura entre dos subprocesos, es importante que el renderizador y el elemento nunca lean ni escriban en variables compartidas. La comunicación entre el elemento y el renderizador debe realizarse principalmente a través de la función ` QQuickFramebufferObject::Renderer::synchronize()`. Esta función se llamará en el subproceso de renderizado mientras el subproceso de la interfaz gráfica de usuario está bloqueado.
También es posible utilizar conexiones en cola o eventos para la comunicación entre el elemento y el renderizador.
Tanto el renderizador como el FBO se gestionan internamente en memoria.
Para renderizar en el FBO, el usuario debe crear una subclase de la clase «Renderer» y reimplementar su función ` Renderer::render()`. La subclase de «Renderer» se devuelve desde ` createRenderer()`.
El tamaño del FBO se adaptará por defecto al tamaño del elemento. Si se prefiere un tamaño fijo, establezca ` textureFollowsItemSize ` en ` false ` y devuelva una textura de su elección mediante ` QQuickFramebufferObject::Renderer::createFramebufferObject()`.
A partir de Qt 5.4, la clase `QQuickFramebufferObject` es un ` texture provider ` y se puede utilizar directamente en ` ShaderEffects ` y otras clases que utilicen proveedores de texturas.
Véase también «Grafo de escena»y «Renderizado».
Documentación de propiedades
mirrorVertically : bool
Esta propiedad controla si el tamaño del contenido del FBO debe reflejarse verticalmente al dibujar. Esto permite integrar fácilmente código de renderizado de terceros que no se ajuste a las expectativas estándar.
El valor predeterminado es false.
Funciones de acceso:
| bool | mirrorVertically() const |
| void | setMirrorVertically(bool enable) |
Señal del notificador:
| void | mirrorVerticallyChanged(bool) |
textureFollowsItemSize : bool
Esta propiedad controla si el tamaño de la textura del FBO debe ajustarse a las dimensiones del elemento QQuickFramebufferObject. Cuando esta propiedad tiene el valor «false», el FBO se creará la primera vez que se muestre. Si se establece en «true», el FBO se volverá a crear cada vez que cambien las dimensiones del elemento.
El valor por defecto es « true ».
Funciones de acceso:
| bool | textureFollowsItemSize() const |
| void | setTextureFollowsItemSize(bool follows) |
Señal de notificación:
| void | textureFollowsItemSizeChanged(bool) |
Documentación de las funciones de miembro
QQuickFramebufferObject::QQuickFramebufferObject(QQuickItem *parent = nullptr)
Crea un nuevo objeto `QQuickFramebufferObject` cuyo padre es ` parent`.
[pure virtual] QQuickFramebufferObject::Renderer *QQuickFramebufferObject::createRenderer() const
Reimplementa esta función para crear un renderizador que se utilice para renderizar en el FBO.
Esta función se llamará en el hilo de renderizado mientras el hilo de la interfaz gráfica de usuario esté bloqueado.
[override virtual] bool QQuickFramebufferObject::isTextureProvider() const
Reimplementa: ` QQuickItem::isTextureProvider()` const.
[override virtual] void QQuickFramebufferObject::releaseResources()
Reimplementa: QQuickItem::releaseResources().
[override virtual] QSGTextureProvider *QQuickFramebufferObject::textureProvider() const
Reimplementa: ` QQuickItem::textureProvider()` const.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.