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.
| Konstante | Wert | Beschreibung |
|---|---|---|
QSGImageNode::NoTransform | 0x00 | Die Texturkoordinaten sind auf die Fensterkoordinaten ausgerichtet, d. h. mit Ursprung in der oberen linken Ecke. |
QSGImageNode::MirrorHorizontally | 0x01 | Die Texturkoordinaten sind in horizontaler Richtung gegenüber den Fensterkoordinaten gespiegelt. |
QSGImageNode::MirrorVertically | 0x02 | Die 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.