Sur cette page

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é.

ConstanteValeurDescription
QSGImageNode::NoTransform0x00Les 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::MirrorHorizontally0x01Les coordonnées de texture sont inversées sur l'axe horizontal par rapport aux coordonnées de la fenêtre
QSGImageNode::MirrorVertically0x02Les 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.