QSGClipNode Class
La clase QSGClipNode implementa la funcionalidad de recorte en el grafo de escena. Más información...
| Encabezado: | #include <QSGClipNode> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Heredan: | QSGBasicGeometryNode |
- Lista de todos los miembros, incluidos los heredados
- QSGClipNode forma parte de las clases de nodos del grafo de escena deQt Quick .
Funciones públicas
| QSGClipNode() | |
| virtual | ~QSGClipNode() override |
| QRectF | clipRect() const |
| bool | isRectangular() const |
| void | setClipRect(const QRectF &rect) |
| void | setIsRectangular(bool rectHint) |
Descripción detallada
El recorte se aplica al subárbol del nodo y puede anidarse. Los múltiples nodos de recorte se acumularán mediante la intersección de todas sus geometrías. La acumulación tiene lugar como parte del renderizado.
Los nodos de recorte deben tener una geometría antes de poder añadirse al grafo de escena.
El recorte suele implementarse utilizando el búfer de estarcido.
Nota: Todas las clases con el prefijo QSG deben utilizarse exclusivamente en el hilo de renderizado del grafo de escena. Consulta «Grafo de escena y renderizado» para obtener más información.
Documentación de las funciones miembro
QSGClipNode::QSGClipNode()
Crea un nuevo QSGClipNode sin geometría.
El nodo de recorte debe tener una geometría antes de poder añadirse al grafo de escena.
[override virtual noexcept] QSGClipNode::~QSGClipNode()
Elimina este QSGClipNode.
Si está activado el indicador « QSGNode::OwnsGeometry », también se eliminará la geometría.
QRectF QSGClipNode::clipRect() const
Devuelve el rectángulo de recorte de este nodo.
Véase también setClipRect().
bool QSGClipNode::isRectangular() const
Devuelve si este nodo de recorte tiene un recorte rectangular.
Véase también setIsRectangular().
void QSGClipNode::setClipRect(const QRectF &rect)
Establece el rectángulo de recorte de este nodo de recorte en rect.
Cuando se establece un recorte rectangular en combinación con setIsRectangular, el renderizador puede, en algunos casos, utilizar un método de recorte más óptimo.
Véase también ` clipRect()`.
void QSGClipNode::setIsRectangular(bool rectHint)
Establece si este nodo de recorte tiene un recorte rectangular en rectHint.
Se trata de una sugerencia de optimización que permite al renderizador utilizar el método «scissoring» en lugar de «stencil», lo cual es significativamente más rápido.
Cuando se establece esta sugerencia y es aplicable, la región de recorte se generará a partir de clipRect() en lugar de geometry().
Por defecto, esta propiedad es false.
Véase también 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.