QSGClipNode 类

QSGClipNode 类实现了场景图中的裁剪功能。更多...

头文件	#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)

裁剪适用于节点的子树，可以是嵌套的。多个裁剪节点将通过相交所有它们的几何形状来累积。累积发生在渲染过程中。

裁剪节点在添加到场景图之前必须有一个几何形状。

裁剪通常通过使用模板缓冲区来实现。

注意： 所有以 QSG 前缀开头的类都应该仅在场景图的渲染线程中使用。有关更多信息，请参阅场景图和渲染。

创建一个没有几何形状的新 QSGClipNode。

裁剪节点在添加到场景图之前必须有一个几何形状。

删除此 QSGClipNode。

如果设置了标志 QSGNode::OwnsGeometry，则也会删除几何形状。

返回此节点的裁剪矩形。

另请参阅setClipRect().

返回此裁剪节点是否有矩形裁剪。

另请参阅setIsRectangular().

将此剪辑节点的剪辑矩形设置为矩形。

当设置矩形剪辑并配合 setIsRectangular 时，在某些情况下渲染器可能会使用更优的剪辑方法。

另请参阅 clipRect。

设置此剪辑节点是否具有矩形剪辑为 rectHint。

这是一个优化提示，意味着渲染器可以使用剪裁而不是模版，这将大大提高速度。

当此提示设置且适用时，剪辑区域将根据 clipRect() 生成，而不是 geometry。

默认情况下，此属性值为 false。

另请参阅 isRectangular。