Auf dieser Seite

QSGImageNode Class

Die Klasse „QSGImageNode“ dient als Hilfsmittel, um texturierte Inhalte mithilfe des QML-Szenengrafiks einfach darzustellen. Mehr...

Header: #include <QSGImageNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
Erbt von: QSGGeometryNode

Öffentliche Typen

enum TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically }
flags TextureCoordinatesTransformMode

Öffentliche Funktionen

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

Statische öffentliche Mitglieder

void rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode)

Ausführliche Beschreibung

Warnung: Die Bildknotenklasse muss über eine Textur verfügen, bevor sie dem Szenengraphen hinzugefügt und gerendert werden kann.

Dokumentation zum Mitgliedstyp

enum QSGImageNode::TextureCoordinatesTransformFlag
flags QSGImageNode::TextureCoordinatesTransformMode

Die Enumeration „TextureCoordinatesTransformFlag“ dient dazu, den Modus festzulegen, der zur Erzeugung von Texturkoordinaten für ein texturiertes Viereck verwendet wird.

KonstanteWertBeschreibung
QSGImageNode::NoTransform0x00Die Texturkoordinaten sind auf die Fensterkoordinaten ausgerichtet, d. h. mit Ursprung in der oberen linken Ecke.
QSGImageNode::MirrorHorizontally0x01Die Texturkoordinaten sind in horizontaler Richtung gegenüber den Fensterkoordinaten gespiegelt.
QSGImageNode::MirrorVertically0x02Die Texturkoordinaten werden in der vertikalen Achse im Verhältnis zu den Fensterkoordinaten gespiegelt

Der Typ `TextureCoordinatesTransformMode` ist ein `typedef` für ` QFlags<TextureCoordinatesTransformFlag>`. Er speichert eine OR-Kombination von `TextureCoordinatesTransformFlag`-Werten.

Dokumentation der Mitgliedsfunktionen

[override virtual noexcept default] QSGImageNode::~QSGImageNode()

Löscht die Instanz von ` QSGImageNode`. Dieser Destruktor ist virtuell.

[pure virtual] QSGTexture::AnisotropyLevel QSGImageNode::anisotropyLevel() const

Gibt den Anisotropiegrad dieses Bildknotens zurück.

Siehe auch „ setAnisotropyLevel()“.

[pure virtual] QSGTexture::Filtering QSGImageNode::filtering() const

Gibt die Filterung für diesen Bildknoten zurück.

Siehe auch „ setFiltering()“.

[pure virtual] QSGTexture::Filtering QSGImageNode::mipmapFiltering() const

Gibt die Mipmap-Filterung für diesen Bildknoten zurück.

Siehe auch „ setMipmapFiltering()“.

[pure virtual] bool QSGImageNode::ownsTexture() const

Gibt „ true “ zurück, wenn der Knoten die Eigentumsrechte an der Textur übernimmt; andernfalls „ false “.

Siehe auch „ setOwnsTexture()“.

[static] void QSGImageNode::rebuildGeometry(QSGGeometry *g, QSGTexture *texture, const QRectF &rect, QRectF sourceRect, QSGImageNode::TextureCoordinatesTransformMode texCoordMode)

Aktualisiert die Geometrie g mit dem texture, den Koordinaten in rect und den Texturkoordinaten aus sourceRect.

g Es wird angenommen, dass es sich um einen Dreiecksstreifen mit vier Eckpunkten vom Typ ` QSGGeometry::TexturedPoint2D` handelt.

texCoordMode wird zur Normalisierung des „ sourceRect “ verwendet.

[pure virtual] QRectF QSGImageNode::rect() const

Gibt das Zielrechteck dieses Bildknotens zurück.

Siehe auch „ setRect()“.

[pure virtual] void QSGImageNode::setAnisotropyLevel(QSGTexture::AnisotropyLevel level)

Setzt den Anisotropiegrad dieses Bildknotens auf „ level “.

Siehe auch ` anisotropyLevel()`.

[pure virtual] void QSGImageNode::setFiltering(QSGTexture::Filtering filtering)

Legt die für diesen Bildknoten zu verwendende Filterung auf „ filtering “ fest.

Für eine glatte Skalierung verwenden Sie „ QSGTexture::Linear “. Für eine normale Skalierung verwenden Sie „ QSGTexture::Nearest “.

Siehe auch „ filtering()“.

[pure virtual] void QSGImageNode::setMipmapFiltering(QSGTexture::Filtering filtering)

Legt die für diesen Bildknoten zu verwendende Mipmap-Filterung auf „ filtering “ fest.

Für eine sanfte Skalierung zwischen den Mipmaps verwenden Sie „ QSGTexture::Linear “. Für eine normale Skalierung verwenden Sie „ QSGTexture::Nearest “.

Siehe auch „ mipmapFiltering()“.

[pure virtual] void QSGImageNode::setOwnsTexture(bool owns)

Legt fest, ob der Knoten die Eigentumsrechte an der Textur übernimmt ( owns).

Standardmäßig übernimmt der Knoten nicht die Eigentumsrechte an der Textur.

Siehe auch ` ownsTexture()`.

[pure virtual] void QSGImageNode::setRect(const QRectF &rect)

Legt das Zielrechteck dieses Bildknotens auf „ rect “ fest.

Siehe auch „ rect()“.

void QSGImageNode::setRect(qreal x, qreal y, qreal w, qreal h)

Legt fest, dass das Rechteck dieses Bildknotens bei (x, y) beginnt und eine Breite von w sowie eine Höhe von h hat.

Dies ist eine überladene Funktion.

[pure virtual] void QSGImageNode::setSourceRect(const QRectF &rect)

Legt den Quellbereich dieses Bildknotens auf „ rect “ fest.

Siehe auch sourceRect().

void QSGImageNode::setSourceRect(qreal x, qreal y, qreal w, qreal h)

Legt das Rechteck dieses Bildknotens so fest, dass dessen Textur aus (x, y) angezeigt wird und die Breite w sowie die Höhe h relativ zu QSGTexture::textureSize beträgt.

Dies ist eine überladene Funktion.

[pure virtual] void QSGImageNode::setTexture(QSGTexture *texture)

Legt die Textur dieses Bildknotens auf „ texture “ fest.

Verwenden Sie ` setOwnsTexture()` , um festzulegen, ob der Knoten die Eigentümerschaft an der Textur übernehmen soll. Standardmäßig übernimmt der Knoten keine Eigentümerschaft.

Warnung: Ein Bildknoten muss über eine Textur verfügen, bevor er zum Szenengraphen hinzugefügt und gerendert werden kann.

Siehe auch ` texture()`.

[pure virtual] void QSGImageNode::setTextureCoordinatesTransform(QSGImageNode::TextureCoordinatesTransformMode mode)

Legt die Methode zur Erzeugung von Texturkoordinaten auf „ mode “ fest. Dies kann verwendet werden, um die korrekte Ausrichtung der Textur zu gewährleisten. Dies ist häufig erforderlich, wenn eine OpenGL-Bibliothek eines Drittanbieters zum Rendern in eine Textur verwendet wird, da OpenGL im Vergleich zu Qt Quick eine invertierte y-Achse aufweist.

Siehe auch ` textureCoordinatesTransform()`.

[pure virtual] QRectF QSGImageNode::sourceRect() const

Gibt das Quellrechteck dieses Bildknotens zurück.

Siehe auch „ setSourceRect()“.

[pure virtual] QSGTexture *QSGImageNode::texture() const

Gibt die Textur für diesen Bildknoten zurück.

Siehe auch setTexture().

[pure virtual] QSGImageNode::TextureCoordinatesTransformMode QSGImageNode::textureCoordinatesTransform() const

Gibt den Modus zurück, der zur Erzeugung der Texturkoordinaten für diesen Knoten verwendet wird.

Siehe auch „ 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.