CAD二次开发中多段线定点分割技巧

问题解构

用户的核心需求是在CAD二次开发环境中，将一条多段线（Polyline）在用户指定的某个点（Point）位置分割成两条独立的多段线。这涉及到以下几个关键技术步骤：

1. 点与多段线的几何关系判断：必须精确判断指定的点是否"位于"给定的多段线上，这需要考虑CAD的容差（Tolerance）系统。
2. 获取分割参数 ：找到该点在多段线参数空间中的位置（即参数值 param）。
3. 执行分割操作：利用CAD API提供的分割方法，根据参数值将原多段线分割为两部分。
4. 实体处理：正确处理原实体与新生实体的事务管理（如删除原线、添加新线等）。

方案推演与代码实现

在C#的CAD二次开发中（以AutoCAD/ObjectARX .NET API为例），Polyline 类继承自 Curve，而 Curve 类提供了用于分割的 GetSplitCurves 方法。以下是基于参考资料和的详细实现步骤。

1. 关键方法：Curve.GetSplitCurves

Curve.GetSplitCurves 方法是分割操作的核心。它接受一个 DoubleCollection 参数，该集合包含了在曲线参数区间内、用于指定分割点的一个或多个参数值。方法返回一个 DBObjectCollection，其中包含了分割后产生的所有新曲线段。

重要前提 ：传入的参数集合必须按升序排序，且值必须在曲线的有效参数范围内（通常对于多段线，起点为0.0，终点为多段线长度）。否则，操作将失败。

2. 完整分割流程与代码

以下代码封装了完整的判断与分割逻辑，关键步骤已添加详细注释。

using Autodesk.AutoCAD.ApplicationServices;
using Autodesk.AutoCAD.DatabaseServices;
using Autodesk.AutoCAD.EditorInput;
using Autodesk.AutoCAD.Geometry;
using Autodesk.AutoCAD.Runtime;
using System;
using System.Collections.Generic;

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

        using (Transaction tr = db.TransactionManager.StartTransaction())
        {
            try
            {
                // 步骤1：用户交互，选择一条多段线
                PromptEntityOptions peo = new PromptEntityOptions("
请选择要分割的多段线: ");
                peo.SetRejectMessage("
请选择一条多段线(轻量多段线或二维多段线)。");
                peo.AddAllowedClass(typeof(Polyline), false);
                PromptEntityResult per = ed.GetEntity(peo);
                if (per.Status != PromptStatus.OK) return;

                // 步骤2：用户交互，指定一个分割点
                PromptPointOptions ppo = new PromptPointOptions("
指定分割点: ");
                PromptPointResult ppr = ed.GetPoint(ppo);
                if (ppr.Status != PromptStatus.OK) return;
                Point3d splitPoint = ppr.Value;

                // 步骤3：获取选中的多段线对象
                Polyline sourcePline = tr.GetObject(per.ObjectId, OpenMode.ForWrite) as Polyline;
                if (sourcePline == null) return;

                // 步骤4：判断点是否在多段线上，并获取参数值
                double param;
                bool isOnCurve = IsPointOnPolyline(sourcePline, splitPoint, out param);
                if (!isOnCurve)
                {
                    ed.WriteMessage("
错误：指定的点不在选定的多段线上。");
                    return;
                }

                // 步骤5：准备分割参数集合
                DoubleCollection splitParams = new DoubleCollection();
                splitParams.Add(param); // 在参数点处分割

                // 步骤6：执行分割操作
                DBObjectCollection newSegments = sourcePline.GetSplitCurves(splitParams);
                if (newSegments == null || newSegments.Count == 0)
                {
                    ed.WriteMessage("
分割失败。");
                    return;
                }

                // 步骤7：处理分割后的实体
                // 获取当前块表记录（模型空间）
                BlockTableRecord btr = (BlockTableRecord)tr.GetObject(db.CurrentSpaceId, OpenMode.ForWrite);

                // 添加分割产生的两段新多段线到数据库
                foreach (DBObject obj in newSegments)
                {
                    Entity newEnt = obj as Entity;
                    if (newEnt != null)
                    {
                        btr.AppendEntity(newEnt);
                        tr.AddNewlyCreatedDBObject(newEnt, true);
                    }
                }

                // 步骤8：删除原始的多段线
                sourcePline.Erase();

                tr.Commit();
                ed.WriteMessage($"
成功将多段线在参数 {param:F4} 处分割为 {newSegments.Count} 段。");
            }
            catch (System.Exception ex)
            {
                ed.WriteMessage($"
操作发生错误: {ex.Message}");
                tr.Abort();
            }
        }
    }

    /// <summary>
    /// 判断点是否在多段线上，并返回该点处的参数值。
    /// </summary>
    /// <param name="pline">目标多段线</param>
    /// <param name="point">待判断的点</param>
    /// <param name="param">输出参数值</param>
    /// <returns>true 如果点在多段线上（在容差范围内）</returns>
    private bool IsPointOnPolyline(Polyline pline, Point3d point, out double param)
    {
        param = 0.0;
        // 使用全局图形数据库容差进行比较
        Tolerance tolerance = Tolerance.Global;

        // 方法A：使用 GetClosestPointTo 获取最近点及其参数
        // 这是最稳健的方法，通过计算曲线上距离给定点最近的点来判断
        Point3d closestPoint;
        param = pline.GetClosestPointTo(point, false, out closestPoint); // false 表示不延伸曲线

        // 判断最近点与给定点的距离是否在容差内
        double distance = closestPoint.DistanceTo(point);
        if (distance <= tolerance.EqualPoint)
        {
            return true;
        }

        // 方法B（备选）：对于简单场景，可尝试GetParameterAtPoint，但此方法要求点必须精确在曲线上
        // try
        // {
        //     param = pline.GetParameterAtPoint(point);
        //     return true;
        // }
        // catch { }

        return false;
    }
}

核心要点与注意事项

要点	说明
容差处理	CAD中的点坐标是浮点数，直接进行 == 比较不可靠。必须使用 Tolerance.Global 或自定义容差（如 `
1e-6或
1e-9）来判断点与线的重合关系。代码中使用 GetClosestPointTo` 并计算距离是推荐做法。
参数排序	GetSplitCurves 方法要求 DoubleCollection 中的参数必须严格升序排列。虽然本例只有一个分割点，但在多点分割时，必须先对参数集合进行排序。
事务管理	所有对图形数据库的修改（如添加新实体、删除旧实体）都必须在事务 (Transaction) 内进行，并使用 tr.Commit() 提交更改，异常时使用 tr.Abort() 回滚。
实体类型	此代码主要针对 Polyline（轻量多段线）。对于 Polyline2d（二维多段线）或 Polyline3d（三维多段线），其类和方法可能略有不同，需注意区分。
分割点位置	分割点不能是多段线的起点或终点，否则 GetSplitCurves 可能返回空集或无效结果。在实际应用中应增加对此情况的检查。
性能考虑	对于非常复杂的多段线（如数千个顶点），频繁的几何计算（如 GetClosestPointTo）可能影响性能。在批量处理时需进行优化。

应用场景示例

• 道路设计：在道路中心线（多段线）与规划红线交点处将其分段，便于分段计算土方或标注里程。
• 管线系统：在管线上指定阀门或接头的位置，将管线分割，以便为不同管段分配独立的属性或进行水力计算。
• 边界调整：在行政区划或地块边界线上，根据新的界址点分割原有边界，生成新的独立边界对象。

通过上述方法，可以精准、可靠地在CAD二次开发中实现多段线的指定点分割功能。此方法的核心思想也适用于其他类型的 Curve 对象，如直线 (Line)、圆弧 (Arc) 等，因为它们共享 GetSplitCurves 这一基础方法。

---

参考来源

• （C#.net）CAD二次开发 polyline多段线/line直线/曲线 break打断的方法
• 点在线上判定与多段线分割
• 在 CAD C# 二次开发中，Clipper2、CGAL 和 NTS（NetTopologySuite）对比
• gstarcad 2021|gstarcad pro2021（浩辰CAD） 64位附安装教程
• CAD标准图框模块设计与应用实战
• CAD钻孔布置与坐标标注插件完整工具包