En esta página

Qt3DRender::QAbstractTextureImage Class

class Qt3DRender::QAbstractTextureImage

Contiene la información necesaria para crear una imagen de textura OpenGL. Más...

Encabezado: #include <qabstracttextureimage.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
En QML: AbstractTextureImage
Heredado de: Qt3DCore::QNode
Heredado por:

Qt3DRender::QPaintedTextureImage y Qt3DRender::QTextureImage

Estado: Obsoleto

Esta clase está obsoleta. Se desaconseja encarecidamente su uso en código nuevo.

Propiedades

Funciones públicas

QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)
Qt3DRender::QAbstractTexture::CubeMapFace face() const
int layer() const
int mipLevel() const

Ranuras públicas

void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)
void setLayer(int layer)
void setMipLevel(int level)

Señales

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)
void layerChanged(int layer)
void mipLevelChanged(int mipLevel)

Funciones protegidas

virtual Qt3DRender::QTextureImageDataGeneratorPtr dataGenerator() const = 0
void notifyDataGeneratorChanged()

Descripción detallada

QAbstractTextureImage debe utilizarse como medio para proporcionar datos de imagen a un ` QAbstractTexture`. Contiene la información necesaria: nivel de mipmap, capa y cara del cubo, y carga los datos en el lugar adecuado dentro de una textura de OpenGL.

Los datos reales se proporcionan a través de un ` QTextureImageDataGenerator `, que será ejecutado por los trabajos de Aspect en el backend. Se debe crear una subclase de `QAbstractTextureImage` para proporcionar un functor y, en su caso, las propiedades adicionales que este necesite para cargar los datos reales.

Nota: QAbstractTextureImage nunca debe compartirse. Si no se respeta esta regla, cabe esperar fallos del sistema o, en el mejor de los casos, un comportamiento indefinido.

Documentación de las propiedades

face : Qt3DRender::QAbstractTexture::CubeMapFace

Contiene la cara del mapa cúbico de la imagen de textura.

Nota: La caradel mapa cúbico solo tiene significado para TargetCubeMap y TargetCubeMapArray.

Funciones de acceso:

Qt3DRender::QAbstractTexture::CubeMapFace face() const
void setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

Señal de notificación:

void faceChanged(Qt3DRender::QAbstractTexture::CubeMapFace face)

layer : int

Devuelve la capa de la imagen de textura.

Funciones de acceso:

int layer() const
void setLayer(int layer)

Señal de notificación:

void layerChanged(int layer)

mipLevel : int

Almacena el nivel de mipmap de la imagen de textura.

Funciones de acceso:

int mipLevel() const
void setMipLevel(int level)

Señal de notificación:

void mipLevelChanged(int mipLevel)

Documentación de las funciones de miembro

[explicit] QAbstractTextureImage::QAbstractTextureImage(Qt3DCore::QNode *parent = nullptr)

Crea una nueva instancia de `QAbstractTextureImage` con ` parent ` como padre.

[pure virtual protected] Qt3DRender::QTextureImageDataGeneratorPtr QAbstractTextureImage::dataGenerator() const

Implementa este método para devolver la instancia de `QTextureImageDataGeneratorPtr`, que proporcionará los datos de la imagen de textura.

[protected] void QAbstractTextureImage::notifyDataGeneratorChanged()

Activa una actualización del generador de datos que se envía al backend.

[slot] void QAbstractTextureImage::setFace(Qt3DRender::QAbstractTexture::CubeMapFace face)

Establece la cara de la imagen de textura en face. face

Nota: Funciónde asignación para la propiedad face.

Véase también face().

[slot] void QAbstractTextureImage::setLayer(int layer)

Establece la capa de una textura en « layer ». layer

Nota: Funciónde asignación para la propiedad ` layer`.

Véase también layer().

[slot] void QAbstractTextureImage::setMipLevel(int level)

Establece el nivel de mip de una textura en level. level

Nota: Funciónde asignación para la propiedad mipLevel.

Véase también ` mipLevel()`.

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