在 AutoCAD .NET API 中，DoubleCollection是一个用于存储双精度浮点数集合的类，常用于定义多段线（Polyline）的顶点坐标或样条曲线的拟合点等。
核心用法
DoubleCollection通常作为参数传递给需要一系列连续数值的构造函数或方法。其核心用法是按顺序存储坐标值，例如(x1, y1, z1, x2, y2, z2, ...)。
1. 创建与填充 DoubleCollection
你可以通过多种方式创建并填充一个DoubleCollection对象。
// 方法一：使用构造函数并逐个添加 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 };2. 典型应用：创建三维多段线 (Polyline3d)
这是DoubleCollection最经典的应用场景之一，用于传递多段线所有顶点的三维坐标。
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(); } } }3. 与其他几何类型的转换
有时需要将Point3dCollection等更结构化的数据转换为DoubleCollection。
// 假设有一个 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二次开发基础
