QSGImageNode Class
La classe QSGImageNode est fournie à titre pratique pour faciliter le dessin de contenus texturés à l'aide du graphe de scène QML. En savoir plus...
| En-tête : | #include <QSGImageNode> |
| 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
| virtual | ~QSGImageNode() override |
| virtual QSGTexture::AnisotropyLevel | anisotropyLevel() const = 0 |
| virtual QSGTexture::Filtering | filtering() const = 0 |
| virtual QSGTexture::Filtering | mipmapFiltering() const = 0 |
| virtual bool | ownsTexture() const = 0 |
| virtual QRectF | rect() const = 0 |
| virtual void | setAnisotropyLevel(QSGTexture::AnisotropyLevel level) = 0 |
| virtual void | setFiltering(QSGTexture::Filtering filtering) = 0 |
| virtual void | setMipmapFiltering(QSGTexture::Filtering filtering) = 0 |
| virtual void | setOwnsTexture(bool owns) = 0 |
| virtual void | setRect(const QRectF &rect) = 0 |
| void | setRect(qreal x, qreal y, qreal w, qreal h) |
| virtual void | setSourceRect(const QRectF &rect) = 0 |
| void | setSourceRect(qreal x, qreal y, qreal w, qreal h) |
| virtual void | setTexture(QSGTexture *texture) = 0 |
| virtual void | setTextureCoordinatesTransform(QSGImageNode::TextureCoordinatesTransformMode mode) = 0 |
| virtual QRectF | sourceRect() const = 0 |
| virtual QSGTexture * | texture() const = 0 |
| virtual QSGImageNode::TextureCoordinatesTransformMode | textureCoordinatesTransform() const = 0 |
Membres publics statiques
| void | rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode) |
Description détaillée
Avertissement : la classe de nœud d'image doit disposer d'une texture avant d'être ajoutée au graphe de scène pour pouvoir être rendue.
Documentation sur les types de membres
enum QSGImageNode::TextureCoordinatesTransformFlag
flags QSGImageNode::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 |
|---|---|---|
QSGImageNode::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. |
QSGImageNode::MirrorHorizontally | 0x01 | Les coordonnées de texture sont inversées sur l'axe horizontal par rapport aux coordonnées de la fenêtre |
QSGImageNode::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
[override virtual noexcept default] QSGImageNode::~QSGImageNode()
Détruit l'instance de ` QSGImageNode`. Ce destructeur est virtuel.
[pure virtual] QSGTexture::AnisotropyLevel QSGImageNode::anisotropyLevel() const
Renvoie le niveau d'anisotropie de ce nœud d'image.
Voir aussi setAnisotropyLevel().
[pure virtual] QSGTexture::Filtering QSGImageNode::filtering() const
Renvoie les critères de filtrage associés à ce nœud d'image.
Voir aussi setFiltering().
[pure virtual] QSGTexture::Filtering QSGImageNode::mipmapFiltering() const
Renvoie le filtrage par mipmap pour ce nœud d'image.
Voir aussi setMipmapFiltering().
[pure virtual] bool QSGImageNode::ownsTexture() const
Renvoie « true » si le nœud prend possession de la texture ; sinon, « false ».
Voir également setOwnsTexture().
[static] void QSGImageNode::rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode)
Met à jour la géométrie g avec l'texture, les coordonnées de rect et les coordonnées de texture de sourceRect.
g On suppose qu’il s’agit d’une bande de triangles à quatre sommets de type QSGGeometry::TexturedPoint2D.
texCoordMode est utilisé pour normaliser le sourceRect.
[pure virtual] QRectF QSGImageNode::rect() const
Renvoie le rectangle cible de ce nœud d'image.
Voir aussi setRect().
[pure virtual] void QSGImageNode::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
Définit le niveau d'anisotropie de ce nœud d'image sur level.
Voir aussi anisotropyLevel().
[pure virtual] void QSGImageNode::setFiltering(QSGTexture::Filtering filtering)
Définit le filtrage à utiliser pour ce nœud d'image sur « filtering ».
Pour une mise à l'échelle lisse, utilisez ` QSGTexture::Linear`. Pour une mise à l'échelle normale, utilisez ` QSGTexture::Nearest`.
Voir également filtering().
[pure virtual] void QSGImageNode::setMipmapFiltering(QSGTexture::Filtering filtering)
Définit le filtrage par mipmaps à utiliser pour ce nœud d'image sur « filtering ».
Pour une mise à l'échelle progressive entre les mipmaps, utilisez ` QSGTexture::Linear`. Pour une mise à l'échelle normale, utilisez ` QSGTexture::Nearest`.
Voir également la fonction ` mipmapFiltering()`.
[pure virtual] void QSGImageNode::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()`.
[pure virtual] void QSGImageNode::setRect(const QRectF &rect)
Définit le rectangle cible de ce nœud d'image sur rect.
Voir également rect().
void QSGImageNode::setRect(qreal x, qreal y, qreal w, qreal h)
Définit le rectangle de ce nœud d'image 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.
[pure virtual] void QSGImageNode::setSourceRect(const QRectF &rect)
Définit le rectangle source de ce nœud d'image sur rect.
Voir également sourceRect().
void QSGImageNode::setSourceRect(qreal x, qreal y, qreal w, qreal h)
Définit le rectangle de ce nœud d'image afin d'afficher sa texture à partir de (x, y) avec une largeur de w et une hauteur de h par rapport à l'QSGTexture::textureSize.
Il s'agit d'une fonction surchargée.
[pure virtual] void QSGImageNode::setTexture(QSGTexture *texture)
Définit la texture de ce nœud d'image sur texture.
Utilisez setOwnsTexture() pour déterminer si le nœud doit prendre possession de la texture. Par défaut, le nœud n'en prend pas possession.
Avertissement : un nœud d'image doit disposer d'une texture avant d'être ajouté au graphe de scène pour pouvoir être rendu.
Voir aussi ` texture()`.
[pure virtual] void QSGImageNode::setTextureCoordinatesTransform(QSGImageNode::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 opération 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().
[pure virtual] QRectF QSGImageNode::sourceRect() const
Renvoie le rectangle source de ce nœud d'image.
Voir aussi setSourceRect().
[pure virtual] QSGTexture *QSGImageNode::texture() const
Renvoie la texture associée à ce nœud d'image.
Voir aussi setTexture().
[pure virtual] QSGImageNode::TextureCoordinatesTransformMode QSGImageNode::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.