En esta página

Qt3DRender::QPaintedTextureImage Class

class Qt3DRender::QPaintedTextureImage

Un QAbstractTextureImage que se puede escribir a través de un QPainter. Más...

Cabecera: #include <QPaintedTextureImage>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Hereda: Qt3DRender::QAbstractTextureImage
Status: Obsoleto

Propiedades

Funciones públicas

int height() const
QSize size() const
void update(const QRect &rect = QRect())
int width() const

Ranuras públicas

void setHeight(int h)
void setSize(QSize size)
void setWidth(int w)

Señales

void heightChanged(int w)
void sizeChanged(QSize size)
void widthChanged(int w)

Funciones protegidas

virtual void paint(QPainter *painter) = 0

Descripción Detallada

Un QPaintedTextureImage proporciona una forma de especificar una imagen de textura (y por tanto una textura OpenGL) a través de un QPainter. La anchura y altura de la imagen de textura puede especificarse a través de las propiedades width y height o size.

Una QPaintedTextureImage debe ser subclasificada y la función virtual paint() implementada. Cada vez que se llama a update() sobre la QPaintedTextureImage, se invoca a la función paint() y se carga la imagen resultante.

El QPaintedTextureImage debe estar unido a algún QAbstractTexture.

Documentación de propiedades

height : int

Esta propiedad contiene la altura de la imagen de textura. La altura debe ser mayor o igual a 1.

Funciones de acceso:

int height() const
void setHeight(int h)

Señal del notificador:

void heightChanged(int w)

size : QSize

Esta propiedad contiene el tamaño de la imagen de textura.

Funciones de acceso:

QSize size() const
void setSize(QSize size)

Señal notificadora:

void sizeChanged(QSize size)

Véase también height y width.

width : int

Esta propiedad contiene el ancho de la imagen de textura. La anchura debe ser mayor o igual a 1.

Funciones de acceso:

int width() const
void setWidth(int w)

Señal notificadora:

void widthChanged(int w)

Documentación de la función miembro

[pure virtual protected] void QPaintedTextureImage::paint(QPainter *painter)

Pinta la imagen de textura con el objeto QPainter especificado painter.

QPainter considera la esquina superior izquierda de una imagen como su origen, mientras que OpenGL considera la esquina inferior izquierda de una textura como su origen. Una forma sencilla de tener en cuenta esta diferencia es establecer una ventana gráfica personalizada en el pintor antes de pintar:

painter->setViewport(0, height(), width(), -height());
...

[slot] void QPaintedTextureImage::setHeight(int h)

Establece la altura (h) de la imagen de textura. Activa una actualización, si el tamaño cambia.

Nota: Función Setter para la propiedad height.

Ver también height().

[slot] void QPaintedTextureImage::setSize(QSize size)

Establece la anchura y la altura de la imagen de textura. Activa una actualización, si el size cambia.

Nota: Función Setter para la propiedad size.

Ver también size().

[slot] void QPaintedTextureImage::setWidth(int w)

Establece el ancho (w) de la imagen de textura. Activa una actualización, si el tamaño cambia.

Nota: Función Setter para la propiedad width.

Ver también width().

void QPaintedTextureImage::update(const QRect &rect = QRect())

Activa inmediatamente la función paint() de la textura pintada, que a su vez carga la nueva imagen en la GPU. Si estás haciendo múltiples cambios a una textura pintada, considera esperar hasta que todos los cambios estén completos antes de llamar a update, para minimizar el número de repintados requeridos.

El parámetro rect no se utiliza actualmente.

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