QSGSimpleTextureNode Class
La classe `QSGSimpleTextureNode` est fournie pour faciliter le dessin de contenus texturés à l'aide du graphe de scène QML. En savoir plus...
| En-tête : | #include <QSGSimpleTextureNode> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| Hérite de : | QSGGeometryNode |
Types publics
| enum | TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically } |
| flags | TextureCoordinatesTransformMode |
Fonctions publiques
| QSGSimpleTextureNode() | |
| virtual | ~QSGSimpleTextureNode() override |
| QSGTexture::Filtering | filtering() const |
| bool | ownsTexture() const |
| QRectF | rect() const |
| void | setFiltering(QSGTexture::Filtering filtering) |
| void | setOwnsTexture(bool owns) |
| void | setRect(const QRectF &r) |
| void | setRect(qreal x, qreal y, qreal w, qreal h) |
| void | setSourceRect(const QRectF &r) |
| void | setSourceRect(qreal x, qreal y, qreal w, qreal h) |
| void | setTexture(QSGTexture *texture) |
| void | setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode) |
| QRectF | sourceRect() const |
| QSGTexture * | texture() const |
| QSGSimpleTextureNode::TextureCoordinatesTransformMode | textureCoordinatesTransform() const |
Description détaillée
Avertissement : la classe de nœud de texture simple doit disposer d’une texture avant d’être ajoutée au graphe de scène pour être rendue.
Avertissement : cette classe utilitaire ne fonctionne qu’avec les backends par défaut ou logiciels du graphe de scène Qt Quick. À titre d’alternative, préférez l’utilisation d’ QSGImageNode via QQuickWindow::createImageNode(). Cependant, cette classe autonome reste utile lorsqu’elle est utilisée via la sous-classification et que l’application sait qu’aucun backend de graphe de scène particulier ne sera impliqué.
Documentation sur les types de membres
enum QSGSimpleTextureNode::TextureCoordinatesTransformFlag
flags QSGSimpleTextureNode::TextureCoordinatesTransformMode
L'énumération `TextureCoordinatesTransformFlag` sert à spécifier le mode utilisé pour générer les coordonnées de texture d'un quadrilatère texturé.
| Constante | Valeur | Description |
|---|---|---|
QSGSimpleTextureNode::NoTransform | 0x00 | Les coordonnées de texture sont orientées selon les coordonnées de la fenêtre, c'est-à-dire avec l'origine en haut à gauche. |
QSGSimpleTextureNode::MirrorHorizontally | 0x01 | Les coordonnées de texture sont inversées sur l'axe horizontal par rapport aux coordonnées de la fenêtre |
QSGSimpleTextureNode::MirrorVertically | 0x02 | Les coordonnées de texture sont inversées sur l'axe vertical par rapport aux coordonnées de la fenêtre |
Le type `TextureCoordinatesTransformMode` est un `typedef` pour `QFlags<TextureCoordinatesTransformFlag>`. Il stocke une combinaison (ou) de valeurs `TextureCoordinatesTransformFlag`.
Documentation des fonctions membres
QSGSimpleTextureNode::QSGSimpleTextureNode()
Crée un nouveau nœud de texture simple
[override virtual noexcept] QSGSimpleTextureNode::~QSGSimpleTextureNode()
Supprime le nœud de texture
QSGTexture::Filtering QSGSimpleTextureNode::filtering() const
Renvoie le filtrage actuellement défini sur ce nœud de texture
Voir aussi setFiltering().
bool QSGSimpleTextureNode::ownsTexture() const
Renvoie « true » si le nœud prend possession de la texture ; sinon, renvoie « false ».
Voir également setOwnsTexture().
QRectF QSGSimpleTextureNode::rect() const
Renvoie le rectangle cible de ce nœud de texture.
Voir aussi setRect().
void QSGSimpleTextureNode::setFiltering(QSGTexture::Filtering filtering)
Définit le filtrage à utiliser pour ce nœud de texture sur « filtering ».
Pour une mise à l'échelle lisse, utilisez ` QSGTexture::Linear` ; pour une mise à l'échelle normale, utilisez ` QSGTexture::Nearest`.
Voir également filtering().
void QSGSimpleTextureNode::setOwnsTexture(bool owns)
Détermine si le nœud prend possession de la texture à l'adresse owns.
Par défaut, le nœud ne prend pas possession de la texture.
Voir également ownsTexture() et setTexture().
void QSGSimpleTextureNode::setRect(const QRectF &r)
Définit le rectangle cible de ce nœud de texture sur r.
Voir également rect().
void QSGSimpleTextureNode::setRect(qreal x, qreal y, qreal w, qreal h)
Définit le rectangle de ce nœud de texture de manière à ce qu'il commence aux coordonnées (x, y) et qu'il ait une largeur de w et une hauteur de h.
Il s'agit d'une fonction surchargée.
void QSGSimpleTextureNode::setSourceRect(const QRectF &r)
Définit le rectangle source de ce nœud de texture sur r.
Voir également sourceRect().
void QSGSimpleTextureNode::setSourceRect(qreal x, qreal y, qreal w, qreal h)
Définit le rectangle de ce nœud de texture de manière à afficher sa texture à partir de (x, y) et à lui attribuer une largeur de w et une hauteur de h par rapport à QSGTexture::textureSize.
Il s'agit d'une fonction surchargée.
void QSGSimpleTextureNode::setTexture(QSGTexture *texture)
Définit la texture de ce nœud de texture sur texture.
Utilisez setOwnsTexture() pour déterminer si le nœud doit prendre possession de la texture. Par défaut, le nœud ne prend pas possession de la texture.
Avertissement : un nœud de texture doit disposer d’une texture avant d’être ajouté à l’arborescence de scène pour pouvoir être rendu.
Voir également texture().
void QSGSimpleTextureNode::setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode)
Définit la méthode utilisée pour générer les coordonnées de texture sur ` mode`. Cela permet d'obtenir une orientation correcte de la texture. Cette option est généralement nécessaire lors de l'utilisation d'une bibliothèque OpenGL tierce pour le rendu sur texture, car OpenGL présente un axe y inversé par rapport à ` Qt Quick`.
Voir également textureCoordinatesTransform().
QRectF QSGSimpleTextureNode::sourceRect() const
Renvoie le rectangle source de ce nœud de texture.
Voir aussi setSourceRect().
QSGTexture *QSGSimpleTextureNode::texture() const
Renvoie la texture associée à ce nœud de texture
Voir aussi setTexture().
QSGSimpleTextureNode::TextureCoordinatesTransformMode QSGSimpleTextureNode::textureCoordinatesTransform() const
Renvoie le mode utilisé pour générer les coordonnées de texture pour ce nœud.
Voir également setTextureCoordinatesTransform().
© 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.
