En esta página

Qt3DRender::QPaintedTextureImage Class

class Qt3DRender::QPaintedTextureImage

Un « QAbstractTextureImage » que se puede escribir a través de QPainter. Más información...

Encabezado: #include <qpaintedtextureimage.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
Heredado de: Qt3DRender::QAbstractTextureImage
Estado: Obsoleta

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

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 objeto `QPaintedTextureImage` permite especificar una imagen de textura (y, por lo tanto, una textura de OpenGL) mediante ` QPainter`. El ancho y la altura de la imagen de textura se pueden especificar mediante las propiedades `width`, `height` o `size`.

Un `QPaintedTextureImage` debe tener una subclase y debe implementarse la función virtual ` paint()`. Cada vez que se llama a ` update()` en el `QPaintedTextureImage`, se invoca la función ` paint()` y se carga la imagen resultante.

El QPaintedTextureImage debe estar asociado a algún QAbstractTexture.

Documentación de propiedades

height : int

Esta propiedad indica 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 de notificación:

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 de notificación:

void sizeChanged(QSize size)

Véase también height y width.

width : int

Esta propiedad indica el ancho de la imagen de textura. El ancho debe ser mayor o igual a 1.

Funciones de acceso:

int width() const
void setWidth(int w)

Señal de notificador:

void widthChanged(int w)

Documentación de las funciones miembro

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

Dibuja 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 de visualización personalizada en el pintor antes de realizar cualquier otra operación de pintura:

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 cambia el tamaño.

Nota: Funciónde configuración para la propiedad height.

Véase 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 cambia la propiedad size.

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

Véase también size().

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

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

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

Véase 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 realizando varios cambios en una textura pintada, te recomendamos que esperes a que se hayan completado todos los cambios antes de llamar a `update`, con el fin de minimizar el número de repintados necesarios.

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.