QSGImageNode Class
La classe QSGImageNode est fournie pour faciliter le dessin de contenu texturé à l'aide du graphe de scène QML. Plus d'informations...
| En-tête : | #include <QSGImageNode> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| Héritages : | QSGGeometryNode |
Types publics
| enum | TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically } |
| flags | TextureCoordinatesTransformMode |
Fonctions publiques
| 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
Attention : La classe de nœud d'image doit avoir une texture avant d'être ajoutée au graphe de scène pour être rendue.
Documentation des types de membres
enum QSGImageNode::TextureCoordinatesTransformFlag
flags QSGImageNode::TextureCoordinatesTransformMode
L'enum TextureCoordinatesTransformFlag est utilisé pour spécifier le mode utilisé pour générer les coordonnées de texture pour un quad texturé.
| Constante | Valeur | Description |
|---|---|---|
QSGImageNode::NoTransform | 0x00 | Les coordonnées de la texture sont orientées en fonction des coordonnées de la fenêtre, c'est-à-dire que l'origine est située en haut à gauche. |
QSGImageNode::MirrorHorizontally | 0x01 | Les coordonnées de la texture sont inversées sur l'axe horizontal par rapport aux coordonnées de la fenêtre. |
QSGImageNode::MirrorVertically | 0x02 | Les coordonnées de la 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
[pure virtual] QSGTexture::AnisotropyLevel QSGImageNode::anisotropyLevel() const
Renvoie le niveau d'anistropie de ce nœud d'image.
Voir également setAnisotropyLevel().
[pure virtual] QSGTexture::Filtering QSGImageNode::filtering() const
Renvoie le filtrage pour ce nœud d'image.
Voir aussi setFiltering().
[pure virtual] QSGTexture::Filtering QSGImageNode::mipmapFiltering() const
Renvoie le filtrage mipmap pour ce nœud d'image.
Voir aussi setMipmapFiltering().
[pure virtual] bool QSGImageNode::ownsTexture() const
Renvoie true si le nœud est propriétaire de la texture, sinon false.
Voir aussi 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 texture, les coordonnées dans rect, et les coordonnées de texture de sourceRect.
g est supposée être une bande triangulaire de quatre sommets de type QSGGeometry::TexturedPoint2D.
texCoordMode est utilisé pour normaliser les coordonnées de sourceRect.
[pure virtual] QRectF QSGImageNode::rect() const
Renvoie le rectangle cible de ce nœud d'image.
Voir également setRect().
[pure virtual] void QSGImageNode::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)
Fixe le niveau d'anistropie de ce nœud d'image à level.
Voir aussi anisotropyLevel().
[pure virtual] void QSGImageNode::setFiltering(QSGTexture::Filtering filtering)
Définit le filtrage à utiliser pour ce nœud d'image à filtering.
Pour une mise à l'échelle douce, utilisez QSGTexture::Linear. Pour une mise à l'échelle normale, utilisez QSGTexture::Nearest.
Voir aussi filtering().
[pure virtual] void QSGImageNode::setMipmapFiltering(QSGTexture::Filtering filtering)
Définit le filtrage mipmap à utiliser pour ce nœud d'image à filtering.
Pour une mise à l'échelle sans heurts entre les mip maps, utilisez QSGTexture::Linear. Pour une mise à l'échelle normale, utilisez QSGTexture::Nearest.
Voir aussi mipmapFiltering().
[pure virtual] void QSGImageNode::setOwnsTexture(bool owns)
Définit si le nœud prend possession de la texture à 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 à rect.
Voir aussi rect().
void QSGImageNode::setRect(qreal x, qreal y, qreal w, qreal h)
Définit le rectangle de ce nœud d'image comme commençant à (x, y) et ayant pour largeur w et pour hauteur 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 à rect.
Voir aussi sourceRect().
void QSGImageNode::setSourceRect(qreal x, qreal y, qreal w, qreal h)
Définit le rectangle de ce nœud d'image pour montrer sa texture à partir de (x, y) et avoir la largeur w et la hauteur h par rapport à 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 à texture.
Utilisez setOwnsTexture() pour indiquer si le nœud doit être propriétaire de la texture. Par défaut, le nœud n'est pas propriétaire.
Attention : Un nœud d'image doit avoir une texture avant d'être ajouté au graphe de scène pour ê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 la texture à mode. Cela peut être utilisé pour obtenir une orientation correcte de la texture. Cela est souvent nécessaire lorsqu'on utilise une bibliothèque OpenGL tierce pour effectuer le rendu de la texture, car OpenGL a un axe des ordonnées 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 également setSourceRect().
[pure virtual] QSGTexture *QSGImageNode::texture() const
Renvoie la texture de 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 aussi 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.
