QQuickTextureFactory Class
La clase QQuickTextureFactory proporciona una interfaz para cargar texturas personalizadas desde QML. Más...
| Cabecera: | #include <QQuickTextureFactory> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Hereda: | 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 propósito de la fábrica de texturas es proporcionar un marcador de posición para un dato de imagen que pueda ser convertido en una textura OpenGL.
Crear una textura directamente no es posible ya que raramente hay un contexto OpenGL disponible en el hilo que es responsable de cargar los datos de la imagen.
Documentación de las funciones miembro
QQuickTextureFactory::QQuickTextureFactory()
Construye una fábrica de texturas. Dado que QQuickTextureFactory es abstracto, no puede ser instanciado directamente.
[override virtual noexcept] QQuickTextureFactory::~QQuickTextureFactory()
Destruye la fábrica de texturas.
[pure virtual] QSGTexture *QQuickTextureFactory::createTexture(QQuickWindow *window) const
Esta función se ejecuta en el subproceso de renderizado del gráfico 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á internamente en caché 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 cuando se llama a esta función.
[virtual] QImage QQuickTextureFactory::image() const
Devuelve una versión en imagen de esta textura.
La vida útil de la imagen devuelta es desconocida, por lo que la implementación debería devolver un QImage autocontenido , no hacer uso del constructor QImage(uchar *, ...).
Esta función no se utiliza habitualmente y se espera que sea lenta.
[pure virtual] int QQuickTextureFactory::textureByteCount() const
Devuelve el número de bytes de memoria que consume la textura.
[static] QQuickTextureFactory *QQuickTextureFactory::textureFactoryForImage(const QImage &image)
Devuelve un QQuickTextureFactory que contiene el image dado.
Suele utilizarse como ayuda en QQuickImageResponse::textureFactory.
[pure virtual] QSize QQuickTextureFactory::textureSize() const
Devuelve el tamaño de la textura. Esta función será llamada desde hilos arbitrarios y no debe depender de un contexto 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.
