Qt3DRender::QPaintedTextureImage Class
class Qt3DRender::QPaintedTextureImageUn « QAbstractTextureImage » que l'on peut écrire via QPainter. En savoir plus...
| En-tête : | #include <qpaintedtextureimage.h> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender) target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| Hérite de : | Qt3DRender::QAbstractTextureImage |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
Fonctions publiques
Emplacements publics
Signaux
| void | heightChanged(int w) |
| void | sizeChanged(QSize size) |
| void | widthChanged(int w) |
Fonctions protégées
| virtual void | paint(QPainter *painter) = 0 |
Description détaillée
Un objet QPaintedTextureImage permet de spécifier une image de texture (et donc une texture OpenGL) via une fonction QPainter. La largeur et la hauteur de l'image de texture peuvent être spécifiées via les propriétés width, height ou size.
Un QPaintedTextureImage doit être sous-classé et la fonction virtuelle ` paint()` doit être implémentée. Chaque fois que ` update()` est appelé sur le QPaintedTextureImage, la fonction ` paint()` est invoquée et l’image résultante est chargée.
Le QPaintedTextureImage doit être associé à une instance de QAbstractTexture.
Documentation des propriétés
height : int
Cette propriété indique la hauteur de l'image de texture. La hauteur doit être supérieure ou égale à 1.
Fonctions d'accès :
| int | height() const |
| void | setHeight(int h) |
Signal de notification :
| void | heightChanged(int w) |
size : QSize
Cette propriété indique la taille de l'image de texture.
Fonctions d'accès :
| QSize | size() const |
| void | setSize(QSize size) |
Signal de notification :
| void | sizeChanged(QSize size) |
Voir également height et width.
width : int
Cette propriété indique la largeur de l'image de texture. La largeur doit être supérieure ou égale à 1.
Fonctions d'accès :
| int | width() const |
| void | setWidth(int w) |
Signal de notification :
| void | widthChanged(int w) |
Documentation des fonctions membres
[pure virtual protected] void QPaintedTextureImage::paint(QPainter *painter)
Peint l'image de texture à l'aide de l'objet « QPainter » spécifié painter.
QPainter considère le coin supérieur gauche d'une image comme son origine, tandis qu'OpenGL considère le coin inférieur gauche d'une texture comme son origine. Un moyen simple de tenir compte de cette différence consiste à définir une fenêtre d'affichage personnalisée sur le peintre avant d'effectuer tout autre dessin :
painter->setViewport(0, height(), width(), -height());
...[slot] void QPaintedTextureImage::setHeight(int h)
Définit la hauteur (h) de l'image de texture. Déclenche une mise à jour si la taille change.
Remarque : fonctionde définition de la propriété height.
Voir aussi height().
[slot] void QPaintedTextureImage::setSize(QSize size)
Définit la largeur et la hauteur de l'image de texture. Déclenche une mise à jour si la propriété « size » change.
Remarque : fonctionde définition de la propriété size.
Voir aussi size().
[slot] void QPaintedTextureImage::setWidth(int w)
Définit la largeur (w) de l'image de texture. Déclenche une mise à jour si la taille change.
Remarque : fonctionde définition de la propriété width.
Voir aussi width().
void QPaintedTextureImage::update(const QRect &rect = QRect())
Déclenche immédiatement la fonction ` paint()` de la texture peinte, qui se charge à son tour de transférer la nouvelle image vers le GPU. Si vous apportez plusieurs modifications à une texture peinte, pensez à attendre que toutes les modifications soient terminées avant d’appeler `update`, afin de réduire au minimum le nombre de rafraîchissements nécessaires.
Le paramètre ` rect ` n'est actuellement pas utilisé.
© 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.
