QSGClipNode Class
Die Klasse „QSGClipNode“ implementiert die Clipping-Funktionalität im Szenengraphen. Mehr...
| Header: | #include <QSGClipNode> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Erbt von: | QSGBasicGeometryNode |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QSGClipNode ist Teil der „Qt Quick “-Klassen für Szenengraph-Knoten.
Öffentliche Funktionen
| QSGClipNode() | |
| virtual | ~QSGClipNode() override |
| QRectF | clipRect() const |
| bool | isRectangular() const |
| void | setClipRect(const QRectF &rect) |
| void | setIsRectangular(bool rectHint) |
Ausführliche Beschreibung
Das Clipping gilt für den Teilbaum des Knotens und kann verschachtelt werden. Mehrere Clip-Knoten werden durch Schnittbildung aller ihrer Geometrien akkumuliert. Die Akkumulierung erfolgt im Rahmen des Renderings.
Clip-Knoten müssen über eine Geometrie verfügen, bevor sie zum Szenenbaum hinzugefügt werden können.
Das Clipping wird in der Regel mithilfe des Stencil-Puffers implementiert.
Hinweis: Alle Klassen mit dem Präfix „QSG“ sollten ausschließlich im Rendering-Thread des Szenengraphen verwendet werden. Weitere Informationen finden Sie unter „Szenengraph und Rendering “.
Dokumentation der Mitgliedsfunktionen
QSGClipNode::QSGClipNode()
Erstellt einen neuen QSGClipNode ohne Geometrie.
Der Clip-Knoten muss über eine Geometrie verfügen, bevor er zum Szenengraphen hinzugefügt werden kann.
[override virtual noexcept] QSGClipNode::~QSGClipNode()
Löscht diese „ QSGClipNode “.
Wenn das Flag „ QSGNode::OwnsGeometry “ gesetzt ist, wird auch die Geometrie gelöscht.
QRectF QSGClipNode::clipRect() const
Gibt den Ausschnittbereich dieses Knotens zurück.
Siehe auch „ setClipRect()“.
bool QSGClipNode::isRectangular() const
Gibt zurück, ob dieser Clip-Knoten über einen rechteckigen Ausschnitt verfügt.
Siehe auch „ setIsRectangular()“.
void QSGClipNode::setClipRect(const QRectF &rect)
Legt den Clip-Bereich dieses Clip-Knotens auf „ rect “ fest.
Wenn ein rechteckiger Ausschnitt in Kombination mit „ setIsRectangular “ festgelegt wird, verwendet der Renderer in manchen Fällen möglicherweise eine optimalere Ausschnittmethode.
Siehe auch ` clipRect()`.
void QSGClipNode::setIsRectangular(bool rectHint)
Legt fest, ob dieser Clip-Knoten einen rechteckigen Clip gemäß rectHint aufweist.
Dies ist ein Optimierungshinweis, der bedeutet, dass der Renderer „Scissoring“ anstelle von „Stencil“ verwenden kann, was deutlich schneller ist.
Wenn dieser Hinweis gesetzt ist und anwendbar ist, wird der Ausschnittbereich anhand von ` clipRect()` statt anhand von ` geometry()` generiert.
Standardmäßig ist diese Eigenschaft auf „ false “ gesetzt.
Siehe auch ` isRectangular()`.
© 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.
