QSGSimpleTextureNode Class
Die Klasse „QSGSimpleTextureNode“ dient als Hilfsmittel, um texturierte Inhalte mithilfe des QML-Szenengraphen einfach darzustellen. Mehr...
| Header: | #include <QSGSimpleTextureNode> |
| 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
| QSGSimpleTextureNode() | |
| virtual | ~QSGSimpleTextureNode() override |
| QSGTexture::Filtering | filtering() const |
| bool | ownsTexture() const |
| QRectF | rect() const |
| void | setFiltering(QSGTexture::Filtering filtering) |
| void | setOwnsTexture(bool owns) |
| void | setRect(const QRectF &r) |
| void | setRect(qreal x, qreal y, qreal w, qreal h) |
| void | setSourceRect(const QRectF &r) |
| void | setSourceRect(qreal x, qreal y, qreal w, qreal h) |
| void | setTexture(QSGTexture *texture) |
| void | setTextureCoordinatesTransform(QSGSimpleTextureNode::TextureCoordinatesTransformMode mode) |
| QRectF | sourceRect() const |
| QSGTexture * | texture() const |
| QSGSimpleTextureNode::TextureCoordinatesTransformMode | textureCoordinatesTransform() const |
Ausführliche Beschreibung
Warnung: Die Klasse „simple texture node“ muss über eine Textur verfügen, bevor sie dem Szenengraphen hinzugefügt und gerendert werden kann.
Warnung: Diese Hilfsklasse funktioniert nur, wenn sie mit dem Standard- oder Software-Backend des „ Qt Quick “-Szenengraphen ausgeführt wird. Verwenden Sie alternativ vorzugsweise „ QSGImageNode “ über „ QQuickWindow::createImageNode()“. Diese eigenständige Klasse ist jedoch weiterhin nützlich, wenn sie über Unterklassen verwendet wird und die Anwendung weiß, dass keine speziellen Szenengraph-Backends beteiligt sind.
Dokumentation zu Mitgliedstypen
enum QSGSimpleTextureNode::TextureCoordinatesTransformFlag
flags QSGSimpleTextureNode::TextureCoordinatesTransformMode
Die Enumeration „TextureCoordinatesTransformFlag“ dient dazu, den Modus anzugeben, der zur Erzeugung von Texturkoordinaten für ein texturiertes Viereck verwendet wird.
| Konstante | Wert | Beschreibung |
|---|---|---|
QSGSimpleTextureNode::NoTransform | 0x00 | Die Texturkoordinaten sind auf die Fensterkoordinaten ausgerichtet, d. h. mit Ursprung in der oberen linken Ecke. |
QSGSimpleTextureNode::MirrorHorizontally | 0x01 | Die Texturkoordinaten sind in horizontaler Richtung gegenüber den Fensterkoordinaten gespiegelt. |
QSGSimpleTextureNode::MirrorVertically | 0x02 | Die Texturkoordinaten werden in der vertikalen Achse im Verhältnis zu den Fensterkoordinaten umgekehrt |
Der Typ `TextureCoordinatesTransformMode` ist ein `typedef` für ` QFlags<TextureCoordinatesTransformFlag>`. Er speichert eine OR-Kombination von `TextureCoordinatesTransformFlag`-Werten.
Dokumentation der Mitgliedsfunktionen
QSGSimpleTextureNode::QSGSimpleTextureNode()
Erstellt einen neuen einfachen Texturknoten
[override virtual noexcept] QSGSimpleTextureNode::~QSGSimpleTextureNode()
Löscht den Textur-Knoten
QSGTexture::Filtering QSGSimpleTextureNode::filtering() const
Gibt die derzeit für diesen Texturknoten eingestellte Filterung zurück
Siehe auch „ setFiltering()“.
bool QSGSimpleTextureNode::ownsTexture() const
Gibt „ true “ zurück, wenn der Knoten die Eigentumsrechte an der Textur übernimmt; andernfalls wird „ false “ zurückgegeben.
Siehe auch setOwnsTexture().
QRectF QSGSimpleTextureNode::rect() const
Gibt das Zielrechteck dieses Texturknotens zurück.
Siehe auch „ setRect()“.
void QSGSimpleTextureNode::setFiltering(QSGTexture::Filtering filtering)
Legt die für diesen Texturknoten 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()“.
void QSGSimpleTextureNode::setOwnsTexture(bool owns)
Legt fest, ob der Knoten die Eigentumsrechte an der Textur übernimmt ( owns).
Standardmäßig übernimmt der Knoten die Eigentumsrechte an der Textur nicht.
Siehe auch „ ownsTexture()“ und „ setTexture()“.
void QSGSimpleTextureNode::setRect(const QRectF &r)
Legt das Zielrechteck dieses Texturknotens auf r fest.
Siehe auch „ rect()“.
void QSGSimpleTextureNode::setRect(qreal x, qreal y, qreal w, qreal h)
Legt fest, dass das Rechteck dieses Textur-Knotens bei (x, y) beginnt und eine Breite von w sowie eine Höhe von h hat.
Dies ist eine überladene Funktion.
void QSGSimpleTextureNode::setSourceRect(const QRectF &r)
Legt den Quellbereich dieses Texturknotens auf „ r “ fest.
Siehe auch „ sourceRect()“.
void QSGSimpleTextureNode::setSourceRect(qreal x, qreal y, qreal w, qreal h)
Legt das Rechteck dieses Texturknotens so fest, dass seine Textur von (x, y) aus angezeigt wird und eine Breite von w sowie eine Höhe von h relativ zu QSGTexture::textureSize aufweist.
Dies ist eine überladene Funktion.
void QSGSimpleTextureNode::setTexture(QSGTexture *texture)
Legt die Textur dieses Texturknotens auf „ texture “ fest.
Verwenden Sie „ setOwnsTexture()“, um festzulegen, ob der Knoten die Eigentumsrechte an der Textur übernehmen soll. Standardmäßig übernimmt der Knoten keine Eigentumsrechte.
Warnung: Ein Texturknoten muss über eine Textur verfügen, bevor er zum Szenengraphen hinzugefügt und gerendert werden kann.
Siehe auch „ texture()“.
void QSGSimpleTextureNode::setTextureCoordinatesTransform(QSGSimpleTextureNode::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().
QRectF QSGSimpleTextureNode::sourceRect() const
Gibt das Quellrechteck dieses Texturknotens zurück.
Siehe auch „ setSourceRect()“.
QSGTexture *QSGSimpleTextureNode::texture() const
Gibt die Textur für diesen Texturknoten zurück
Siehe auch „ setTexture()“.
QSGSimpleTextureNode::TextureCoordinatesTransformMode QSGSimpleTextureNode::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.
