En esta página

QQuickTextureFactory Class

La clase QQuickTextureFactory ofrece una interfaz para cargar texturas personalizadas desde QML. Más información...

Encabezado: #include <QQuickTextureFactory>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Heredado de: QObject

Funciones públicas

QQuickTextureFactory()
virtual ~QQuickTextureFactory() override
virtual QSGTexture *createTexture(QQuickWindow *window) const = 0
virtual QImage image() const
virtual int textureByteCount() const = 0
virtual QSize textureSize() const = 0

Miembros públicos estáticos

QQuickTextureFactory *textureFactoryForImage(const QImage &image)

Descripción detallada

El objetivo de la fábrica de texturas es proporcionar un marcador de posición para unos datos de imagen que puedan convertirse en una textura de OpenGL.

No es posible crear una textura directamente, ya que rara vez hay un contexto de OpenGL disponible en el hilo encargado de cargar los datos de la imagen.

Documentación de las funciones miembro

QQuickTextureFactory::QQuickTextureFactory()

Crea una fábrica de texturas. Dado que QQuickTextureFactory es una clase abstracta, no se puede instanciar directamente.

[override virtual noexcept] QQuickTextureFactory::~QQuickTextureFactory()

Elimina la fábrica de texturas.

[pure virtual] QSGTexture *QQuickTextureFactory::createTexture(QQuickWindow *window) const

Esta función se invoca en el hilo de renderizado del grafo de escena para crear una instancia de ` QSGTexture ` a partir de la fábrica. ` window ` proporciona el contexto en el que se crea esta textura.

QML almacenará en caché internamente la textura devuelta según sea necesario. Cada llamada a esta función debe devolver una instancia única.

El contexto OpenGL utilizado para el renderizado se vincula al llamar a esta función.

[virtual] QImage QQuickTextureFactory::image() const

Devuelve una versión en imagen de esta textura.

Se desconoce la vida útil de la imagen devuelta, por lo que la implementación debería devolver un objeto independiente de tipo ` QImage`, en lugar de utilizar el constructor ` QImage(uchar *, ...)`.

Esta función no se utiliza habitualmente y se prevé que sea lenta.

[pure virtual] int QQuickTextureFactory::textureByteCount() const

Devuelve el número de bytes de memoria que ocupa la textura.

[static] QQuickTextureFactory *QQuickTextureFactory::textureFactoryForImage(const QImage &image)

Devuelve un objeto ` QQuickTextureFactory ` que contiene el ` image` indicado.

Normalmente se utiliza como función auxiliar en ` QQuickImageResponse::textureFactory`.

[pure virtual] QSize QQuickTextureFactory::textureSize() const

Devuelve el tamaño de la textura. Esta función se invocará desde hilos arbitrarios y no debe depender de un contexto de OpenGL vinculado.

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