CAD二次开发中DoubleCollection用法详解

在 AutoCAD .NET API 中，DoubleCollection 是一个用于存储双精度浮点数集合的类，常用于定义多段线（Polyline）的顶点坐标或样条曲线的拟合点等。

核心用法

DoubleCollection 通常作为参数传递给需要一系列连续数值的构造函数或方法。其核心用法是按顺序存储坐标值 ，例如 (x1, y1, z1, x2, y2, z2, ...)。

创建与填充 DoubleCollection

你可以通过多种方式创建并填充一个 DoubleCollection 对象。

csharp 复制代码

// 方法一：使用构造函数并逐个添加
DoubleCollection vertices1 = new DoubleCollection();
vertices1.Add(0.0);  // X1
vertices1.Add(0.0);  // Y1
vertices1.Add(0.0);  // Z1
vertices1.Add(100.0); // X2
vertices1.Add(100.0); // Y2
vertices1.Add(0.0);   // Z2

// 方法二：使用集合初始化器（更简洁）
DoubleCollection vertices2 = new DoubleCollection
{
    0.0, 0.0, 0.0, // 顶点1 (X, Y, Z)
    100.0, 0.0, 0.0, // 顶点2    100.0, 100.0, 0.0, // 顶点3
    0.0, 100.0, 0.0   // 顶点4
};

典型应用：创建三维多段线 (Polyline3d)

这是 DoubleCollection 最经典的应用场景之一，用于传递多段线所有顶点的三维坐标。

csharp 复制代码

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

public class DoubleCollectionExample
{
    [CommandMethod("CreatePoly3d")]
    public void CreatePoly3d()
    {
        Document doc = Application.DocumentManager.MdiActiveDocument;
        Database db = doc.Database;

        using (Transaction tr = db.TransactionManager.StartTransaction())
        {
            // 打开块表记录（模型空间）以写入实体 BlockTable bt = (BlockTable)tr.GetObject(db.BlockTableId, OpenMode.ForRead);
            BlockTableRecord btr = (BlockTableRecord)tr.GetObject(bt[BlockTableRecord.ModelSpace], OpenMode.ForWrite);

            // 1. 定义多段线的顶点坐标集合 DoubleCollection vertices = new DoubleCollection
            {
 // 顶点1                0, 0, 0,
                // 顶点2
                200, 0, 50,
                // 顶点3200, 150, 100,
                // 顶点4
                0, 150, 0 };

            // 2. 创建三维多段线对象
            Polyline3d poly3d = new Polyline3d(Poly3dType.SimplePoly, vertices, false);

            // 3. 将实体添加到模型空间并提交事务
            btr.AppendEntity(poly3d);
            tr.AddNewlyCreatedDBObject(poly3d, true);

            tr.Commit();
        }
    }
}

与其他几何类型的转换

有时需要将 Point3dCollection 等更结构化的数据转换为 DoubleCollection。

csharp 复制代码

// 假设有一个 Point3dCollectionPoint3dCollection points = new Point3dCollection
{
    new Point3d(10, 20, 0),
    new Point3d(50, 60, 10),
    new Point3d(100, 30, 20)
};

// 转换为 DoubleCollection
DoubleCollection coordCollection = new DoubleCollection();
foreach (Point3d pt in points)
{
    coordCollection.Add(pt.X);
    coordCollection.Add(pt.Y);
    coordCollection.Add(pt.Z);
}
// 此时 coordCollection 包含:10, 20, 0, 50, 60, 10, 100, 30, 20

关键注意事项

事项	说明
数据顺序	必须严格按照 `X, Y, Z, X, Y, Z...` 的顺序添加坐标值，否则图形会错乱。
元素数量	`DoubleCollection` 中元素的总数必须是 3 的倍数（对于三维坐标），因为每个顶点由三个 `double` 值 (X, Y, Z) 构成。
性能考量	对于大量顶点，建议在创建集合时预估大小，或使用更高效的填充方式（如数组转换），以减少内存重新分配。
应用场景	主要用于 `Polyline3d`、某些 `Spline` 拟合数据的构造，以及需要传递原始双精度数组的低层级 API。

总结

DoubleCollection 在 AutoCAD 二次开发中是一个基础的、用于顺序存储双精度数值的数据容器，尤其在构造基于顶点序列的图形对象（如三维多段线）时不可或缺。使用时需严格保证坐标数据的顺序和数量正确。

参考来源

AutoCAD二次开发基础