Qt3DRender::QTextureImage Class
class Qt3DRender::QTextureImageEncapsula la información necesaria para crear una imagen de textura OpenGL a partir de una fuente de imagen. Más...
| Cabecera: | #include <QTextureImage> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake: | QT += 3drender |
| En QML: | TextureImage |
| Hereda: | Qt3DRender::QAbstractTextureImage |
| Status: | Obsoleto |
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 mipmap nivel, capa, cara del cubo y URL de origen para cargar en el lugar adecuado los datos en una textura OpenGL.
Tipo de Miembro Documentación
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 | La carga de la imagen de textura aún no se ha iniciado. |
Qt3DRender::QTextureImage::Loading | 1 | La carga de la imagen de textura ha comenzado, pero no ha finalizado. |
Qt3DRender::QTextureImage::Ready | 2 | La carga de la imagen de textura ha finalizado. |
Qt3DRender::QTextureImage::Error | 3 | La carga de la imagen de textura se ha enfrentado a un error. |
Documentación de propiedades
mirrored : bool
Esta propiedad especifica si la imagen debe reflejarse cuando se carga. Esto es conveniente para evitar tener que manipular las imágenes para que coincidan con el origen de las coordenadas de textura utilizadas por la API de renderizado. Por defecto, esta propiedad está establecida en true. Esto no tiene efecto cuando se utilizan formatos de textura comprimidos por la GPU.
Advertencia: Esta propiedad resulta en un precio de rendimiento pagado en tiempo de ejecución cuando se cargan formatos de imagen sin comprimir o comprimidos por la CPU como PNG. Para evitar este coste de rendimiento es mejor establecer esta propiedad a false y cargar activos de textura que hayan sido pre-mirrorizados.
Nota: OpenGL especifica el origen de las coordenadas de textura desde la esquina inferior izquierda, mientras que DirectX utiliza la esquina superior izquierda.
Nota: Cuando utilices 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 las coordenadas regulares de la textura.
Funciones de acceso:
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
Señal notificadora:
| void | mirroredChanged(bool mirrored) |
source : QUrl
Esta propiedad contiene la url de origen desde la que se cargarán los datos para la imagen de textura.
Funciones de acceso:
Señal del notificador:
| void | sourceChanged(const QUrl &source) |
[read-only] status : Status
Esta propiedad contiene el estado de carga de la imagen de textura.
- TextureImageNinguno
- TextureImageCargando
- TextureImageListo
- TextureImageError
Funciones de acceso:
| Qt3DRender::QTextureImage::Status | status() const |
Señal de notificador:
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Documentación de funciones miembro
[explicit] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
Construye una nueva instancia de Qt3DRender::QTextureImage con parent como padre.
bool QTextureImage::isMirrored() const
Devuelve si la réplica está activada o no.
Nota: Función Getter para la propiedad mirrored.
[slot] void QTextureImage::setMirrored(bool mirrored)
Establece el reflejo en mirrored.
Nota: Esto activa internamente una llamada para actualizar el generador de datos.
Nota: Función Setter 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ón Setter para la propiedad source.
Véase también source().
[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
Establece el estado a status. status
Véase también status().
QUrl QTextureImage::source() const
Devuelve la url de origen desde la que se cargarán los datos para la imagen de textura.
Nota: Función getter para la propiedad source.
Véase también setSource().
Qt3DRender::QTextureImage::Status QTextureImage::status() const
Devuelve el estado actual.
Nota: Función Getter para el estado de la propiedad.
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.
