QSGClipNode Class
The QSGClipNode class implements the clipping functionality in the scene graph. More...
| Header: | #include <QSGClipNode> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Inherits: | QSGBasicGeometryNode |
- List of all members, including inherited members
- QSGClipNode is part of Qt Quick Scene Graph Node classes.
Public Functions
| QSGClipNode() | |
| virtual | ~QSGClipNode() override |
| QRectF | clipRect() const |
| bool | isRectangular() const |
| void | setClipRect(const QRectF &rect) |
| void | setIsRectangular(bool rectHint) |
Detailed Description
Clipping applies to the node's subtree and can be nested. Multiple clip nodes will be accumulated by intersecting all their geometries. The accumulation happens as part of the rendering.
Clip nodes must have a geometry before they can be added to the scene graph.
Clipping is usually implemented by using the stencil buffer.
Note: All classes with QSG prefix should be used solely on the scene graph's rendering thread. See Scene Graph and Rendering for more information.
Member Function Documentation
QSGClipNode::QSGClipNode()
Creates a new QSGClipNode without a geometry.
The clip node must have a geometry before it can be added to the scene graph.
[override virtual noexcept] QSGClipNode::~QSGClipNode()
Deletes this QSGClipNode.
If the flag QSGNode::OwnsGeometry is set, the geometry will also be deleted.
QRectF QSGClipNode::clipRect() const
Returns the clip rect of this node.
See also setClipRect().
bool QSGClipNode::isRectangular() const
Returns if this clip node has a rectangular clip.
See also setIsRectangular().
void QSGClipNode::setClipRect(const QRectF &rect)
Sets the clip rect of this clip node to rect.
When a rectangular clip is set in combination with setIsRectangular the renderer may in some cases use a more optimal clip method.
See also clipRect().
void QSGClipNode::setIsRectangular(bool rectHint)
Sets whether this clip node has a rectangular clip to rectHint.
This is an optimization hint which means that the renderer can use scissoring instead of stencil, which is significantly faster.
When this hint is set and it is applicable, the clip region will be generated from clipRect() rather than geometry().
By default this property is false.
See also isRectangular().