QQuickFramebufferObject Class

Descripción detallada

En la mayoría de las plataformas, el renderizado ocurrirá en un hilo dedicado. Por esta razón, la clase QQuickFramebufferObject impone una estricta separación entre la implementación del ítem y el renderizado del FBO. Toda la lógica del elemento, como las propiedades y las funciones de ayuda relacionadas con la interfaz de usuario que necesita QML, deben ubicarse en una subclase de la clase QQuickFramebufferObject. Todo lo relacionado con el renderizado debe ubicarse en la clase QQuickFramebufferObject::Renderer.

Para evitar race conditions y problemas de lectura/escritura desde dos hilos es importante que el renderizador y el item nunca lean o escriban variables compartidas. La comunicación entre el item y el renderizador debe realizarse principalmente a través de la función QQuickFramebufferObject::Renderer::synchronize(). Esta función será llamada en el hilo de renderizado mientras el hilo GUI está bloqueado.

También es posible utilizar conexiones en cola o eventos para la comunicación entre el item y el renderizador.

Tanto el Renderizador como el FBO son gestionados internamente.

Para renderizar en el FBO, el usuario debe subclasificar la clase Renderer y reimplementar su función Renderer::render(). La subclase 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 a false y devuelva una textura de su elección desde QQuickFramebufferObject::Renderer::createFramebufferObject().

A partir de Qt 5.4, la clase QQuickFramebufferObject es un texture provider y puede utilizarse directamente en ShaderEffects y otras clases que consumen proveedores de texturas.