QSGClipNode Class
Die Klasse QSGClipNode implementiert die Clipping-Funktionalität im Szenegraphen. Mehr...
| Kopfzeile: | #include <QSGClipNode> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Vererbt: | QSGBasicGeometryNode |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- QSGClipNode ist Teil der Qt Quick Scene Graph Node Klassen.
Öffentliche Funktionen
| QSGClipNode() | |
| virtual | ~QSGClipNode() override |
| QRectF | clipRect() const |
| bool | isRectangular() const |
| void | setClipRect(const QRectF &rect) |
| void | setIsRectangular(bool rectHint) |
Detaillierte Beschreibung
Clipping gilt für den Unterbaum des Knotens und kann verschachtelt werden. Mehrere Clip-Knoten werden durch Überschneidung aller ihrer Geometrien akkumuliert. Die Akkumulation erfolgt als Teil des Renderings.
Clip-Knoten müssen eine Geometrie haben, bevor sie dem Szenengraph hinzugefügt werden können.
Das Clipping wird in der Regel durch die Verwendung des Stencil-Buffers realisiert.
Hinweis: Alle Klassen mit dem Präfix QSG sollten ausschließlich im Rendering-Thread des Szenegraphen verwendet werden. Siehe Szenengraph und Rendering für weitere Informationen.
Dokumentation der Mitgliedsfunktionen
QSGClipNode::QSGClipNode()
Erzeugt einen neuen QSGClipNode ohne Geometrie.
Der Clip-Knoten muss eine Geometrie haben, bevor er dem Szenendiagramm hinzugefügt werden kann.
[override virtual noexcept] QSGClipNode::~QSGClipNode()
Löscht diese QSGClipNode.
Wenn das Flag QSGNode::OwnsGeometry gesetzt ist, wird die Geometrie ebenfalls gelöscht.
QRectF QSGClipNode::clipRect() const
Gibt das Clip-Rect dieses Knotens zurück.
Siehe auch setClipRect().
bool QSGClipNode::isRectangular() const
Gibt zurück, ob dieser Clip-Knoten einen rechteckigen Clip hat.
Siehe auch setIsRectangular().
void QSGClipNode::setClipRect(const QRectF &rect)
Setzt das Clip-Rect dieses Clip-Knotens auf rect.
Wenn ein rechteckiger Clip in Kombination mit setIsRectangular festgelegt wird, kann der Renderer in einigen Fällen eine optimalere Clipmethode verwenden.
Siehe auch clipRect().
void QSGClipNode::setIsRectangular(bool rectHint)
Legt fest, ob dieser Clip-Knoten einen rechteckigen Clip auf rectHint hat.
Dies ist ein Optimierungshinweis, der bedeutet, dass der Renderer Scissoring anstelle von Stencil verwenden kann, was deutlich schneller ist.
Wenn dieser Hinweis gesetzt und anwendbar ist, wird der Clip-Bereich von clipRect() und nicht von geometry() erzeugt.
Standardmäßig ist diese Eigenschaft auf false gesetzt.
Siehe auch isRectangular().
© 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.
