PyQt：如何使用圆弧实现由width控制的动态闭合轮廓形状

一、arcMoveTo与arcTo的核心差异 #

• arcMoveTo()：仅将画笔移动到圆弧的起始位置，不绘制任何线条，作用是精准定位画笔，为后续绘制操作做准备。
• arcTo()：先从当前画笔位置绘制一条直线到圆弧起始点，接着绘制指定的圆弧，是“移动+绘制”的组合操作，若当前画笔位置与圆弧起点不重合，会产生额外连接线。

二、实现动态无接缝闭合轮廓的思路与代码示例 #

假设原有蓝色形状是左侧半圆+右侧矩形的闭合图形，我们通过width变量拆分半圆，添加水平段形成新的闭合轮廓，确保无断点、无接缝：

void YourWidget::paintEvent(QPaintEvent *event)
{
    QPainter painter(this);
    painter.setRenderHint(QPainter::Antialiasing);
    // 设置画笔为蓝色，圆角笔帽/连接，消除细微接缝
    painter.setPen(QPen(Qt::blue, 2, Qt::SolidLine, Qt::RoundCap, Qt::RoundJoin));
    painter.setBrush(Qt::NoBrush);

    int width = 50; // 可动态调整的水平段长度变量
    // 原有形状的基础参数
    int centerX = 100;
    int centerY = 100;
    int radius = 50;
    int rightRectEdge = 150;
    QRectF arcRect(centerX - radius, centerY - radius, 2*radius, 2*radius);

    QPainterPath newPath;
    // 1. 定位到原有形状的右上角起点，开始绘制
    newPath.moveTo(rightRectEdge, centerY - radius);
    // 2. 绘制右侧矩形的上边
    newPath.lineTo(centerX, centerY - radius);
    // 3. 绘制上半段圆弧：用arcMoveTo定位（避免多余线条），再用arcTo绘制
    newPath.arcMoveTo(arcRect, 90 * 16); // QPainter角度单位为1/16度，90度对应顶部
    newPath.arcTo(arcRect, 90 * 16, 90 * 16); // 从90度到180度，跨度90*16
    // 4. 绘制动态水平段
    newPath.lineTo(centerX - radius + width, centerY);
    // 5. 绘制下半段圆弧：从拆分点对应位置到圆弧底部
    newPath.arcMoveTo(arcRect, 180 * 16);
    newPath.arcTo(arcRect, 180 * 16, 90 * 16); // 从180度到270度，跨度90*16
    // 6. 绘制右侧矩形的下边，闭合路径
    newPath.lineTo(rightRectEdge, centerY + radius);
    newPath.lineTo(rightRectEdge, centerY - radius);

    painter.drawPath(newPath);
}

三、关键注意事项 #

• 无接缝技巧：确保每一段路径的终点与下一段的起点完全重合，同时使用Qt::RoundCap和Qt::RoundJoin的画笔设置，消除细微接缝。
• arcMoveTo的作用：在绘制圆弧前用它定位，避免画笔从初始位置（如(0,0)）画多余直线到圆弧起点，保证路径的连续性。
• 动态更新：只需修改width变量，触发paintEvent重新绘制即可实现形状的动态调整。

内容的提问来源于stack exchange，提问作者user2407089