QSGImageNode Class

Die Klasse QSGImageNode dient dazu, texturierte Inhalte mit Hilfe des QML-Szenengraphs einfach zu zeichnen. Mehr...

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

Öffentliche Typen

enum TextureCoordinatesTransformFlag { NoTransform, MirrorHorizontally, MirrorVertically }
flags TextureCoordinatesTransformMode

Öffentliche Funktionen

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)

Detaillierte Beschreibung

Warnung: Die Bildknotenklasse muss eine Textur haben, bevor sie dem zu rendernden Szenegraphen hinzugefügt wird.

Dokumentation der Mitgliedstypen

enum QSGImageNode::TextureCoordinatesTransformFlag
flags QSGImageNode::TextureCoordinatesTransformMode

Das Enum TextureCoordinatesTransformFlag wird verwendet, um den Modus festzulegen, der zur Erzeugung von Texturkoordinaten für ein texturiertes Quad verwendet wird.

KonstanteWertBeschreibung
QSGImageNode::NoTransform0x00Die Texturkoordinaten orientieren sich an den Fensterkoordinaten, d.h. der Ursprung befindet sich oben links.
QSGImageNode::MirrorHorizontally0x01Die Texturkoordinaten werden in der horizontalen Achse in Bezug auf die Fensterkoordinaten invertiert.
QSGImageNode::MirrorVertically0x02Die Texturkoordinaten werden in der vertikalen Achse in Bezug auf die Fensterkoordinaten invertiert.

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

Dokumentation der Mitgliedsfunktionen

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

Gibt den Anistropiegrad 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 das Eigentum 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 der texture, den Koordinaten in rect und den Texturkoordinaten aus sourceRect.

g wird als Dreiecksstreifen mit vier Scheitelpunkten vom Typ QSGGeometry::TexturedPoint2D angenommen.

texCoordMode wird für die Normalisierung der sourceRect verwendet.

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

Gibt das Ziel-Rect dieses Bildknotens zurück.

Siehe auch setRect().

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

Setzt den Anistropiegrad dieses Bildknotens auf level.

Siehe auch anisotropyLevel().

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

Setzt die für diesen Bildknoten zu verwendende Filterung auf filtering.

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)

Setzt die für diesen Bildknoten zu verwendende Mipmap-Filterung auf filtering.

Für eine glatte Skalierung zwischen 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 das Eigentum an der Textur auf owns übernimmt.

Standardmäßig übernimmt der Knoten nicht das Eigentum an der Textur.

Siehe auch ownsTexture().

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

Setzt das Ziel-Rect dieses Bildknotens auf rect.

Siehe auch rect().

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

Dies ist eine überladene Funktion.

Legt das Rechteck dieses Bildknotens so fest, dass es bei (x, y) beginnt und die Breite w und die Höhe h hat.

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

Setzt das Quell-Rect dieses Bildknotens auf rect.

Siehe auch sourceRect().

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

Dies ist eine überladene Funktion.

Legt das Rechteck dieses Bildknotens so fest, dass seine Textur von (x, y) angezeigt wird und Breite w und Höhe h relativ zu QSGTexture::textureSize haben.

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

Setzt die Textur dieses Bildknotens auf texture.

Verwenden Sie setOwnsTexture(), um festzulegen, ob der Knoten das Eigentum an der Textur übernehmen soll. Standardmäßig übernimmt der Knoten die Textur nicht.

Warnung: Ein Bildknoten muss eine Textur haben, bevor er dem zu rendernden Szenegraphen hinzugefügt wird.

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 erhalten. Dies ist in der Regel erforderlich, wenn eine OpenGL-Bibliothek eines Drittanbieters zum Rendern der Textur verwendet wird, da OpenGL eine invertierte y-Achse relativ zu Qt Quick hat.

Siehe auch textureCoordinatesTransform().

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

Gibt das Quell-Rect 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 von Texturkoordinaten für diesen Knoten verwendet wurde.

Siehe auch setTextureCoordinatesTransform().

© 2025 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.