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.
Konstante | Wert | Beschreibung |
---|---|---|
QSGImageNode::NoTransform | 0x00 | Die Texturkoordinaten orientieren sich an den Fensterkoordinaten, d.h. der Ursprung befindet sich oben links. |
QSGImageNode::MirrorHorizontally | 0x01 | Die Texturkoordinaten werden in der horizontalen Achse in Bezug auf die Fensterkoordinaten invertiert. |
QSGImageNode::MirrorVertically | 0x02 | Die 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.