Qt3DRender::QTextureImage Class
class Qt3DRender::QTextureImageRecoge la información necesaria para crear una imagen de textura OpenGL a partir de una fuente de imagen. Más...
| Encabezado: | #include <qtextureimage.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | TextureImage |
| Heredado de: | Qt3DRender::QAbstractTextureImage |
| Estado: | Obsoleto |
Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.
Tipos públicos
| enum | Status { None, Loading, Ready, Error } |
Propiedades
Funciones públicas
| QTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
| Qt3DRender::QTextureImage::Status | status() const |
Ranuras públicas
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
Señales
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Funciones protegidas
| void | setStatus(Qt3DRender::QTextureImage::Status status) |
Descripción detallada
Contiene la información necesaria (nivel de mipmap, capa, cara del cubo y URL de origen) para cargar los datos en la ubicación adecuada dentro de una textura de OpenGL.
Documentación sobre el tipo de miembro
enum QTextureImage::Status
Esta enumeración especifica los valores de estado para la carga de imágenes de textura.
| Constante | Valor | Descripción |
|---|---|---|
Qt3DRender::QTextureImage::None | 0 | Aún no se ha iniciado la carga de la imagen de textura. |
Qt3DRender::QTextureImage::Loading | 1 | Se ha iniciado la carga de la imagen de textura, pero aún no ha finalizado. |
Qt3DRender::QTextureImage::Ready | 2 | La carga de la imagen de textura ha finalizado. |
Qt3DRender::QTextureImage::Error | 3 | Se ha producido un error al cargar la imagen de textura. |
Documentación de propiedades
mirrored : bool
Esta propiedad especifica si la imagen debe invertirse al cargarse. Se trata de una medida práctica para evitar tener que manipular las imágenes con el fin de que coincidan con el origen de las coordenadas de textura utilizadas por la API de renderizado. Por defecto, esta propiedad está establecida en «true». No tiene ningún efecto cuando se utilizan formatos de textura comprimidos por la GPU.
Advertencia: esta propiedad conlleva una pérdida de rendimiento en tiempo de ejecución al cargar formatos de imagen sin comprimir o comprimidos por la CPU, como PNG. Para evitar esta pérdida de rendimiento, es mejor establecer esta propiedad en «false» y cargar recursos de textura que ya hayan sido invertidos previamente.
Nota: OpenGL especifica el origen de las coordenadas de textura desde la esquina inferior izquierda, mientras que DirectX utiliza la esquina superior izquierda.
Nota: Al utilizar texturas de mapa cúbico, probablemente querrás desactivar el reflejo, ya que el muestreador de mapa cúbico toma una dirección en lugar de coordenadas de textura normales.
Funciones de acceso:
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
Señal de notificación:
| void | mirroredChanged(bool mirrored) |
source : QUrl
Esta propiedad contiene la URL de origen desde la que se cargarán los datos de la imagen de textura.
Funciones de acceso:
Señal de notificación:
| void | sourceChanged(const QUrl &source) |
[read-only] status : Status
Esta propiedad indica el estado de la carga de la imagen de textura.
- TextureImage.None
- TextureImage.Loading
- TextureImage.Ready
- TextureImage.Error
Funciones de acceso:
| Qt3DRender::QTextureImage::Status | status() const |
Señal del notificador:
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Documentación de las funciones de miembro
[explicit] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
Crea una nueva instancia de ` Qt3DRender::QTextureImage ` con ` parent ` como padre.
bool QTextureImage::isMirrored() const
Devuelve si la duplicación está activada o no.
Nota: Funcióngetter para la propiedad « mirrored ».
[slot] void QTextureImage::setMirrored(bool mirrored)
Configura la sincronización con mirrored.
Nota: Esto activa internamente una llamada para actualizar el generador de datos.
Nota: Funciónde asignación para la propiedad mirrored.
Véase también isMirrored().
[slot] void QTextureImage::setSource(const QUrl &source)
Establece la URL de origen de la imagen de textura en source.
Nota: Esto activa internamente una llamada para actualizar el generador de datos.
Nota: Funciónde asignación para la propiedad source.
Véase también source().
[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
Establece el estado en « status ». estado
Véase también status().
QUrl QTextureImage::source() const
Devuelve la URL de origen desde la que se cargarán los datos de la imagen de textura.
Nota: Funcióngetter para la propiedad source.
Véase también ` setSource()`.
Qt3DRender::QTextureImage::Status QTextureImage::status() const
Devuelve el estado actual.
Nota: Funcióngetter para la propiedad «status».
Véase también setStatus().
© 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.