QPainterPath

QPainterPath 类（绘图路径）提供了一个容器，用于绘图操作，可以创建和重用图形形状。

绘图路径是由许多图形化的构建块组成的对象，例如：矩形、椭圆、直线和曲线。构建块可以加入在封闭的子路径中，例如：矩形或椭圆。封闭的路径的起点和终点是一致的，或者他们可以作为未封闭的子路径独立存在，如：直线和曲线。

QPainterPath 可以被填充、描绘轮廓、裁剪。要为一个指定的绘图路径生成可填充的轮廓，可以使用 QPainterPathStroker 类。与正常绘图相比，QPainterPath 的主要优点在于：复杂的图形只需创建一次，然后只需调用 QPainter::drawPath() 函数即可绘制多次。

QPainterPath 提供了一组函数，可用于获取绘图路径及其元素的信息。除了可以使用 toReversed() 函数来改变元素的顺序外，还有几个函数将 QPainterPath 对象转换成一个多边形表示

QPainterPath 对象的 currentPosition() 始终是最后一个添加的子路径的最终位置（或初始起点），使用 moveTo() 函数可以在不增加组件的情况下移动 currentPositon()，moveTo() 函数会隐式地启动一个新的子路径，并关闭前一个。启动新的子路径的另一种方式是调用 closeSubpath() 函数，该函数通过添加一条直线（从 currentPosition() 到起始位置）来关闭当前路径。注意：新路径将 (0, 0) 作为其初始 currentPosition()。

QPainterPath 也提供了一些便利的函数来添加一个封闭的子路径 - addEllipse()、addPath()、 addRect()、addRegion() 和 addText()。addPolygon() 函数添加一个未封闭的子路径。事实上，这些函数都是 moveTo()、lineTo()、cubicTo() 操作的集合。

此外，使用 connectPath() 函数将路径添加至当前路径。但需要注意，该函数将通过添加一条直线，将当前路径的最后一个元素连接到给定的第一个元素。

QPainterPath 信息

QPainterPath 类提供了一组函数，用于返回有关该路径及其元素的信息。

currentPosition() 函数返回被添加的最后一个子路径的终点（或初始起始点）。elementAt() 函数可用于检索各种子路径元素，可以使用 elementCount() 函数检索元素的数量，isEmpty() 函数可以告诉该 QPainterPath 对象是否包含任何元素。

controlPointRect() 函数返回包含此路径中所有点和控制点的矩形。与使用浮点精度返回此画家路径的边界矩形的精确的 boundingRect() 相比，此函数的计算速度要快得多。

最后，QPainterPath 提供了 contains() 函数，用于确定给定点或矩形是否在路径内。以及 intersects() 函数，用于确定给定矩形内的任何点是否也在该路径内。

QPainterPath 转换

出于兼容性原因，可能需要简化绘图路径的表示形式：QPainterPath 提供的 toFillPolygon()、toFillPolygons（）和 toSubpathPolygons() 函数，用于将绘图路径转换为多边形。toFillPolygon() 将绘图路径作为单个多边形返回，而后两个函数返回一个多边形列表。

提供了 toFillPolygons() 和 toSubpathPolygons() 函数，因为绘制几个小多边形通常比绘制一个大的多边形更快，即使绘制的总点数相同。两者之间的差异是它们返回的多边形数：toSubpathPolygons() 为每个子路径创建一个多边形，而不管相交的子路径（即重叠的边界矩形），而 toFillPolygons() 函数仅为重叠的子路径创建一个多边形。

toFillPolygon() 和 toFillPolygons() 函数首先将所有子路径转换为多边形，然后使用重卷技术确保可以使用正确的填充规则来填充重叠的子路径。注意：重卷会在多边形中插入额外的线，因此填充多边形的轮廓与路径的轮廓不匹配。