Curve.GetSplitCurves高效分割技巧

Curve.GetSplitCurves 方法是 AutoCAD .NET API 中用于分割曲线（包括多段线、直线、圆弧、样条曲线等）的核心方法。其功能远不止于单点分割，通过传入不同的参数集合，可以实现多种复杂的几何分割操作。以下是该方法的多种使用场景、参数详解及具体代码示例。

方法签名与参数详解

csharp 复制代码

public virtual DBObjectCollection GetSplitCurves(
    DoubleCollection parameters
)

parameters (DoubleCollection) ：一个包含曲线参数值的集合。曲线参数是一个将曲线长度映射到参数域的数值，对于大多数曲线（如 Line, Arc, Polyline），参数 0.0 对应起点，参数值等于曲线全长对应终点。
返回值 (DBObjectCollection)：一个包含分割后生成的所有新曲线段对象的集合。原曲线对象不会被自动修改或删除，需要开发者自行处理。

关键约束：

parameters 集合中的值必须严格按升序排序。
所有参数值必须在曲线的有效参数范围内（即 [StartParam, EndParam]）。
参数值不能等于曲线的起点或终点参数（即 0.0 或 Curve.EndParam），否则可能导致分割失败或返回空集合。
如果传入空集合或 null，方法通常返回一个包含原曲线副本的集合。

多种使用场景与代码示例

场景1：在单个指定点分割（基础应用）

这是最常见的用法，将一条曲线在某一特定点处一分为二。

csharp 复制代码

// 假设已有一个 Curve 对象 `curve` 和一个位于其上的点 `splitPoint3d`
double splitParam = curve.GetParameterAtPoint(splitPoint3d); // 获取点的参数
DoubleCollection splitParams = new DoubleCollection();
splitParams.Add(splitParam); // 添加单个参数

DBObjectCollection newCurves = curve.GetSplitCurves(splitParams);
// newCurves.Count 应为 2，包含分割后的两段曲线

场景2：在多个指定点分割

通过提供多个有序的分割点参数，可以将曲线一次性分割成多段。这在需要根据多个特征点（如交点、等分点）批量分割时非常高效。

csharp 复制代码

// 假设有多个位于曲线上的点 `splitPoints`，需要在这些点处分割
List<double> paramList = new List<double>();
foreach (Point3d pt in splitPoints)
{
    try
    {
        paramList.Add(curve.GetParameterAtPoint(pt));
    }
    catch { /* 处理点不在曲线上的情况 */ }
}

// 必须对参数进行升序排序
paramList.Sort();
DoubleCollection splitParams = new DoubleCollection(paramList);

DBObjectCollection newCurves = curve.GetSplitCurves(splitParams);
// newCurves.Count 应为 splitPoints.Count + 1

场景3：按等距离间隔分割

通过计算曲线长度并按固定距离生成分割参数，可以将曲线切分成等长的若干段（最后一段可能不等长）。

csharp 复制代码

double totalLength = curve.GetDistanceAtParameter(curve.EndParam);
double segmentLength = 10.0; // 每段目标长度
DoubleCollection splitParams = new DoubleCollection();

for (double dist = segmentLength; dist < totalLength - Tolerance.Global.EqualPoint; dist += segmentLength)
{
    // 将长度距离转换为曲线参数
    double param = curve.GetParameterAtDist(dist);
    splitParams.Add(param);
}

if (splitParams.Count > 0)
{
    DBObjectCollection newCurves = curve.GetSplitCurves(splitParams);
    // newCurves 包含了所有分割后的段
}

场景4：移除曲线中的某一段（"打孔"）

结合两次分割操作，可以实现移除曲线中间某一段的效果。首先在要移除段的起点和终点参数处分割，然后删除中间段对应的对象。

csharp 复制代码

// 假设要移除曲线从参数 startParam 到 endParam 的一段 (startParam < endParam)
DoubleCollection splitParams = new DoubleCollection();
splitParams.Add(startParam);
splitParams.Add(endParam);

DBObjectCollection allSegments = curve.GetSplitCurves(splitParams);
// 此时 allSegments 应包含3段: [0, startParam], [startParam, endParam], [endParam, End]
// 要移除中间段，只需将第0和第2段添加到数据库，忽略或删除第1段
Entity segmentToKeep1 = allSegments[0] as Entity;
Entity segmentToKeep2 = allSegments[2] as Entity;
Entity segmentToRemove = allSegments[1] as Entity;

// 将 segmentToKeep1 和 segmentToKeep2 添加到图形数据库...
// segmentToRemove 不添加，或调用其 Dispose() 方法

场景5：基于与其他曲线的交点进行分割

这是非常实用的场景，例如将一条多段线在所有与其他直线的交点处断开。

csharp 复制代码

// 假设有目标曲线 `targetCurve` 和一组可能与之相交的曲线 `intersectingCurves`
DoubleCollection intersectionParams = new DoubleCollection();

foreach (Curve otherCurve in intersectingCurves)
{
    Point3dCollection intersectionPoints = new Point3dCollection();
    // 计算交点
    targetCurve.IntersectWith(otherCurve, Intersect.OnBothOperands, intersectionPoints, IntPtr.Zero, IntPtr.Zero);

    foreach (Point3d ip in intersectionPoints)
    {
        // 排除起点和终点
        double param = targetCurve.GetParameterAtPoint(ip);
        double startParam = 0.0;
        double endParam = targetCurve.EndParam;
        if (param > startParam + Tolerance.Global.EqualPoint && param < endParam - Tolerance.Global.EqualPoint)
        {
            intersectionParams.Add(param);
        }
    }
}

// 排序并去重（容差范围内）
List<double> sortedParams = new List<double>(intersectionParams.Cast<double>().Distinct(new ToleranceComparer(1e-6)));
sortedParams.Sort();
DoubleCollection finalSplitParams = new DoubleCollection(sortedParams);

if (finalSplitParams.Count > 0)
{
    DBObjectCollection splitCurves = targetCurve.GetSplitCurves(finalSplitParams);
    // 现在 targetCurve 在所有交点处被分割
}

参数获取与几何计算的注意事项

场景	推荐方法	说明
已知曲线上的点	`Curve.GetParameterAtPoint(Point3d point)`	最直接的方法，但要求点必须精确位于曲线上（在数据库容差内）。否则会抛出异常。
已知大致位置的点	`Curve.GetClosestPointTo(Point3d point, bool extend, out Point3d closestPoint)`	更稳健的方法。先获取曲线上距离给定点最近的点`closestPoint`，再对`closestPoint`使用`GetParameterAtPoint`。通过判断`point`与`closestPoint`的距离是否在容差内，可以确定点是否"在"曲线上。
已知长度距离	`Curve.GetParameterAtDist(double distance)`	从曲线起点开始，沿曲线测量给定弧长距离，返回该处的参数值。适用于等距分割。
已知参数求点	`Curve.GetPointAtParameter(double param)`	`GetParameterAtPoint`的逆操作，根据参数值获取曲线上的点坐标。
已知参数求距离	`Curve.GetDistAtParameter(double param)`	获取从曲线起点到给定参数值处的弧长距离。

高级应用：处理样条曲线 (Spline) 和复杂曲线

对于样条曲线 (Spline)，其参数域可能不是简单的 [0, 全长]。Spline 有其自身的参数化方式（如通过节点向量）。虽然 GetSplitCurves 同样适用，但获取有意义的参数值可能需要不同的方法。

csharp 复制代码

Spline spline = ... // 获取一个样条曲线对象
Point3d splitPoint = ... // 分割点

// 对于 Spline，推荐使用 GetClosestPointTo 获取参数
double param;
Point3d closestPt;
param = spline.GetClosestPointTo(splitPoint, false, out closestPt);

// 也可以尝试 GetParameterAtPoint，但对精度要求极高
// double param = spline.GetParameterAtPoint(splitPoint);

DoubleCollection splineSplitParams = new DoubleCollection();
splineSplitParams.Add(param);
DBObjectCollection splitSplines = spline.GetSplitCurves(splineSplitParams);

事务管理与性能优化

事务边界 ：所有调用 GetSplitCurves 及后续的数据库操作（添加新实体、删除旧实体）都必须包裹在数据库事务 (Transaction) 中。
对象处理 ：GetSplitCurves 返回的新曲线对象是未被添加到数据库的"游离态"对象。必须将其显式添加到块表记录 (BlockTableRecord) 中，并使用 Transaction.AddNewlyCreatedDBObject 方法注册。
内存管理 ：DBObjectCollection 及其中的对象需要妥善管理。在使用完毕后，应考虑遍历集合并对不再需要的对象调用 Dispose()，或确保它们已被添加到数据库并由事务管理。
批量操作：对大量曲线进行分割时，应避免在循环内频繁提交事务。最佳实践是在单个事务内完成所有曲线的选择、分割和数据库更新操作。

通过灵活组合 GetSplitCurves 方法与不同的参数生成策略，可以满足从简单的单点截断到复杂的基于几何关系的批量分割等各种 CAD 二次开发需求。其核心在于正确理解曲线的参数化概念，并确保提供的分割参数集合是有效且有序的。

参考来源

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