QSGClipNode Class
La classe QSGClipNode met en œuvre la fonctionnalité de découpage dans le graphe de scène. En savoir plus...
| En-tête : | #include <QSGClipNode> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| Hérite de : | QSGBasicGeometryNode |
- Liste de tous les membres, y compris les membres hérités
- QSGClipNode fait partie des classes de nœuds de graphe de scène d'Qt Quick .
Fonctions publiques
| QSGClipNode() | |
| virtual | ~QSGClipNode() override |
| QRectF | clipRect() const |
| bool | isRectangular() const |
| void | setClipRect(const QRectF &rect) |
| void | setIsRectangular(bool rectHint) |
Description détaillée
Le découpage s'applique à la sous-arborescence du nœud et peut être imbriqué. Plusieurs nœuds de découpage seront cumulés en intersectant toutes leurs géométries. Le cumul s'effectue dans le cadre du rendu.
Les nœuds de découpage doivent disposer d’une géométrie avant de pouvoir être ajoutés au graphe de scène.
Le découpage est généralement implémenté à l'aide du tampon de stencil.
Remarque : toutes les classes dont le nom commence par « QSG » doivent être utilisées exclusivement sur le thread de rendu du graphe de scène. Voir Graphe de scène et rendu pour plus d’informations.
Documentation des fonctions membres
QSGClipNode::QSGClipNode()
Crée un nouveau nœud `QSGClipNode` sans géométrie.
Le nœud de découpe doit disposer d'une géométrie avant de pouvoir être ajouté au graphe de scène.
[override virtual noexcept] QSGClipNode::~QSGClipNode()
Supprime cette QSGClipNode.
Si l'indicateur « QSGNode::OwnsGeometry » est activé, la géométrie sera également supprimée.
QRectF QSGClipNode::clipRect() const
Renvoie le rectangle de découpe de ce nœud.
Voir aussi setClipRect().
bool QSGClipNode::isRectangular() const
Indique si ce nœud de découpe dispose d'une découpe rectangulaire.
Voir aussi ` setIsRectangular()`.
void QSGClipNode::setClipRect(const QRectF &rect)
Définit le rectangle de découpe de ce nœud de découpe sur rect.
Lorsqu'un rectangle de découpe est défini en combinaison avec ` setIsRectangular `, le moteur de rendu peut, dans certains cas, utiliser une méthode de découpe plus optimale.
Voir également clipRect().
void QSGClipNode::setIsRectangular(bool rectHint)
Détermine si ce nœud de découpe dispose d'une découpe rectangulaire à l'adresse rectHint.
Il s’agit d’une indication d’optimisation qui permet au moteur de rendu d’utiliser le « scissoring » à la place du « stencil », ce qui est nettement plus rapide.
Lorsque cette indication est activée et qu’elle est applicable, la région de découpe sera générée à partir de ` clipRect()` plutôt que de ` geometry()`.
Par défaut, cette propriété est définie sur ` false`.
Voir également 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.
