En esta página

QQuickFramebufferObject::Renderer Class

class QQuickFramebufferObject::Renderer

Funciones protegidas

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()

Descripción detallada

La clase ` QQuickFramebufferObject::Renderer ` se utiliza para implementar la lógica de representación de un ` QQuickFramebufferObject`.

Documentación de las funciones de miembro

[protected] Renderer::Renderer()

Crea un nuevo renderizador.

Esta función se invoca durante la fase de sincronización del grafo de escena, cuando el hilo de la interfaz gráfica de usuario está bloqueado.

[virtual noexcept protected] Renderer::~Renderer()

El renderizador se elimina automáticamente cuando se liberan los recursos del grafo de escena del elemento « QQuickFramebufferObject ».

Esta función se invoca en el hilo de renderizado.

[virtual protected] QOpenGLFramebufferObject *Renderer::createFramebufferObject(const QSize &size)

Esta función se invoca cuando se necesita un nuevo FBO. Esto ocurre en el fotograma inicial. Si QQuickFramebufferObject::textureFollowsItemSize está establecido en «true», se vuelve a invocar cada vez que cambian las dimensiones del elemento.

El FBO devuelto puede tener cualquier tipo de adjunto. Si la opción ` QOpenGLFramebufferObjectFormat ` indica que el FBO debe ser multisampleado, la implementación interna del renderizador asignará un segundo FBO y copiará el FBO multisampleado en el FBO utilizado para mostrar la textura.

Nota: Algunos dispositivos presentan problemas con los FBO de tamaño reducido. La propiedad ` size ` tiene esto en cuenta, por lo que hay que tener cuidado al sobrescribir el tamaño con un valor fijo. Un tamaño mínimo de 64x64 debería funcionar siempre.

Nota: size tiene en cuenta la relación de píxeles del dispositivo, lo que significa que ya se multiplica por el factor de escala correcto. Al mover la ventana que contiene el elemento « QQuickFramebufferObject » a una pantalla con una configuración diferente, el FBO se vuelve a crear automáticamente y esta función se invoca con el tamaño correcto.

[protected] QOpenGLFramebufferObject *Renderer::framebufferObject() const

Devuelve el objeto de búfer de fotogramas en el que se está realizando el renderizado en ese momento.

[protected] void Renderer::invalidateFramebufferObject()

Llama a esta función durante ` synchronize()` para invalidar el FBO actual. Esto dará lugar a la creación de un nuevo FBO mediante ` createFramebufferObject()`.

[pure virtual protected] void Renderer::render()

Esta función se invoca cuando se debe renderizar en el FBO. En este momento, el framebuffer ya está vinculado y el « glViewport » se ha configurado para que coincida con el tamaño del FBO.

El FBO se desvinculará automáticamente una vez que la función devuelva un valor.

Nota: Nose debe dar por sentado que el estado de OpenGL esté configurado con los valores predeterminados al invocar esta función, ni que se mantenga entre llamadas. Tanto el renderizador de Qt Quick como el código de renderizado personalizado utilizan el mismo contexto de OpenGL. Esto significa que Quick podría haber modificado el estado antes de invocar esta función.

Nota: Se recomienda llamar a QQuickOpenGLUtils::resetOpenGLState() antes de salir. Esto restablece el estado de OpenGL utilizado por el renderizador Qt Quick y, por lo tanto, evita interferencias debidas a los cambios de estado realizados por el código de renderizado en esta función.

[virtual protected] void Renderer::synchronize(QQuickFramebufferObject *item)

Esta función se invoca como resultado de ` QQuickFramebufferObject::update()`.

Utiliza esta función para actualizar el renderizador con los cambios que se hayan producido en el elemento. item es el elemento que ha instanciado este renderizador. La función se invoca una vez antes de que se cree el FBO.

Por ejemplo, si el elemento tiene una propiedad de color controlada por QML, se debe llamar a ` QQuickFramebufferObject::update()` y utilizar `synchronize()` para copiar el nuevo color en el renderizador, de modo que pueda utilizarse para renderizar el siguiente fotograma.

Esta función es el único lugar en el que es seguro que el renderizador y el elemento lean y escriban en los miembros del otro.

[protected] void Renderer::update()

Llama a esta función cuando sea necesario volver a renderizar el FBO.

Esta función se puede llamar desde ` render()` para forzar que el FBO se vuelva a renderizar antes del siguiente fotograma.

Nota: Esta función debe utilizarse desde dentro del renderizador. Para actualizar el elemento en el hilo de la interfaz gráfica de usuario, utiliza QQuickFramebufferObject::update().

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