三点绘圆弧的几何实现

在CAD二次开发中，通过三个顶点绘制圆弧是常见的几何构造任务。主流编程语言如C#、C++、VB.NET和Python通过各自的API或库（如AutoCAD .NET API、ObjectARX、pyautocad）提供了实现这一功能的方法。核心逻辑均基于三点确定一个圆的几何原理：先计算圆心和半径，再根据三个点的顺序确定圆弧的起始和终止角度。不同语言在语法、API调用方式和集成环境上有所差异，但核心算法一致。

核心算法与几何原理

无论使用何种语言，通过三点绘制圆弧的通用步骤如下：

1. 输入：三个二维或三维点（P1, P2, P3），其中P1为起点，P3为终点，P2为圆弧上一点。
2. 计算圆心与半径：求解由P1、P2、P3三点确定的圆的圆心坐标和半径。这通常通过求解两条弦（P1P2和P2P3）的中垂线交点来完成。
3. 计算角度：计算从圆心指向P1、P2、P3的向量与参考轴（如X轴）的夹角，以确定圆弧的起始角、终止角以及绘制方向（逆时针/顺时针）。
4. 创建圆弧对象：调用相应API，传入圆心、半径、起始角和终止角等参数，创建圆弧实体并添加到图形数据库。

主流语言实现方法对比

下表对比了在AutoCAD环境中，使用不同主流语言进行二次开发实现三点画圆弧的关键方式：

编程语言	主要开发接口/库	关键类/函数示例	特点与适用场景
C#	AutoCAD .NET API	Arc 类， Transaction 事务	目前最主流、功能最全面的开发方式。面向对象，易于管理，与.NET生态集成好，适合开发复杂插件和应用程序。
C++	ObjectARX	AcGeCircArc2d (几何类)， AcDbArc (数据库实体类)	性能最高，可直接操作CAD底层数据库。复杂度高，适合对性能有极致要求或需要深度定制核心功能的大型项目。
VB.NET	AutoCAD .NET API	与C#使用相同的 Arc 类和 Transaction 模型	语法相对简单，曾是VBA的升级路径。目前社区和资源少于C#，但在遗留项目或特定场景中仍有使用。
Python	pyautocad, comtypes	通过COM接口调用AutoCAD ActiveX API	开发速度快，脚本化能力强，适合自动化、快速原型设计和轻量级任务。性能通常不如.NET或ObjectARX方案。

代码示例详解

以下分别展示C#和Python的具体实现代码。

1. C# 使用 AutoCAD .NET API

这是最标准的企业级开发方式，涉及事务管理和数据库操作。

using Autodesk.AutoCAD.ApplicationServices;
using Autodesk.AutoCAD.DatabaseServices;
using Autodesk.AutoCAD.Geometry;
using Autodesk.AutoCAD.Runtime;

public class ArcCommands
{
    [CommandMethod("DrawArc3P")]
    public void DrawArcByThreePoints()
    {
        Document doc = Application.DocumentManager.MdiActiveDocument;
        Database db = doc.Database;
        Editor ed = doc.Editor;

        // 1. 获取用户输入的三个点（此处简化为固定点示例）
        Point3d p1 = new Point3d(0, 0, 0);
        Point3d p2 = new Point3d(5, 5, 0);
        Point3d p3 = new Point3d(10, 0, 0);

        // 2. 计算圆心和半径 (使用几何类CircularArc2d)
        CircularArc2d arcGeom = new CircularArc2d(p1.Convert2d(), p2.Convert2d(), p3.Convert2d());
        Point2d center2d = arcGeom.Center;
        double radius = arcGeom.Radius;

        // 3. 计算起始角和终止角（弧度）
        Vector2d vecStart = p1.Convert2d() - center2d;
        Vector2d vecEnd = p3.Convert2d() - center2d;
        double startAngle = vecStart.Angle; // 相对于X轴的角度
        double endAngle = vecEnd.Angle;

        // 4. 判断圆弧方向，确保从p1到p3经过p2
        // 计算p2对应的角度
        Vector2d vecMid = p2.Convert2d() - center2d;
        double midAngle = vecMid.Angle;
        // 通过角度调整确保方向正确，此处逻辑需根据三点顺序处理，可能需要对角度进行规范化比较和调整
        // 简化处理：假设三点顺序已构成逆时针圆弧
        if (endAngle < startAngle)
        {
            endAngle += 2 * Math.PI;
        }

        // 5. 创建圆弧实体并添加到数据库
        using (Transaction tr = db.TransactionManager.StartTransaction())
        {
            BlockTableRecord btr = (BlockTableRecord)tr.GetObject(
                db.CurrentSpaceId, OpenMode.ForWrite);

            Arc arc = new Arc(new Point3d(center2d.X, center2d.Y, 0),
                              radius,
                              startAngle,
                              endAngle - startAngle); // 参数：圆心，半径，起始角，总角度

            btr.AppendEntity(arc);
            tr.AddNewlyCreatedDBObject(arc, true);
            tr.Commit();
        }
    }
}

• 关键点 ：使用 CircularArc2d 几何类可以可靠地通过三点计算圆弧几何参数。创建 Arc 数据库实体时，需注意其构造函数参数（圆心、半径、起始角、包含角）。所有数据库操作必须在事务 (Transaction) 内完成。

2. Python 使用 pyautocad 库

这种方式适合编写脚本和自动化任务，代码简洁。

import math
from pyautocad import Autocad, APoint

def draw_arc_3_points(acad, p1, p2, p3):
    """
    通过三个点绘制圆弧
    :param acad: pyautocad连接对象
    :param p1: 起点 (APoint或元组)
    :param p2: 圆弧上一点
    :param p3: 终点
    """
    # 将输入点转换为APoint对象（如果尚未转换）
    pt1 = APoint(p1) if not isinstance(p1, APoint) else p1
    pt2 = APoint(p2) if not isinstance(p2, APoint) else p2
    pt3 = APoint(p3) if not isinstance(p3, APoint) else p3

    # 调用AutoCAD ActiveX的AddArc方法。
    # 注意：AutoCAD的AddArc方法需要圆心、半径、起始角、终止角。
    # 因此需要先通过三点计算圆心和半径。
    # 这里是一个简化的几何计算示例（适用于二维点）：
    # 计算弦的中垂线交点得到圆心 (实际项目应使用更稳健的几何库)
    def perpendicular_bisector(pA, pB):
        # 返回中垂线的 (斜率k, 中点x, 中点y)
        mid_x = (pA.x + pB.x) / 2.0
        mid_y = (pA.y + pB.y) / 2.0
        if abs(pB.y - pA.y) < 1e-9:  # 水平弦
            return (None, mid_x, mid_y)  # 斜率无穷大，垂直线
        if abs(pB.x - pA.x) < 1e-9:  # 垂直弦
            k = 0  # 中垂线水平
        else:
            k_orig = (pB.y - pA.y) / (pB.x - pA.x)
            k = -1.0 / k_orig
        return (k, mid_x, mid_y)

    k1, mx1, my1 = perpendicular_bisector(pt1, pt2)
    k2, mx2, my2 = perpendicular_bisector(pt2, pt3)

    # 求解圆心 (cx, cy)
    if k1 is None:  # 第一条中垂线垂直
        cx = mx1
        cy = k2 * (cx - mx2) + my2
    elif k2 is None:  # 第二条中垂线垂直
        cx = mx2
        cy = k1 * (cx - mx1) + my1
    else:
        # 解线性方程: y = k1*(x - mx1) + my1, y = k2*(x - mx2) + my2
        cx = (k1 * mx1 - k2 * mx2 + my2 - my1) / (k1 - k2)
        cy = k1 * (cx - mx1) + my1

    center = APoint(cx, cy)
    radius = math.sqrt((pt1.x - cx)**2 + (pt1.y - cy)**2)

    # 计算角度（弧度）
    def point_angle(px, py):
        return math.atan2(py - cy, px - cx)

    start_angle = point_angle(pt1.x, pt1.y)
    end_angle = point_angle(pt3.x, pt3.y)

    # 确保角度范围，使圆弧从p1到p3经过p2
    mid_angle = point_angle(pt2.x, pt2.y)
    # 调整角度逻辑（简化版，可能需要根据情况调整）
    while end_angle < start_angle:
        end_angle += 2 * math.pi
    # 检查p2是否在角度区间内，否则可能需要交换起始角
    if not (start_angle <= mid_angle <= end_angle):
        # 一种处理方式：交换起始角和终止角，并让总角度为负（表示顺时针）
        start_angle, end_angle = end_angle, start_angle + 2 * math.pi
        # 或者重新定义圆弧方向

    # 创建圆弧
    # 注意：AutoCAD ActiveX中AddArc参数为 (圆心, 半径, 起始角, 终止角)，角度单位为弧度。
    arc = acad.model.AddArc(center, radius, start_angle, end_angle)
    return arc

# 使用示例
acad = Autocad(create_if_not_exists=True)
p_start = (0, 0)
p_mid = (5, 5)
p_end = (10, 0)
arc_obj = draw_arc_3_points(acad, p_start, p_mid, p_end)
print(f"圆弧创建成功，半径: {arc_obj.Radius}")

• 关键点 ：Python通过COM接口调用AutoCAD的ActiveX API。几何计算（如求圆心）需要自行实现或借助第三方库（如shapely）。AddArc方法直接接受圆心、半径和起止角。此方法更适用于脚本和自动化，而非大型应用程序。

应用场景与选择建议

• C# (.NET API)：适用于开发功能完整、需要复杂用户交互、稳定运行的商业插件或内部工具。是大多数专业开发者的首选。
• C++ (ObjectARX)：适用于开发对性能有严苛要求、需要深度集成或扩展AutoCAD核心功能的底层模块，如自定义实体、复杂算法内核。
• Python (pyautocad/COM)：非常适合进行设计自动化、批量图纸处理、快速测试算法或为不熟悉C#的工程师提供编程接口。在机械设计参数化、批量标注修改等场景中效率极高。
• 三点绘制法的其他变体：在CAD交互命令中，三点法常衍生为"起点-圆心-端点"、"起点-端点-角度"等多种方式，其底层实现均需转化为圆心、半径和角度的计算。

综上所述，选择哪种语言主要取决于项目需求、团队技能和性能要求。对于绝大多数二次开发任务，C#配合AutoCAD .NET API提供了最佳的生产力、功能性和社区支持平衡点 。无论选择哪种语言，准确计算三点确定的圆心、半径以及正确的起止角度是成功实现该功能的关键。

---

参考来源

• 【CAD】CAD入门知识
• Auto CAD二次开发------圆弧多段线
• CAD参数绘制圆弧
• cad绘制椭圆的方法有几种_【学员分享】cad椭圆弧的绘制方法
• C# CAD二次开发之基本图形
• 11种CAD绘制圆弧的方法