En esta página

Qt3DRender::QTextureImage Class

class Qt3DRender::QTextureImage

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

ConstanteValorDescripción
Qt3DRender::QTextureImage::None0Aún no se ha iniciado la carga de la imagen de textura.
Qt3DRender::QTextureImage::Loading1Se ha iniciado la carga de la imagen de textura, pero aún no ha finalizado.
Qt3DRender::QTextureImage::Ready2La carga de la imagen de textura ha finalizado.
Qt3DRender::QTextureImage::Error3Se 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:

QUrl source() const
void setSource(const QUrl &source)

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.