PySide6.QtQuick.QSGClipNode¶

class QSGClipNode¶

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

概要¶

方法¶

• def __init__()

• def clipRect()

• def isRectangular()

• def setClipRect()

• def setIsRectangular()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

裁剪适用于节点的子树，并且可以嵌套。多个裁剪节点将通过相交所有它们的几何形状来累积。这种累积作为渲染的一部分发生。

剪辑节点在添加到场景图之前必须具有几何体。

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

注意

所有带有QSG前缀的类应仅在场景图的渲染线程上使用。有关更多信息，请参见场景图和渲染。

__init__()¶

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

剪辑节点在添加到场景图之前必须具有几何体。

clipRect()¶

Return type:

QRectF

返回此节点的裁剪矩形。

另请参阅

setClipRect()

isRectangular()¶

Return type:

布尔

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

另请参阅

setIsRectangular()

setClipRect(rect)¶

Parameters:

矩形 – QRectF

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

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

另请参阅

clipRect()

setIsRectangular(rectHint)¶

Parameters:

rectHint – 布尔值

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

这是一个优化提示，意味着渲染器可以使用剪裁而不是模板，这将显著加快速度。

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

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

另请参阅

isRectangular()