QSGClipNode Class

The QSGClipNode class implements the clipping functionality in the scene graph. 更多...

头: #include <QSGClipNode>
CMake: find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake: QT += quick
继承: QSGBasicGeometryNode

公共函数

QSGClipNode ()
virtual ~QSGClipNode () override
QRectF clipRect () const
bool isRectangular () const
void setClipRect (const QRectF & rect )
void setIsRectangular (bool rectHint )

详细描述

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.

注意: 所有带有 QSG 前缀的类只应用于场景图形渲染线程。见 场景图形和渲染 了解更多信息。

成员函数文档编制

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.

另请参阅 setClipRect ().

bool QSGClipNode:: isRectangular () const

Returns if this clip node has a rectangular clip.

另请参阅 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.

另请参阅 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 () 而不是 geometry ().

默认情况下此特性为 false .

另请参阅 isRectangular ().