En esta página

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

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

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.