QCanvasPath Class

成员函数文档

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 的副本。

QCanvasPath::QCanvasPath(QCanvasPath &&other)

移动-从other 构建一个新的 QCanvasPath。

[noexcept] QCanvasPath::~QCanvasPath()

摧毁路径

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(float centerX, float centerY, float radius, float a0, float 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, float radius, float a0, float a1, QCanvasPainter::PathWinding direction = QCanvasPainter::PathWinding::ClockWise, QCanvasPainter::PathConnection connection = QCanvasPainter::PathConnection::Connected)

以给定的radius 为中心，创建一条以a0 弧度为起点、以a1 弧度为终点、以centerPoint 为中心的弧线。弧线跨越给定的direction 。当connection 为NotConnected 时，前一条路径被关闭，并开始一条新的子路径。

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

使用点QPointF(x1,y1) 和QPointF(x2,y2) 与给定的radius 创建一条弧。

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

使用点point1 和point2 以及给定的radius 创建一条弧。

void QCanvasPath::beginHoleSubPath()

启动孔子路径。这等同于setPathWinding(QCanvasPainter::PathWinding::ClockWise))

另请参见 beginSolidSubPath().

void QCanvasPath::beginSolidSubPath()

启动实心子路径。这等同于setPathWinding(QCanvasPainter::PathWinding::CounterClockWise))

另请参见 beginHoleSubPath().

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

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

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

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

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

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

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

将圆心位于QPointF(x,y) 和给定的radius 的圆添加到路径中。

void QCanvasPath::circle(QPointF centerPoint, float 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(float x, float y, float radiusX, float 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(float x, float y)

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

void QCanvasPath::moveTo(QPointF point)

将当前点移动到给定的point ，隐式启动一个新的子路径并关闭前一个子路径。

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

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

QPointF QCanvasPath::positionAt(qsizetype index) const

返回路径在index 的位置。这意味着路径命令（moveTo,lineTo,bezierCurveTo 等）在index 的位置。索引必须在0 和commandsSize() - 1 之间。如果路径为空，则返回 (0.0, 0.0)。

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

在当前点和端点 (x,y) 之间添加一条二次贝塞尔曲线，控制点由 (cpX,cpY) 指定。

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

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

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

用给定的width 和height 创建一个矩形，其位置为QPointF(x,y) 。

void QCanvasPath::rect(const QRectF &rect)

创建一个由rect

void QCanvasPath::reserve(qsizetype commandsSize, qsizetype commandsDataSize)

在QCanvasPath 的内部内存中预留一定的空间。

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

预留正确空间是对路径创建和内存使用的优化。它不是强制性的，因为在向路径中添加命令时会自动确保足够的空间。

另请参见 squeeze()、commandsCapacity() 和commandsDataCapacity()。

void QCanvasPath::reserve(qsizetype commandsSize)

在QCanvasPath 的内部存储器中保留一定的空间。

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

会自动为2 * commandsSize 的数据量预留空间，当路径命令为直线（moveTo(),lineTo(),rect() ）时，这是最佳的数据量。

预留正确的空间是对路径创建和内存使用的优化。它不是强制性的，因为在向路径中添加命令时会自动确保足够的空间。

另请参见 squeeze()、commandsCapacity() 和commandsDataCapacity()。

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

将给定的带圆角的矩形x,y,width,height 添加到路径中。圆角是四分之一圆，其给定值为radius 。

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

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

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

将给定的带圆角的矩形rect 添加到路径中。圆角是四分之一圆，其给定值为radius 。

void QCanvasPath::roundRect(const QRectF &rect, float radiusTopLeft, float radiusTopRight, float radiusBottomRight, float 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)

Move-assignsother 到此QCanvasPath 实例。

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

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