QCanvasPath Class

// m_path is QCanvasPath with lots of commands in it
const int pathGroup = 5;

// in every frame:
  painter->stroke(m_path, pathGroup);
  // ... other draw commands
  painter->translate(100, 0);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands

// m_path is QCanvasPath with lots of commands in it
const int pathGroup = 5;

// in every frame:
  painter->setStrokeWidth(4);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands
  painter->translate(100, 0);
  painter->setStrokeWidth(8);
  painter->stroke(m_path, pathGroup);
  // ... other draw commands

成员函数文档

QCanvasPath::QCanvasPath()

构建一个空路径。

[explicit] QCanvasPath::QCanvasPath(qsizetype commandsSize, qsizetype commandsDataSize = -1)

构建一个空路径，为commandsSize 个命令分配空间，并可选地为commandsDataSize 的数据分配空间。如果未提供commandsDataSize 参数，系统会自动为2 * commandsSize 的数据预留空间，当路径命令为直线时（moveTo()、lineTo()、rect()），这是最优的数据量。

预留正确的空间是路径创建和内存使用的一种优化措施。这并非强制要求，因为在向路径添加命令时，系统会自动确保有足够的空间。

另请参阅 reserve()。

QCanvasPath::QCanvasPath(const QCanvasPath &path)

构建一条路径，该路径是给定path 的副本。

[noexcept] QCanvasPath::QCanvasPath(QCanvasPath &&other)

从other 创建一个新的QCanvasPath对象。

[noexcept] QCanvasPath::~QCanvasPath()

删除该路径。

[since 6.12] void QCanvasPath::addPath(QStringView svgPath, const QTransform &transform = QTransform())

将svgPath 添加到该路径中，可选地使用transform 来修改路径点。如果已知路径的估计大小，请考虑在此之前调用reserve()。

有关此格式的更多详细信息，请参阅W3C SVG 路径数据。

该函数于 Qt 6.12 中引入。

void QCanvasPath::addPath(const QCanvasPath &path, const QTransform &transform = QTransform())

将path 添加到该路径中，可选地使用transform 来修改路径节点。当未提供transform （或其值为单位矩阵）时，由于该操作会复用路径数据，因此执行速度非常快。

void QCanvasPath::addPath(const QCanvasPath &path, qsizetype start, qsizetype count, const QTransform &transform = QTransform())

将path 添加到当前路径中，从start 处的命令开始，并包含count 个命令。可选地使用transform 来修改路径节点。系统会检查start 和count 的范围，以确保访问的命令数量不超过QCanvasPath::commandsSize()。如果路径不应从当前路径位置继续，请先调用moveTo()，并传入path.positionAt(start - 1) 。

void QCanvasPath::arc(qreal centerX, qreal centerY, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

创建一个以QPointF （centerX ，centerY ）为中心的弧，其radius 为给定值，起始角度为a0 弧度，结束角度为a1 弧度。该弧的跨度为给定的direction 。当connection 为NotConnected 时，将关闭前一条路径并开始一条新的子路径。

void QCanvasPath::arc(QPointF centerPoint, qreal radius, qreal a0, qreal a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

创建一个以centerPoint 为中心的弧，其radius 为给定值，起始角度为a0 弧度，结束角度为a1 弧度。该弧的跨度为给定的direction 。当connection 为NotConnected 时，前一条路径将闭合，并开始一条新的子路径。

void QCanvasPath::arcTo(qreal x1, qreal y1, qreal x2, qreal y2, qreal radius)

使用点QPointF （x1 ，y1 ）和QPointF （x2 ，y2 ），并采用给定的radius ，绘制一条弧。

void QCanvasPath::arcTo(QPointF point1, QPointF point2, qreal radius)

使用点point1 和point2 ，并根据给定的radius 创建一个弧。

void QCanvasPath::beginHoleSubPath()

开始一个孔子路径。这相当于setPathWinding(QCanvasPainter::PathWinding::ClockWise))

另请参阅 beginSolidSubPath()。

void QCanvasPath::beginSolidSubPath()

开始一个完整的子路径。这等同于setPathWinding(QCanvasPainter::PathWinding::CounterClockWise))

另请参阅 beginHoleSubPath()。

void QCanvasPath::bezierCurveTo(qreal cp1X, qreal cp1Y, qreal cp2X, qreal cp2Y, qreal x, qreal y)

在当前位置与由x 和y 指定的终点之间添加一条三次贝塞尔曲线，使用由cp1X 、cp1Y 、cp2X 和cp2Y 指定的控制点。

添加曲线后，当前位置将更新为曲线的终点。

void QCanvasPath::bezierCurveTo(QPointF controlPoint1, QPointF controlPoint2, QPointF endPoint)

在当前位置与给定的endPoint 之间，使用由controlPoint1 和controlPoint2 指定的控制点，添加一条三次贝塞尔曲线。

曲线添加完成后，当前位置将更新为该曲线的终点。

void QCanvasPath::circle(qreal x, qreal y, qreal radius)

将一个圆添加到路径中，该圆的圆心位于QPointF （x ，y ），半径为给定的radius 。

void QCanvasPath::circle(QPointF centerPoint, qreal radius)

向路径中添加一个圆，其圆心位于centerPoint ，半径为给定的radius 。

void QCanvasPath::clear()

清除路径命令和数据。

当路径命令发生变化时，调用此函数以重新生成路径。这不会影响内存使用，若需管理内存，请使用reserve() 和squeeze()。

另请参阅 reserve() 和squeeze()。

void QCanvasPath::closePath()

通过绘制一条连接至当前子路径起点的直线来结束该子路径，并自动开始绘制新路径。

qsizetype QCanvasPath::commandsCapacity() const

返回路径中命令的容量。

另请参阅 commandsDataCapacity() 和reserve()。

qsizetype QCanvasPath::commandsDataCapacity() const

返回路径中命令数据的容量。

另请参阅 commandsCapacity() 和reserve()。

qsizetype QCanvasPath::commandsDataSize() const

返回路径中命令数据的数量。

命令数据基本上指的是命令所需的点。

qsizetype QCanvasPath::commandsSize() const

返回路径中的命令数量。

QPointF QCanvasPath::currentPosition() const

返回路径的当前位置。即上一个路径命令（moveTo 、lineTo 、bezierCurveTo 等）结束时的位置。当路径为空时，返回 (0.0, 0.0)。

void QCanvasPath::ellipse(qreal x, qreal y, qreal radiusX, qreal radiusY)

创建一个以 (x,y) 为中心的椭圆，其半径由radiusX 和radiusY 定义，并将其作为闭合子路径添加到路径中。

void QCanvasPath::ellipse(const QRectF &rect)

在矩形rect 内创建一个椭圆，并将其作为闭合子路径添加到路径中。

bool QCanvasPath::isEmpty() const

当路径为空时返回 true。

另请参阅 clear 。

void QCanvasPath::lineTo(QPointF point)

从当前位置到指定的point 绘制一条直线。绘制完成后，当前位置将更新为该直线的终点。

void QCanvasPath::lineTo(qreal x, qreal y)

从当前位置到点 (x,y) 绘制一条直线。

void QCanvasPath::moveTo(QPointF point)

将当前点移动到指定的point ，同时隐式地开始一个新的子路径并关闭之前的子路径。

void QCanvasPath::moveTo(qreal x, qreal y)

将当前位置移动到 (x,y)，并开始一个新的子路径，同时隐式关闭之前的路径。

QPointF QCanvasPath::positionAt(qsizetype index) const

返回路径在index 中的位置。这指的是path命令（moveTo 、lineTo 、bezierCurveTo 等）在index 中的位置。索引值必须介于0 和commandsSize() - 1之间。当路径为空时，返回(0.0, 0.0)。

void QCanvasPath::quadraticCurveTo(qreal cpX, qreal cpY, qreal x, qreal y)

在当前点与端点（x ，y ）之间添加一条二次贝塞尔曲线，其控制点由（cpX ，cpY ）指定。

void QCanvasPath::quadraticCurveTo(QPointF controlPoint, QPointF endPoint)

在当前位置与给定的endPoint 之间添加一条二次贝塞尔曲线，其控制点由controlPoint 指定。

void QCanvasPath::rect(qreal x, qreal y, qreal width, qreal height)

创建一个矩形，其位置为QPointF （x ，y ），并采用给定的width 和height 。

void QCanvasPath::rect(const QRectF &rect)

创建一个由rect

void QCanvasPath::reserve(qsizetype commandsSize, qsizetype commandsDataSize = -1)

在QCanvasPath 的内部内存中预留指定大小的空间。

尝试为至少commandsSize 条命令和commandsDataSize 个数据点分配内存。某些路径元素需要多条命令，请参见commandsSize() 和commandsDataSize()。

如果未指定commandsDataSize ，则会自动为2 * commandsSize 数量的数据预留空间，当路径命令为直线时（如moveTo()、lineTo()、rect()，这是最优数量。

预留正确的空间是路径创建和内存使用的一项优化措施。这并非强制要求，因为在向路径中添加命令时，系统会自动确保有足够的空间。

另请参阅 squeeze(),commandsCapacity() 和commandsDataCapacity()。

void QCanvasPath::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radius)

将给定的矩形x 、y 、width 、height （带圆角）添加到路径中。这些圆角为四分之一圆，其半径为给定的radius 。

void QCanvasPath::roundRect(qreal x, qreal y, qreal width, qreal height, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

将具有圆角的矩形x 、y 、width 、height 添加到路径中。这些圆角分别是半径为radiusTopLeft 、radiusTopRight 、radiusBottomRight 和radiusBottomLeft 的四分之一圆。

void QCanvasPath::roundRect(const QRectF &rect, qreal radius)

将给定的矩形rect （带圆角）添加到路径中。圆角为四分之一圆，其参数由radius 指定。

void QCanvasPath::roundRect(const QRectF &rect, qreal radiusTopLeft, qreal radiusTopRight, qreal radiusBottomRight, qreal radiusBottomLeft)

将矩形rect （带圆角）添加到路径中。这些圆角分别是半径分别为radiusTopLeft 、radiusTopRight 、radiusBottomRight 和radiusBottomLeft 的四分之一圆。

void QCanvasPath::setPathWinding(QCanvasPainter::PathWinding winding)

将当前子路径winding 设置为QCanvasPainter::CounterClockWise （默认）或QCanvasPainter::ClockWise 。CounterClockWise绘制实心子路径，而ClockWise绘制孔洞。

QCanvasPath QCanvasPath::sliced(qsizetype start, qsizetype count, const QTransform &transform = QTransform()) const

返回一个新路径，其中包含该路径中的命令，从start 处的命令开始，并包含count 数量的命令，可选地使用transform 来更改路径节点。

系统会检查start 和count 的范围，以确保访问的命令数量不超过commandsSize()。如果start 处的命令不是MoveTo ，则将第一个命令替换为MoveTo ，以便该切片成为一个独立的路径。

void QCanvasPath::squeeze()

释放除存储路径命令和数据外不再需要的内存。这可用于在调用reserve() 之后减少内存占用。

通常无需使用此方法，但在因预留或添加大量元素（如lineTo 、bezierCurveTo 等）导致路径大小过大，且预计未来路径大小将大幅缩小时，先调用reserve() 再调用squeeze() ，可释放部分内存。

另请参阅 reserve()。

[noexcept] void QCanvasPath::swap(QCanvasPath &other)

将此路径与other 互换。此操作速度极快，且绝不会失败。

QCanvasPath::operator QVariant() const

将路径作为QVariant 返回。

[noexcept] QCanvasPath &QCanvasPath::operator=(QCanvasPath &&other)

将other 通过Move-assigns操作赋值给此QCanvasPath 实例。

QCanvasPath &QCanvasPath::operator=(const QCanvasPath &path)

将给定的path 分配给此路径，并返回对此路径的引用。