Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

Qt3DRender::QTextureImage Class

class Qt3DRender::QTextureImage

Contient les informations nécessaires à la création d'une image de texture OpenGL à partir d'une source d'image. En savoir plus...

En-tête : #include <qtextureimage.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : TextureImage
Hérite de : Qt3DRender::QAbstractTextureImage
Statut : Obsolète

Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.

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 (niveau de mipmap, couche, face du cube et URL source) pour charger les données à l'emplacement approprié dans une texture OpenGL.

Documentation sur le type de membre

enum QTextureImage::Status

Cette énumération définit les valeurs d'état relatives au chargement des images de texture.

ConstanteValeurDescription
Qt3DRender::QTextureImage::None0Le chargement de l'image de texture n'a pas encore commencé.
Qt3DRender::QTextureImage::Loading1Le chargement de l'image de texture a commencé, mais n'est pas terminé.
Qt3DRender::QTextureImage::Ready2Le chargement de l'image de texture est terminé.
Qt3DRender::QTextureImage::Error3Une erreur s'est produite lors du chargement de l'image de texture.

Documentation des propriétés

mirrored : bool

Cette propriété spécifie si l'image doit être inversée lors de son chargement. Il s'agit d'une fonctionnalité pratique permettant d'éviter d'avoir à manipuler les images pour les adapter à 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 ». Elle n'a aucun effet lors de l'utilisation de formats de texture compressés par le GPU.

Avertissement : cette propriété entraîne une perte de performances lors de l'exécution, lors du chargement de formats d'images non compressés ou compressés par le CPU, tels que le format PNG. Pour éviter cette perte de performances, il est préférable de définir cette propriété sur « false » et de charger des ressources de texture qui ont déjà été inversées.

Remarque : OpenGL spécifie que l’origine des coordonnées de texture se situe au coin inférieur gauche, tandis que DirectX utilise le coin supérieur gauche.

Remarque : lorsque vous utilisez une texture de type « cube map », vous souhaiterez probablement désactiver la mise en miroir, car l'échantillonneur de cube map utilise une direction plutôt que des coordonnées de texture classiques.

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 :

QUrl source() const
void setSource(const QUrl &source)

Signal de notification :

void sourceChanged(const QUrl &source)

[read-only] status : Status

Cette propriété indique l'état du chargement de l'image de texture.

  • TextureImage.None
  • TextureImage.Loading
  • TextureImage.Ready
  • TextureImage.Error

Fonctions d'accès :

Qt3DRender::QTextureImage::Status status() const

Signal de notification :

void statusChanged(Qt3DRender::QTextureImage::Status status)

Documentation des fonctions membres

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

Crée une nouvelle instance de ` Qt3DRender::QTextureImage ` dont le parent est ` parent `.

bool QTextureImage::isMirrored() const

Indique si la mise en miroir est activée ou non.

Remarque : fonctiongetter pour la propriété mirrored.

[slot] void QTextureImage::setMirrored(bool mirrored)

Configure la synchronisation avec mirrored.

Remarque : cela déclenche en interne un appel pour mettre à jour le générateur de données.

Remarque : fonctionde définition pour la propriété mirrored.

Voir également isMirrored().

[slot] void QTextureImage::setSource(const QUrl &source)

Définit l'URL source de l'image de texture sur source.

Remarque : cela déclenche en interne un appel pour mettre à jour le générateur de données.

Remarque : fonctionde définition pour la propriété source.

Voir également source().

[protected] void QTextureImage::setStatus(Qt3DRender::QTextureImage::Status status)

Définit l'état sur « 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.

Remarque : fonction de lecture (getter ) pour la propriété source.

Voir aussi setSource().

Qt3DRender::QTextureImage::Status QTextureImage::status() const

Renvoie l'état actuel.

Remarque : fonctiongetter pour la propriété status.

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.