Qt3DRender::QTextureImage Class
class Qt3DRender::QTextureImageEncapsule les informations nécessaires à la création d'une image de texture OpenGL à partir d'une source d'image. Plus d'informations...
| En-tête : | #include <QTextureImage> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS 3drender)target_link_libraries(mytarget PRIVATE Qt6::3drender) |
| qmake : | QT += 3drender |
| En QML : | TextureImage |
| Hérite : | Qt3DRender::QAbstractTextureImage |
| Statut : | Déclassé |
Types publics
| enum | Status { None, Loading, Ready, Error } |
Propriétés
Fonctions publiques
| QTextureImage(Qt3DCore::QNode *parent = nullptr) | |
| bool | isMirrored() const |
| QUrl | source() const |
| Qt3DRender::QTextureImage::Status | status() const |
Emplacements publics
| void | setMirrored(bool mirrored) |
| void | setSource(const QUrl &source) |
Signaux
| void | mirroredChanged(bool mirrored) |
| void | sourceChanged(const QUrl &source) |
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Fonctions protégées
| void | setStatus(Qt3DRender::QTextureImage::Status status) |
Description détaillée
Elle contient les informations nécessaires sur le niveau de la mipmap, la couche, la face du cube et l'URL de la source pour charger au bon endroit les données dans une texture OpenGL.
Type de membre Documentation
enum QTextureImage::Status
Cette énumération spécifie les valeurs d'état pour le chargement des images de texture.
| Constante | Valeur | Description de l'état |
|---|---|---|
Qt3DRender::QTextureImage::None | 0 | Le chargement de l'image de texture n'a pas encore commencé. |
Qt3DRender::QTextureImage::Loading | 1 | Le chargement de l'image de texture a commencé, mais n'est pas terminé. |
Qt3DRender::QTextureImage::Ready | 2 | Le chargement de l'image de texture est terminé. |
Qt3DRender::QTextureImage::Error | 3 | Le chargement de l'image de texture a été confronté à une erreur. |
Documentation sur les propriétés
mirrored : bool
Cette propriété indique si l'image doit être reflétée lors de son chargement. Il s'agit d'une commodité qui permet d'éviter de manipuler les images pour qu'elles correspondent à l'origine des coordonnées de texture utilisées par l'API de rendu. Par défaut, cette propriété est définie sur true (vrai). Cela n'a aucun effet lors de l'utilisation de formats de texture compressés par le GPU.
Attention : Cette propriété se traduit par un prix de performance payé à l'exécution lors du chargement de formats d'image non compressés ou compressés par le processeur, tels que PNG. Pour éviter ce problème de performance, il est préférable de mettre cette propriété à false et de charger des textures qui ont été prémirroïsées.
Remarque : OpenGL spécifie l'origine des coordonnées de la texture à partir du coin inférieur gauche, tandis que DirectX utilise le coin supérieur gauche.
Note : Lorsque vous utilisez une texture de type cube map, vous voudrez probablement désactiver l'effet miroir car l'échantillonneur de cube map prend une direction plutôt que des coordonnées de texture normales.
Fonctions d'accès :
| bool | isMirrored() const |
| void | setMirrored(bool mirrored) |
Signal de notification :
| void | mirroredChanged(bool mirrored) |
source : QUrl
Cette propriété contient l'url source à partir de laquelle les données de l'image de texture seront chargées.
Fonctions d'accès :
Signal de notification :
| void | sourceChanged(const QUrl &source) |
[read-only] status : Status
Cette propriété indique l'état de chargement de l'image de texture.
- TextureImage.aucun
- TextureImage.chargement
- TextureImage.prêt
- TextureImageErreur
Fonctions d'accès :
| Qt3DRender::QTextureImage::Status | status() const |
Signal Notificateur :
| void | statusChanged(Qt3DRender::QTextureImage::Status status) |
Fonction membre Documentation
[explicit] QTextureImage::QTextureImage(Qt3DCore::QNode *parent = nullptr)
Construit une nouvelle instance Qt3DRender::QTextureImage avec parent comme parent.
bool QTextureImage::isMirrored() const
Indique si la mise en miroir est activée ou non.
Remarque : fonction Getter pour la propriété mirrored.
[slot] void QTextureImage::setMirrored(bool mirrored)
Définit la mise en miroir à mirrored.
Note : Ceci déclenche en interne un appel à la mise à jour du générateur de données.
Note : Fonction de définition de la propriété mirrored.
Voir aussi isMirrored().
[slot] void QTextureImage::setSource(const QUrl &source)
Définit l'url source de l'image de texture à source.
Note : Ceci déclenche en interne un appel à la mise à jour du générateur de données.
Note : Fonction de définition de la propriété source.
Voir aussi source().
[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)
Définit l'état à status. status
Voir aussi status().
QUrl QTextureImage::source() const
Renvoie l'URL source à partir de laquelle les données de l'image de texture seront chargées.
Note : Fonction Getter pour la propriété source.
Voir aussi setSource().
Qt3DRender::QTextureImage::Status QTextureImage::status() const
Renvoie le statut actuel.
Remarque : fonction d'obtention de l'état de la propriété.
Voir aussi 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.
